Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 142 lines (90 sloc) 4.691 kb
0511437 @mcdonc not BFG no mo
mcdonc authored
1 Pyramid TODOs
2 =============
69364d6 @tseaver Tidying
tseaver authored
3
8ac9e61 @mcdonc garden
mcdonc authored
4 Nice-to-Have
5 ------------
8b6f09d @mcdonc add rudimentary object description code
mcdonc authored
6
63c969d @mcdonc garden
mcdonc authored
7 - Add docs about upgrading between Pyramid versions (e.g. how to see
8 deprecation warnings).
9
4786cae @mcdonc - The system value ``r`` is now supplied to renderers as an alias for
mcdonc authored
10 - Fix renderers chapter to better document system values passed to template
11 renderers.
12
37f3baa @mcdonc garden
mcdonc authored
13 - Modify view mapper narrative docs to not use pyramid_handlers.
14
cd422c1 @mcdonc garden
mcdonc authored
15 - Modify the urldispatch chapter examples to assume a scan rather than
16 ``add_view``.
17
56a1008 @mcdonc garden
mcdonc authored
18 - Context manager for creating a new configurator (replacing
19 ``with_package``). E.g.::
20
21 with config.partial(package='bar') as c:
22 c.add_view(...)
23
8fc93b9 @mcdonc garden
mcdonc authored
24 or::
25
26 with config.partial(introspection=False) as c:
27 c.add_view(..)
28
8ac9e61 @mcdonc garden
mcdonc authored
29 - Introspection:
57a0d77 @mcdonc docs; todo; coverage for Introspector
mcdonc authored
30
63c969d @mcdonc garden
mcdonc authored
31 * ``default root factory`` category (prevent folks from needing to searh
32 "root factories" category)?
58c01ff @mcdonc flesh out categories more
mcdonc authored
33
63c969d @mcdonc garden
mcdonc authored
34 * ``default view mapper`` category (prevent folks from needing to search
35 "view mappers" category)?
58c01ff @mcdonc flesh out categories more
mcdonc authored
36
4a4ef4f @mcdonc simplify actioninfo interface; fix actioninfos passed as tuple via _info
mcdonc authored
37 * get rid of "tweens" category (can't sort properly?)
38
bfc01f5 @mcdonc garden
mcdonc authored
39 - Fix deployment recipes in cookbook (discourage proxying without changing
40 server).
41
773024b @mcdonc garden
mcdonc authored
42 - Try "with transaction.manager" in an exception view with SQLA (preempt
43 homina homina response about how to write "to the database" from within in
63c969d @mcdonc garden
mcdonc authored
44 an exception view). Note: tried this and couldn't formulate the right
45 situation where the database could not be written to within an exception
46 view (but didn't try exhaustively).
773024b @mcdonc garden
mcdonc authored
47
95eab98 @mcdonc organize better
mcdonc authored
48 - Add narrative docs for wsgiapp and wsgiapp2.
3d338ea @mcdonc - Use [app:main] instead of a pipeline in all scaffolds and tutorials
mcdonc authored
49
95eab98 @mcdonc organize better
mcdonc authored
50 - Flesh out "Paste" narrative docs chapter.
51add88 @mcdonc garden
mcdonc authored
51
95eab98 @mcdonc organize better
mcdonc authored
52 - Basic WSGI documentation (pipeline / app / server).
51add88 @mcdonc garden
mcdonc authored
53
63c969d @mcdonc garden
mcdonc authored
54 - Change docs about creating a venusian decorator to not use ZCA (use
55 configurator methods instead).
d8d14a4 @mcdonc garden
mcdonc authored
56
95eab98 @mcdonc organize better
mcdonc authored
57 - Try to better explain the relationship between a renderer and a template in
58 the templates chapter and elsewhere. Scan the documentation for reference
59 to a renderer as *only* view configuration (it's a larger concept now).
b5ffe38 @mcdonc - The ``settings`` dictionary now raises a deprecation warning when you
mcdonc authored
60
a7d50d8 @mcdonc garden
mcdonc authored
61 - Add better docs about what-to-do-when-behind-a-proxy: paste.urlmap ("/foo =
62 app1" and "domain app1.localhost = app1"), ProxyPreserveHost and the nginx
63 equivalent, preserving HTTPS URLs.
64
95eab98 @mcdonc organize better
mcdonc authored
65 - _fix_registry should dictify the registry being fixed.
6aafc53 @mcdonc garden
mcdonc authored
66
95eab98 @mcdonc organize better
mcdonc authored
67 - Make "localizer" a property of request (instead of requiring
68 "get_localizer(request)"?
6aafc53 @mcdonc garden
mcdonc authored
69
95eab98 @mcdonc organize better
mcdonc authored
70 - Alias the stupid long default session factory name.
d1432f4 @mcdonc - Reconcile "extending an existing application" chapter with existenc…
mcdonc authored
71
95eab98 @mcdonc organize better
mcdonc authored
72 - Debug option to print view matching decision (e.g. debug_viewlookup or so).
94a5271 @mcdonc gardening, add twophase todo
mcdonc authored
73
f765a6d @mcdonc reprioritize
mcdonc authored
74 - Non-bwcompat use of threadlocals that need to be documented or ameliorated:
75
76 security.principals_allowed_by_permission
77
78 resource.OverrideProvider._get_overrides: can't credibly be removed,
79 because it stores an overrideprovider as a module-scope global.
80
81 traversal.traverse: this API is a stepchild, and needs to be changed.
82
83 Configurator.add_translation_dirs: not passed any context but a message,
84 can't credibly be removed.
85
95eab98 @mcdonc organize better
mcdonc authored
86 - Deprecate pyramid.security.view_execution_permitted (it only works for
87 traversal).
f077653 - A ``repoze.bfg.events.subscriber`` decorator was added. This
Chris McDonough authored
88
89 - Create a function which performs a recursive request.
90
95eab98 @mcdonc organize better
mcdonc authored
91 - Create a ``render_view`` that works by using config.derive_view against an
92 existing view callable instead of querying the registry (some sort of API
93 for rendering a view callable object to a response from within another view
94 callable). Possible idea: have config.add_view mark up the
95 function/method/class like @view_config does, then use the attached info to
96 derive a view callable whenever called via some API.
7c15496 @mcdonc remove; too complex to document here
mcdonc authored
97
98 - Provide a ``has_view`` function.
99
485ef69 @mcdonc gardening
mcdonc authored
100 - Update App engine chapter with less creaky directions.
5efc45b @mcdonc add notes about shedding threadlocals
mcdonc authored
101
cccc918 @mcdonc garden
mcdonc authored
102 Future
103 ------
104
f1f6e87 @mcdonc garden
mcdonc authored
105 - 1.4: Kill off ``bfg.routes`` envvars in router.
cccc918 @mcdonc garden
mcdonc authored
106
33516a0 @mcdonc - Undeprecated ``pyramid.traversal.find_model``,
mcdonc authored
107 - 1.4: Remove ``chameleon_text`` / ``chameleon_zpt`` deprecated functions
108 (render_*)
109
110 - 1.4: Remove ``pyramid.configuration.ConfigurationError`` (deprecated).
111
112 - 1.4: Remove ``pyramid.paster.PyramidTemplate`` (deprecated).
113
114 - 1.4: Remove ``pyramid.settings.get_settings`` (deprecated).
115
116 - 1.5: Remove all deprecated ``pyramid.testing`` functions.
6413015 @mcdonc garden
mcdonc authored
117
2a96825 @mcdonc garden
mcdonc authored
118 - 1.5: turn ``pyramid.settings.Settings`` into a function that returns the
119 original dict (after ``__getattr__`` deprecation period, it was deprecated
120 in 1.2).
121
122 - 1.5: Remove ``pyramid.requests.DeprecatedRequestMethodsMixin``.
123
63c969d @mcdonc garden
mcdonc authored
124 - 1.6: Remove IContextURL and TraversalContextURL.
125
d8d14a4 @mcdonc garden
mcdonc authored
126 Probably Bad Ideas
127 ------------------
128
485ef69 @mcdonc gardening
mcdonc authored
129 - Add functionality that mocks the behavior of ``repoze.browserid``.
76d7eb6 @mcdonc - Internal: ZCML directives no longer call get_current_registry() if …
mcdonc authored
130
5f3fc07 @mcdonc garden
mcdonc authored
131 - Consider implementing the API outlined in
132 http://plope.com/pyramid_auth_design_api_postmortem, phasing out the
133 current auth-n-auth abstractions in a backwards compatible way.
134
d8d14a4 @mcdonc garden
mcdonc authored
135 - Maybe add ``add_renderer_globals`` method to Configurator.
136
95eab98 @mcdonc organize better
mcdonc authored
137 - Supply ``X-Vhm-Host`` support (probably better to do what paste#prefix
138 middleware does).
139
c5724cb @mcdonc garden
mcdonc authored
140 - Have ``remember`` and ``forget`` actually set headers on the response using
141 a response callback (and return the empty list)?
Something went wrong with that request. Please try again.