Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

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