summaryrefslogtreecommitdiff
path: root/docs/narr/hybrid.rst
AgeCommit message (Collapse)Author
2010-12-19context finding -> resource locationChris McDonough
2010-12-18model -> resource; resource -> assetChris McDonough
2010-12-12fix merge conflictsCasey Duncan
2010-12-09fix docs: pyramid.configuration -> pyramid.configChris McDonough
2010-12-02Merge https://github.com/Pylons/pyramidCasey Duncan
2010-12-01stray quote markChris McDonough
2010-11-24Use a colon instead of a periodCasey Duncan
2010-11-24Fix typoCasey Duncan
2010-11-24XXX Add an example of when views would be invoked by the 'useful' config. ↵Casey Duncan
Confirm this is correct XXX
2010-11-24non-useless => usefulCasey Duncan
2010-11-24Clarify paragraph explaining use_global_viewsCasey Duncan
2010-11-24make it clear this is a chapter referenceCasey Duncan
2010-11-24add commaCasey Duncan
2010-11-24add commaCasey Duncan
2010-11-24Clarify paragraph describing why Traversable is traversableCasey Duncan
2010-11-24Lose the word 'here' since we already said it's 'above'Casey Duncan
2010-11-24Clarify paragraph describing custom root factoryCasey Duncan
2010-11-22XXX Add an additional explaining sentence to clarify the chain of 'implieds' ↵Casey Duncan
in the hybrid example. Confirm this is correct XXX
2010-11-22Add commaCasey Duncan
2010-11-20convert stray references to colon routing syntax to squiggly syntaxChris McDonough
2010-11-17More ReStructuredText fixes in docstrings.Marius Gedminas
(After a recursive grep for ':[a-z]*:`[A-Z0-9a-z._]*``')
2010-11-09- All references to Pyramid-the-application were changed from :mod:`pyramid`Chris McDonough
to :app:`Pyramid`. A custom role setting was added to ``docs/conf.py`` to allow for this. (internal)
2010-11-03de-zcml-ify various chapters and move ZCML to the declarative chapterChris McDonough
2010-10-25convert narrative docs to PyramidChris McDonough
2010-09-08- The ``repoze.bfg.urldispatch.Route`` constructor (not an API) nowChris McDonough
accepts a different ordering of arguments. Previously it was ``(pattern, name, factory=None, predicates=())``. It is now ``(name, pattern, factory=None, predicates=())``. This is in support of consistency with ``configurator.add_route``. - The ``repoze.bfg.urldispatch.RoutesMapper.connect`` method (not an API) now accepts a different ordering of arguments. Previously it was ``(pattern, name, factory=None, predicates=())``. It is now ``(name, pattern, factory=None, predicates=())``. This is in support of consistency with ``configurator.add_route``. - The ``repoze.bfg.urldispatch.RoutesMapper`` object now has a ``get_route`` method which returns a single Route object or ``None``. - A new interface ``repoze.bfg.interfaces.IRoute`` was added. The ``repoze.bfg.urldispatch.Route`` object implements this interface. - The canonical attribute for accessing the routing pattern from a route object is now ``pattern`` rather than ``path``. - The argument to ``repoze.bfg.configuration.Configurator.add_route`` which was previously called ``path`` is now called ``pattern`` for better explicability. For backwards compatibility purposes, passing a keyword argument named ``path`` to ``add_route`` will still work indefinitely. - The ``path`` attribute to the ZCML ``route`` directive is now named ``pattern`` for better explicability. The older ``path`` attribute will continue to work indefinitely. - All narrative, API, and tutorial docs which referred to a route pattern as a ``path`` have now been updated to refer to them as a ``pattern``. - The routesalchemy template has been updated to use ``pattern`` in its route declarations rather than ``path``.
2010-07-23- The ``Hybrid`` narrative chapter now contains a description of theChris McDonough
``traverse`` route argument. - Fix route ZCML directive to use traverse.
2010-07-23- New argument to ``repoze.bfg.configuration.Configurator.add_route``Chris McDonough
and the ``route`` ZCML directive: ``traverse``. If you would like to cause the ``context`` to be something other than the ``root`` object when this route matches, you can spell a traversal pattern as the ``traverse`` argument. This traversal pattern will be used as the traversal path: traversal will begin at the root object implied by this route (either the global root, or the object returned by the ``factory`` associated with this route). The syntax of the ``traverse`` argument is the same as it is for ``path``. For example, if the ``path`` provided is ``articles/:article/edit``, and the ``traverse`` argument provided is ``/:article``, when a request comes in that causes the route to match in such a way that the ``article`` match value is '1' (when the request URI is ``/articles/1/edit``), the traversal path will be generated as ``/1``. This means that the root object's ``__getitem__`` will be called with the name ``1`` during the traversal phase. If the ``1`` object exists, it will become the ``context`` of the request. The Traversal narrative has more information about traversal. If the traversal path contains segment marker names which are not present in the path argument, a runtime error will occur. The ``traverse`` pattern should not contain segment markers that do not exist in the ``path``. A similar combining of routing and traversal is available when a route is matched which contains a ``*traverse`` remainder marker in its path. The ``traverse`` argument allows you to associate route patterns with an arbitrary traversal path without using a a ``*traverse`` remainder marker; instead you can use other match information. Note that the ``traverse`` argument is ignored when attached to a route that has a ``*traverse`` remainder marker in its path.
2010-04-13Fix (thanks to Iain Duncan).Chris McDonough
2010-03-11more trivial fixesCarlos de la Guardia
2010-02-03Make the hybrid chapter represent reality.Chris McDonough
2010-02-02Missed checkin.Chris McDonough
2010-01-24Free at last, free at last, thank god almighty free at last.Chris McDonough
2010-01-19Spellcheck.Chris McDonough
2010-01-18Prep for b1Chris McDonough
Merge a bunch of paper-based docs fixes Configure logging during bfgshell.
2010-01-17Review.Chris McDonough
2010-01-11Merge of andrew-docs branch.Chris McDonough
2010-01-03Missed one.Chris McDonough
2010-01-03FeaturesChris McDonough
-------- - The ``Configurator.add_view`` method now accepts an argument named ``context``. This is an alias for the older argument named ``for_``; it is preferred over ``for_``, but ``for_`` will continue to be supported "forever". - The ``view`` ZCML directive now accepts an attribute named ``context``. This is an alias for the older attribute named ``for``; it is preferred over ``for``, but ``for`` will continue to be supported "forever". - The ``Configurator.add_route`` method now accepts an argument named ``view_context``. This is an alias for the older argument named ``view_for``; it is preferred over ``view_for``, but ``view_for`` will continue to be supported "forever". - The ``route`` ZCML directive now accepts an attribute named ``view_context``. This is an alias for the older attribute named ``view_for``; it is preferred over ``view_for``, but ``view_for`` will continue to be supported "forever". Documentation and Paster Templates ---------------------------------- - All uses of the ``Configurator.add_view`` method that used its ``for_`` argument now use the ``context``argument instead. - All uses of the ``Configurator.add_route`` method that used its ``view_for`` argument now use the ``view_context``argument instead. - All uses of the ``view`` ZCML directive that used its ``for`` attribute now use the ``context`` attribute instead. - All uses of the ``route`` ZCML directive that used its ``view_for`` attribute now use the ``view_context`` attribute instead.
2009-12-27- Added manual index entries to generated index.Chris McDonough
2009-12-22Roles.Chris McDonough
2009-12-09Excise make_app from docs.Chris McDonough
2009-11-28Typo.Chris McDonough
2009-11-22Rendering tweaks.Chris McDonough
2009-11-01Remove incorrect docs from hybrid chapter.Chris McDonough
Organize changelog of 1.1a1 into categories.
2009-10-30- The ``__call__`` of a plugin "traverser" implementation (registeredChris McDonough
as an adapter for ``ITraverser`` or ``ITraverserFactory``) will now receive a *request* as the single argument to its ``__call__`` method. In previous versions it was passed a WSGI ``environ`` object. The request object passed to the factory implements dictionary-like methods in such a way that existing traverser code which expects to be passed an environ will continue to work. - Fix docs.
2009-09-06Merge multiview2 branch to HEAD.Chris McDonough
2009-07-05Spellcheck.Chris McDonough
2009-07-03General editing walkthrough.Chris McDonough
2009-06-24Typo.Chris McDonough
2009-06-24Add (painful) explanation of weak-binding route view context registrations.Chris McDonough