summaryrefslogtreecommitdiff
path: root/docs/glossary.rst
AgeCommit message (Collapse)Author
2011-08-08document under and over paramsChris McDonough
2011-08-06add glossary entry for tweenChris McDonough
2011-07-28add some edits to the docs for response_adapter decorator; fix renderingsChris McDonough
2011-07-11add PyPyChris McDonough
2011-07-11bad referenceChris McDonough
2011-07-11simplifyChris McDonough
2011-07-10Modified docs to reference webob's new website.Michael Merickel
2011-07-09request.json -> request.json_body; add some docs for json_bodyChris McDonough
2011-06-14merge httpexception-utils branchChris McDonough
2011-06-13- Remove IResponder abstraction in favor of more general IResponseChris McDonough
abstraction. - It is now possible to return an arbitrary object from a Pyramid view callable even if a renderer is not used, as long as a suitable adapter to ``pyramid.interfaces.IResponse`` is registered for the type of the returned object. See the section in the Hooks chapter of the documentation entitled "Changing How Pyramid Treats View Responses". - The Pyramid router now, by default, expects response objects returned from view callables to implement the ``pyramid.interfaces.IResponse`` interface. Unlike the Pyramid 1.0 version of this interface, objects which implement IResponse now must define a ``__call__`` method that accepts ``environ`` and ``start_response``, and which returns an ``app_iter`` iterable, among other things. Previously, it was possible to return any object which had the three WebOb ``app_iter``, ``headerlist``, and ``status`` attributes as a response, so this is a backwards incompatibility. It is possible to get backwards compatibility back by registering an adapter to IResponse from the type of object you're now returning from view callables. See the section in the Hooks chapter of the documentation entitled "Changing How Pyramid Treats View Responses". - The ``pyramid.interfaces.IResponse`` interface is now much more extensive. Previously it defined only ``app_iter``, ``status`` and ``headerlist``; now it is basically intended to directly mirror the ``webob.Response`` API, which has many methods and attributes. - Documentation changes to support above.
2011-06-11- Pyramid now expects Response objects to have a __call__Chris McDonough
method which implements the WSGI application interface instead of the three webob attrs status, headerlist and app_iter. Backwards compatibility exists for code which returns response objects that do not have a __call__. - pyramid.response.Response is no longer an exception (and therefore cannot be raised in order to generate a response). - Changed my mind about moving stuff from pyramid.httpexceptions to pyramid.response. The stuff I moved over has been moved back to pyramid.httpexceptions.
2011-06-04- It is now possible to control how the Pyramid router calls the WSGIChris McDonough
``start_response`` callable and obtains the WSGI ``app_iter`` based on adapting the response object to the new ``pyramid.interfaces.IResponder`` interface. The default ``IResponder`` uses Pyramid 1.0's logic to do this. To override the responder:: from pyramid.interfaces import IResponder from pyramid.response import Response from myapp import MyResponder config.registry.registerAdapter(MyResponder, (Response,), IResponder, name='') This makes it possible to reuse response object implementations which have, for example, their own ``__call__`` expected to be used as a WSGI application (like ``pyramid.response.Response``), e.g.: class MyResponder(object): def __init__(self, response): """ Obtain a reference to the response """ self.response = response def __call__(self, request, start_response): """ Call start_response and return an app_iter """ app_iter = self.response(request.environ, start_response) return app_iter
2011-06-03Some more small fixes in the narrative docu.Christoph Zwerschke
2011-05-31the canonical import location for HTTP exceptions/responses is now ↵Chris McDonough
pyramid.response
2011-05-16- Added API docs for ``pyramid.httpexceptions.abort`` andChris McDonough
``pyramid.httpexceptions.redirect``. - Added "HTTP Exceptions" section to Views narrative chapter including a description of ``pyramid.httpexceptions.abort``; adjusted redirect section to note ``pyramid.httpexceptions.redirect``. - A default exception view for the context ``webob.exc.HTTPException`` (aka ``pyramid.httpexceptions.HTTPException``) is now registered by default. This means that an instance of any exception class imported from ``pyramid.httpexceptions`` (such as ``HTTPFound``) can now be raised from within view code; when raised, this exception view will render the exception to a response. - New functions named ``pyramid.httpexceptions.abort`` and ``pyramid.httpexceptions.redirect`` perform the equivalent of their Pylons brethren when an HTTP exception handler is registered. These functions take advantage of the newly registered exception view for ``webob.exc.HTTPException``. - The Configurator now accepts an additional keyword argument named ``httpexception_view``. By default, this argument is populated with a default exception view function that will be used when an HTTP exception is raised. When ``None`` is passed for this value, an exception view for HTTP exceptions will not be registered. Passing ``None`` returns the behavior of raising an HTTP exception to that of Pyramid 1.0 (the exception will propagate to middleware and to the WSGI server).
2011-05-14Correct spelling of my nameWichert Akkerman
2011-05-14use lingua in docs (thanks to wichert)Chris McDonough
2011-05-13- Added documentation for a "multidict" (e.g. the API of ``request.POST``) asChris McDonough
interface API documentation.
2011-04-11pyramid_sqla -> akhetChris McDonough
2011-03-24It was decided that pyramid would undergo a terminology change.Joe Dallago
'Paster templates' will now be refered to as 'scaffolds,' while 'rendered templates' will remain as 'templates.' I have changed the docs to reflect this change in terminology.
2011-01-29Merge branch 'master' of https://github.com/osmaker/pyramid into osmaker-masterChris McDonough
2011-01-29- Moved "Using ZODB With ZEO" and "Using repoze.catalog Within Pyramid"Chris McDonough
tutorials out of core documentation and into the Pyramid Tutorials site (http://docs.pylonsproject.org/projects/pyramid_tutorials/dev/).
2011-01-28renderingsChris McDonough
2011-01-28minor grammar fixes ('a' vs 'an')Kyle Johnson
2011-01-21add distutils entryChris McDonough
2011-01-21point at Pyramid Cookbook explicitlyChris McDonough
2011-01-21add caveat for PyPy and Jython usersChris McDonough
2011-01-19handlers are no longer a part of the packageChris McDonough
2011-01-18- Most references to ZCML in narrative chapters have been removed orChris McDonough
redirected to ``pyramid_zcml`` locations.
2011-01-16use correct renderingChris McDonough
2011-01-08fix renderingsChris McDonough
2011-01-03- Add a new API ``pyramid.url.current_route_url``, which computes a URL basedChris McDonough
on the "current" route (if any) and its matchdict values.
2011-01-02Split view chapter, move view config after templates, some reordering in ↵Casey Duncan
view config
2011-01-03fix renderingChris McDonough
2011-01-03Merge branch 'master' of https://github.com/jahmad/pyramid into jahmad-masterChris McDonough
2011-01-02- add a ``add_view_mapper`` API to Configurator. This API allows you to addChris McDonough
a named implementation of a ``pyramid.interfaces.IViewMapperFactory`` interface. Its name can be passed as a ``view_mapper`` argument to ``config.add_view``. A view mapper allows objects that are meant to be used as view callables to have an arbitrary argument list and an arbitrary result. This feature will be used by Pyramid extension developers, not by "civilians". - New constructor argument to Configurator: ``default_view_mapper``. Useful to create systems that have view callables with alternate default calling conventions. - ``view_mapper`` argument to ``add_view`` should now be a view mapper *name* rather than an implementation. - Add ``view_mapper`` argument to ``view_config`` decorator constructor. - Remove (non-API) function of config.py named _map_view. - Fix docstring for ``decorator`` argument to add_view. - Factor invocation of view mapper into a viewderiver method. - Promote view rendering and decorating into viewderiver, out of view mapper. - Make requestonly into a function rather than a method of the default view mapper.
2010-12-31handlers_chapter -> views_chapterJamaludin Ahmad
2010-12-26wordingChris McDonough
2010-12-23fix referencesChris McDonough
2010-12-19add functional testing exampleChris McDonough
2010-12-19context finding -> resource locationChris McDonough
2010-12-19reference module from packageChris McDonough
2010-12-19update firstapp chapterChris McDonough
2010-12-18model->resource; make docs render without warningsChris McDonough
2010-12-18resource -> assetChris McDonough
2010-12-09fix docs: pyramid.configuration -> pyramid.configChris McDonough
2010-11-11document the request.settings attribute as well as we canChris McDonough
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-06Docs fix: Missed an instance of bfg -> pyramid in the glossary.William Chambers
2010-11-02tweak handlers chapterChris McDonough