summaryrefslogtreecommitdiff
path: root/docs/narr/hybrid.rst
AgeCommit message (Collapse)Author
2019-07-27Fix typosMin ho Kim
2018-08-18Clean up code-blocks in hybridSteve Piercy
2015-11-02- remove deprecated section in docs (Closes #2067)Steve Piercy
- minor grammar, rewrap to 79 columns
2015-01-07Fix "pyramid" spellingPavlo Kapyshin
2013-11-17Removed extra indentation from some examples (:linenos: should be indented ↵Antti Haapala
with the same indentation as the rest of the code block)
2013-08-29get rid of remainder_name on route, and just default to passing traverse; ↵Chris McDonough
add route_remainder_name argument to resource_url
2013-08-29documentation for hybrid url generationChris McDonough
2013-01-01eliminate repeated "the" wordsTshepang Lekhonkhobe
2011-07-20add more index markersChris McDonough
2011-07-14- New API class: ``pyramid.static.static_view``. This supersedes theChris McDonough
deprecated ``pyramid.view.static`` class. ``pyramid.satic.static_view`` by default serves up documents as the result of the request's ``path_info``, attribute rather than it's ``subpath`` attribute (the inverse was true of ``pyramid.view.static``, and still is). ``pyramid.static.static_view`` exposes a ``use_subpath`` flag for use when you don't want the static view to behave like the older deprecated version. - The ``pyramid.view.static`` class has been deprecated in favor of the newer ``pyramid.static.static_view`` class. A deprecation warning is raised when it is used. You should replace it with a reference to ``pyramid.static.static_view`` with the ``use_subpath=True`` argument.
2011-06-03minor edits to cito's editsChris McDonough
2011-06-03Some more small fixes in the narrative docu.Christoph Zwerschke
2011-04-22- Make sure deprecation warnings aren't raised when tests are run.Chris McDonough
- Modify documentation for cross-referencing. - Use add_view(viewname) syntax rather than add_view(view=viewname) syntax for normalization. - Use warnings.warn rather than zope.deprecated in order to make testing easier. - Move tests which test deprecated methods of configurator to a separate test case.
2011-04-20Converting docs to deprecate view parameters in config.add_route.Michael Merickel
2011-01-27module name contractionsChris McDonough
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