Merge https://github.com/Pylons/pyramid

1 files changed, 79 insertions, 85 deletions

diff --git a/TODO.txt b/TODO.txt
index 66fc6c0ff..f12dcee73 100644
--- a/TODO.txt
+++ b/TODO.txt
@@ -1,5 +1,80 @@
-:mod:`repoze.bfg` TODOs
-=======================
+Pyramid TODOs
+=============
+
+Must-Have (before 1.0)
+----------------------
+
+- Test on GAE, Jython, PyPy, IronPython.
+
+- Add docs for httpexceptions module for each webob.exc class that inherits
+  from WSGIHTTPException.
+
+- Add a ``handler`` ZCML directive.  This implies some slightly dicey
+  refactoring of the configurator to allow it to generate ZCML
+  "discriminators" for views and routes.
+
+- Provide a .flash API on session object.
+
+- Make default renderer work (renderer registered with no name, which is
+  active for every view unless the view names a specific renderer).
+
+- Use ``@register_view`` instead of ``@view_config`` and change view docs to
+  use "view registration" instead of "view configuration".
+
+- Remove calls to config.begin()/config.end() from startup config code in
+  tutorials and paster templates (no longer required).
+
+- SQLAlchemy idiomatics:
+
+   <RaFromBRC> mcdonc: those paster templates all look pretty good... the
+   only thing i'd consider is adjusting your config variable names to match
+   exactly what sqlalchemy uses as parameter names, see here:
+   http://www.sqlalchemy.org/docs/core/engines.html
+
+   <RaFromBRC> mcdonc: especially in the pylons_sqla ini file, where the db
+   initialization is mixed in w/ the app config...
+
+   <RaFromBRC> ... i'd use "sqlalchemy.PARAMETER" for all of the sqla
+   settings, so it could easily be handed to engine_from_config w/o any need
+   to parse by hand
+
+   <RaFromBRC> mcdonc: in the other ini files, where sqlalchemy is given its
+   own part, the "sqlalchemy." prefix probably isn't necessary, but matching
+   the parameter names (e.g. 'url' instead of 'db_string') is still probably
+   a good idea
+
+- Non-bwcompat use of threadlocals that need to be documented or ameliorated:
+
+  security.principals_allowed_by_permission
+
+  resource.OverrideProvider._get_overrides: can't credibly be removed,
+  because it stores an overrideprovider as a module-scope global.
+
+  traversal.traverse: this API is a stepchild, and needs to be changed.
+
+  Configurator.add_translation_dirs: not passed any context but a message,
+  can't credibly be removed.
+
+- Better ``config.add_handler`` documentation.
+
+Should-Have
+-----------
+
+- Create a ``docs`` directory for each paster template.
+
+- Remove "BFG" from Pyramid-specific environ variables.
+
+- translationdir ZCML directive use of ``path_spec`` should maybe die.
+
+- Add CRSF token creation/checking machinery (only "should have" vs. "must
+  have" because I'm not sure it belongs in Pyramid.. it definitely must exist
+  in formgen libraries, and *might* belong in Pyramid).
+
+- Change "Cleaning up After a Request" in the urldispatch chapter to
+  use ``request.add_response_callback``.
+
+Nice-to-Have
+------------
 
 - Supply ``X-Vhm-Host`` support.
 
@@ -44,94 +119,13 @@
          action = '^foo$'
            mypackage.views.MyView.foo_GET
 
-- Ability to use configurator as a context manager.
-
 - Provide a response_cookies attribute on the request for rendered
   responses that can be used as input to response.set_cookie.
 
 - Raise an exception when a value in response_headerlist is not a
   string or decide to encode.
 
-- Change "Cleaning up After a Request" in the urldispatch chapter to
-  use ``request.add_response_callback``.
-
-- Update App engine chapter.
-
-- Browser id?
-
-- .flash API on session.
-
-- CRSF token machinery
-
-- ``add_handler`` documentation.
-
-- ``handler`` ZCML directive.
-
-- ``docs`` directory for each paster template.
-
-- "BFG" in environ variables.
-
-- Test on GAE, Jython, PyPy, IronPython.
-
-- Add docs for httpexceptions.
-
-- RendererHelper -> RendererInfo?
-
-- Do something about ZODB session chapter: either remove or create a
-  pyramid_zodbsessions package.
-
-- translationdir ZCML directive use of ``path_spec`` should maybe die.
-
-- Option for route_url to omit the host and port (perhaps a different
-  function named ``route_path``).
-
-- SQLAlchemy idiomatics:
-
-   <RaFromBRC> mcdonc: those paster templates all look pretty good... the
-   only thing i'd consider is adjusting your config variable names to match
-   exactly what sqlalchemy uses as parameter names, see here:
-   http://www.sqlalchemy.org/docs/core/engines.html
-
-   <RaFromBRC> mcdonc: especially in the pylons_sqla ini file, where the db
-   initialization is mixed in w/ the app config...
-
-   <RaFromBRC> ... i'd use "sqlalchemy.PARAMETER" for all of the sqla
-   settings, so it could easily be handed to engine_from_config w/o any need
-   to parse by hand
-
-   <RaFromBRC> mcdonc: in the other ini files, where sqlalchemy is given its
-   own part, the "sqlalchemy." prefix probably isn't necessary, but matching
-   the parameter names (e.g. 'url' instead of 'db_string') is still probably
-   a good idea
-
-- Default renderer.
-
-- Non-bwcompat use of threadlocals:
-
-  security.principals_allowed_by_permission
-
-  resource.OverrideProvider._get_overrides: can't credibly be removed,
-  because it stores an overrideprovider as a module-scope global.
-
-  traversal.traverse: this API is a stepchild, and needs to be changed.
-
-  Configurator.add_translation_dirs: not passed any context but a message,
-  can't credibly be removed.
-
-- Add deprecation warnings for:
-
-  - Use of chameleon_zpt and chameleon_text templating functions (use
-    renderer API instead).
-
-  - settings.get_settings
-
-  - zcml.zcml_configure
-
-  - zcml.file_configure
-
-- Add static_url as method of request.
-
-
-
+- Update App engine chapter with less creaky directions.
 
+- Add functionality that mocks the behavior of ``repoze.browserid``.