Chris McDonough
2011-09-04 90737d6b24775cab3a3816b426c0dc65c03fe43d
commit | author | age
051143 1 Pyramid TODOs
CM 2 =============
69364d 3
b5ffe3 4 Nice-to-Have
CM 5 ------------
7f8896 6
49f082 7 - Consider adding exclog to all scaffolds to print tracebacks to the console
CM 8   while the debug toolbar is enabled.
512e33 9
95eab9 10 - Add narrative docs for wsgiapp and wsgiapp2.
CM 11
12 - Better "Extending" chapter.
13
14 - Flesh out "Paste" narrative docs chapter.
15
16 - Basic WSGI documentation (pipeline / app / server).
17
18 - Change docs about creating a venusian decorator to not use ZCA.
19
20 - Try to better explain the relationship between a renderer and a template in
21   the templates chapter and elsewhere.  Scan the documentation for reference
22   to a renderer as *only* view configuration (it's a larger concept now).
3d338e 23
a7d50d 24 - Add better docs about what-to-do-when-behind-a-proxy: paste.urlmap ("/foo =
CM 25   app1" and "domain app1.localhost = app1"), ProxyPreserveHost and the nginx
26   equivalent, preserving HTTPS URLs.
27
449287 28 - _fix_registry should dictify the registry being fixed.
CM 29
51add8 30 - Make "localizer" a property of request (instead of requiring
CM 31   "get_localizer(request)"?
32
b5ffe3 33 - Alias the stupid long default session factory name.
371a67 34
6aafc5 35 - Debug option to print view matching decision (e.g. debug_viewlookup or so).
94a527 36
f765a6 37 - Non-bwcompat use of threadlocals that need to be documented or ameliorated:
CM 38
39   security.principals_allowed_by_permission
40
41   resource.OverrideProvider._get_overrides: can't credibly be removed,
42   because it stores an overrideprovider as a module-scope global.
43
44   traversal.traverse: this API is a stepchild, and needs to be changed.
45
46   Configurator.add_translation_dirs: not passed any context but a message,
47   can't credibly be removed.
48
95eab9 49 - Deprecate pyramid.security.view_execution_permitted (it only works for
CM 50   traversal).
f07765 51
CM 52 - Create a function which performs a recursive request.
53
95eab9 54 - Create a ``render_view`` that works by using config.derive_view against an
CM 55   existing view callable instead of querying the registry (some sort of API
56   for rendering a view callable object to a response from within another view
57   callable). Possible idea: have config.add_view mark up the
58   function/method/class like @view_config does, then use the attached info to
59   derive a view callable whenever called via some API.
7c1549 60
CM 61 - Provide a ``has_view`` function.
62
485ef6 63 - Update App engine chapter with less creaky directions.
95eab9 64
CM 65 - Introspection features (whatever is needed by Alan/ptah).
d8d14a 66
cccc91 67 Future
CM 68 ------
69
70 - 1.5: turn ``pyramid.settings.Settings`` into a function that returns the
71   original dict (after ``__getattr__`` deprecation period, it was deprecated
72   in 1.2).
73
74 - 1.3: Kill off ``bfg.routes`` envvars in router.
75
95eab9 76 - 1.3/1.4: - Eliminate non-deployment-non-scaffold-related Paste dependencies:
CM 77   ``paste.urlparser.StaticURLParser``, ``paste.auth.auth_tkt`` (cutnpaste or
78   reimplement both).
78e4cd 79
49f082 80 - 1.3/1.4: use zope.registry rather than zope.component.
78e4cd 81
7c1549 82 - 1.3/1.4: get rid of zope.configuration dependency.  This will also speed up
CM 83   startup time (defer _bootstrap and registerCommonDirectives() until needed).
49f082 84
CM 85 - 1.3: Michael's route group work
86
87 - 1.3: Add a default-view-config-params decorator that can be applied to a
88   class which names defaults for method-based view_config decorator options.
89
33516a 90 - 1.4: Remove ``chameleon_text`` / ``chameleon_zpt`` deprecated functions
CM 91   (render_*)
92
93 - 1.4: Remove ``pyramid.configuration.ConfigurationError`` (deprecated).
94
95 - 1.4: Remove ``pyramid.paster.PyramidTemplate`` (deprecated).
96
97 - 1.3: Remove ``pyramid.renderers.renderer_from_name`` (deprecated).
98
99 - 1.5: Remove ``pyramid.requests.DeprecatedRequestMethodsMixin``.
100
101 - 1.4: Remove ``pyramid.settings.get_settings`` (deprecated).
102
103 - 1.5: Remove all deprecated ``pyramid.testing`` functions.
641301 104
d8d14a 105 Probably Bad Ideas
CM 106 ------------------
d89aee 107
485ef6 108 - Add functionality that mocks the behavior of ``repoze.browserid``.
c8e78c 109
5f3fc0 110 - Consider implementing the API outlined in
CM 111   http://plope.com/pyramid_auth_design_api_postmortem, phasing out the
112   current auth-n-auth abstractions in a backwards compatible way.
9d3bd8 113
d8d14a 114 - Maybe add ``add_renderer_globals`` method to Configurator.
CM 115
95eab9 116 - Supply ``X-Vhm-Host`` support (probably better to do what paste#prefix
CM 117   middleware does).
118