Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 132 lines (87 sloc) 4.536 kB
0511437 @mcdonc not BFG no mo
mcdonc authored
1 Pyramid TODOs
2 =============
69364d6 @tseaver Tidying
tseaver authored
3
485ef69 @mcdonc gardening
mcdonc authored
4 Must-Have (before 1.0)
5 ----------------------
6
7 - Add a ``handler`` ZCML directive. This implies some slightly dicey
8 refactoring of the configurator to allow it to generate ZCML
94a5271 @mcdonc gardening, add twophase todo
mcdonc authored
9 "discriminators" for views and routes, that could be implemented in terms
10 of "twophase configuration" in "should have" below.
485ef69 @mcdonc gardening
mcdonc authored
11
12 - Provide a .flash API on session object.
13
14 - Make default renderer work (renderer registered with no name, which is
15 active for every view unless the view names a specific renderer).
16
17 - Use ``@register_view`` instead of ``@view_config`` and change view docs to
18 use "view registration" instead of "view configuration".
19
20 - SQLAlchemy idiomatics:
21
22 <RaFromBRC> mcdonc: those paster templates all look pretty good... the
23 only thing i'd consider is adjusting your config variable names to match
24 exactly what sqlalchemy uses as parameter names, see here:
25 http://www.sqlalchemy.org/docs/core/engines.html
26
27 <RaFromBRC> mcdonc: especially in the pylons_sqla ini file, where the db
28 initialization is mixed in w/ the app config...
29
30 <RaFromBRC> ... i'd use "sqlalchemy.PARAMETER" for all of the sqla
31 settings, so it could easily be handed to engine_from_config w/o any need
32 to parse by hand
33
34 <RaFromBRC> mcdonc: in the other ini files, where sqlalchemy is given its
35 own part, the "sqlalchemy." prefix probably isn't necessary, but matching
36 the parameter names (e.g. 'url' instead of 'db_string') is still probably
37 a good idea
38
39 - Better ``config.add_handler`` documentation.
40
41 Should-Have
42 -----------
43
165020a @mcdonc gardening
mcdonc authored
44 - Add docs for httpexceptions module for each webob.exc class that inherits
45 from WSGIHTTPException.
46
485ef69 @mcdonc gardening
mcdonc authored
47 - Create a ``docs`` directory for each paster template.
48
49 - Remove "BFG" from Pyramid-specific environ variables.
50
51 - translationdir ZCML directive use of ``path_spec`` should maybe die.
52
53 - Add CRSF token creation/checking machinery (only "should have" vs. "must
54 have" because I'm not sure it belongs in Pyramid.. it definitely must exist
55 in formgen libraries, and *might* belong in Pyramid).
56
57 - Change "Cleaning up After a Request" in the urldispatch chapter to
58 use ``request.add_response_callback``.
59
94a5271 @mcdonc gardening, add twophase todo
mcdonc authored
60 - Twophase configuration (config = Configurator(autocommit=False))
61
485ef69 @mcdonc gardening
mcdonc authored
62 Nice-to-Have
63 ------------
64
94a5271 @mcdonc gardening, add twophase todo
mcdonc authored
65 - Try to make test suite pass on IronPython.
66
f765a6d @mcdonc reprioritize
mcdonc authored
67 - Non-bwcompat use of threadlocals that need to be documented or ameliorated:
68
69 security.principals_allowed_by_permission
70
71 resource.OverrideProvider._get_overrides: can't credibly be removed,
72 because it stores an overrideprovider as a module-scope global.
73
74 traversal.traverse: this API is a stepchild, and needs to be changed.
75
76 Configurator.add_translation_dirs: not passed any context but a message,
77 can't credibly be removed.
78
69364d6 @tseaver Tidying
tseaver authored
79 - Supply ``X-Vhm-Host`` support.
6fd5e12 Review.
Chris McDonough authored
80
9ec2d64 Merge of andrew-docs branch.
Chris McDonough authored
81 - Basic WSGI documentation (pipeline / app / server).
ff1213e Add "exception views" work contributed primarily by Andrey Popp by me…
Chris McDonough authored
82
0b32608
Chris McDonough authored
83 - Fix message catalog extraction / compilation documentation.
84
84c5ec6 lingering todo items
Chris McDonough authored
85 - Change docs about creating a venusian decorator to not use ZCA.
86
a91594a todo gardening
Chris McDonough authored
87 - ``decorator=`` parameter to bfg_view.
88
250c021 merge generic_rendering branch
Chris McDonough authored
89 - Try to better explain the relationship between a renderer and a
90 template in the templates chapter and elsewhere. Scan the
91 documentation for reference to a renderer as *only* view
92 configuration (it's a larger concept now).
388f9d4 renderer overhaul intentions
Chris McDonough authored
93
f077653 - A ``repoze.bfg.events.subscriber`` decorator was added. This
Chris McDonough authored
94 - Create a ``render_view`` that works by using config.derive_view
95 against an existing view instead of querying the registry.
96
97 - Create a function which performs a recursive request.
98
baa6347 todo gardening
Chris McDonough authored
99 - Debug option to print route matching decision.
100
101 - Debug option to print view matching decision.
303c163 todo gardening
Chris McDonough authored
102
3454745 todo gardening
Chris McDonough authored
103 - Script or paster command that prints, for a given URL, the views
104 that might match. Underneath each potentially matching route, list
105 the predicates required. Underneath each route+predicate set, print
106 each view that might match and its predicates. E.g. with the input
107 URL ``/foo``::
108
109 '/foo' (foo_xhr)
110 xhr = True
111 (no view predicates)
112 mypackage.views.MyXHRFooView.__call__
113
114 '/{action}' (action_route)
115 request_method = 'POST'
116 action = '^foo$'
117 mypackage.views.MyView.foo_POST
118 request_method = 'GET'
119 action = '^foo$'
120 mypackage.views.MyView.foo_GET
121
5951ab4 todo gardening.
Chris McDonough authored
122 - Provide a response_cookies attribute on the request for rendered
123 responses that can be used as input to response.set_cookie.
124
6d91915 todo gardening
Chris McDonough authored
125 - Raise an exception when a value in response_headerlist is not a
126 string or decide to encode.
127
485ef69 @mcdonc gardening
mcdonc authored
128 - Update App engine chapter with less creaky directions.
5efc45b @mcdonc add notes about shedding threadlocals
mcdonc authored
129
485ef69 @mcdonc gardening
mcdonc authored
130 - Add functionality that mocks the behavior of ``repoze.browserid``.
76d7eb6 @mcdonc - Internal: ZCML directives no longer call get_current_registry() if …
mcdonc authored
131
Something went wrong with that request. Please try again.