summaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)Author
2011-07-12clarifyChris McDonough
2011-07-12- New environment setting ``PYRAMID_PREVENT_HTTP_CACHE`` and newChris McDonough
configuration file value ``prevent_http_cache``. These are synomymous and allow you to prevent HTTP cache headers from being set by Pyramid's ``http_cache`` machinery globally in a process. see the "Influencing HTTP Caching" section of the "View Configuration" narrative chapter and the detailed documentation for this setting in the "Environment Variables and Configuration Settings" narrative chapter. - New documentation section in View Configuration narrative chapter: "Influencing HTTP Caching".
2011-07-12- The ``pyramid_routesalchemy`` and ``pyramid_alchemy`` scaffoldsChris McDonough
inappropriately used ``DBSession.rollback()`` instead of ``transaction.abort()`` in one place. - Wiki2 (SQLAlchemy + URL Dispatch) tutorial ``models.initialize_sql`` didn't match the ``pyramid_routesalchemy`` scaffold function of the same name; it didn't get synchronized when it was changed in the scaffold.
2011-07-12- The ``Configurator.add_route`` method allowed two routes with the sameChris McDonough
route to be added without an intermediate ``config.commit()``. If you now receive a ``ConfigurationError`` at startup time that appears to be ``add_route`` related, you'll need to either a) ensure that all of your route names are unique or b) call ``config.commit()`` before adding a second route with the name of a previously added name or c) use a Configurator that works in ``autocommit`` mode.
2011-07-12- Previously, If a ``BeforeRender`` event subscriber added a value via theChris McDonough
``__setitem__`` or ``update`` methods of the event object with a key that already existed in the renderer globals dictionary, a ``KeyError`` was raised. With the deprecation of the "add_renderer_globals" feature of the configurator, there was no way to override an existing value in the renderer globals dictionary that already existed. Now, the event object will overwrite an older value that is already in the globals dictionary when its ``__setitem__`` or ``update`` is called (as well as the new ``setdefault`` method), just like a plain old dictionary. As a result, for maximum interoperability with other third-party subscribers, if you write an event subscriber meant to be used as a BeforeRender subscriber, your subscriber code will now need to (using ``.get`` or ``__contains__`` of the event object) ensure no value already exists in the renderer globals dictionary before setting an overriding value.
2011-07-12reviewedChris McDonough
2011-07-12warn about warnings in 2.7+Chris McDonough
2011-07-12fix sampleChris McDonough
2011-07-12remove references to add_route view-related configurationChris McDonough
2011-07-12remove deprecated mechanism to associate views with routes; add description ↵Chris McDonough
of scan mechanism
2011-07-12add docs about logging configChris McDonough
2011-07-12add docs about logging configChris McDonough
2011-07-12remove unnecessary clauseChris McDonough
2011-07-11simplifyChris McDonough
2011-07-11add PyPyChris McDonough
2011-07-11add PyPyChris McDonough
2011-07-11convenience commandChris McDonough
2011-07-11bad referenceChris McDonough
2011-07-11simplifyChris McDonough
2011-07-11we no longer support 24.Chris McDonough
2011-07-11simplifyChris McDonough
2011-07-11simplify wordingChris McDonough
2011-07-11earlier info referenced later info, fixChris McDonough
2011-07-11move mention of controllers to endChris McDonough
2011-07-11Merge branch 'master' of github.com:Pylons/pyramidChris McDonough
2011-07-11move alternate calling convention to chapter bottom; fix referenceChris McDonough
2011-07-10Merge pull request #229 from mmerickel/garden.webob-refsChris McDonough
Modified docs to reference webob's new website.
2011-07-10Modified docs to reference webob's new website.Michael Merickel
2011-07-10Adding 'I' to example custom AuthenticationPolicy; it's an interface.ejo
2011-07-10prep for 1.1b1Chris McDonough
2011-07-10add info to changes.txt and whatsnew about pshell changes; removed unused ↵Chris McDonough
import and unwrap string
2011-07-10Merge branch 'feature.pshell' of https://github.com/mmerickel/pyramid into ↵Chris McDonough
mmerickel-feature.pshell
2011-07-09Merge branch 'master' of github.com:Pylons/pyramidChris McDonough
2011-07-09make less confusingChris McDonough
2011-07-09Merge pull request #225 from ejo/patch-1Chris McDonough
Minor wording change for accuracy
2011-07-09request.json -> request.json_body; add some docs for json_bodyChris McDonough
2011-07-09Old sentence was grammatically incorrect, literally meant that the URL or ↵ejo
button in question did not know it was redirecting the user. It is the user who does not know, so "unwittingly" is replaced with "secretly"; "surreptitiously" would be another accurate alternative. An alternative sentence construction that maintains the word "unwittingly" would be, e.g., "...might click on a URL or button on another website and be unwittingly redirected to your application to perform some command that requires elevated privileges."
2011-07-08point at groundhog github repo (why?)Chris McDonough
2011-07-07Updated proutes and pviews docs.Michael Merickel
2011-07-07Added/updated documentation for the new interactive shell.Michael Merickel
2011-07-06- The ``config.scan`` method has grown a ``**kw`` argument. ``kw`` argumentChris McDonough
represents a set of keyword arguments to pass to the Venusian ``Scanner`` object created by Pyramid. (See the Venusian documentation for more information about ``Scanner``).
2011-07-04- New request attribute: ``json``. If the request's ``content_type`` isChris McDonough
``application/json``, this attribute will contain the JSON-decoded variant of the request body. If the request's ``content_type`` is not ``application/json``, this attribute will be ``None``.
2011-07-04- A new value ``http_cache`` can be used as a view configurationChris McDonough
parameter. When you supply an ``http_cache`` value to a view configuration, the ``Expires`` and ``Cache-Control`` headers of a response generated by the associated view callable are modified. The value for ``http_cache`` may be one of the following: - A nonzero integer. If it's a nonzero integer, it's treated as a number of seconds. This number of seconds will be used to compute the ``Expires`` header and the ``Cache-Control: max-age`` parameter of responses to requests which call this view. For example: ``http_cache=3600`` instructs the requesting browser to 'cache this response for an hour, please'. - A ``datetime.timedelta`` instance. If it's a ``datetime.timedelta`` instance, it will be converted into a number of seconds, and that number of seconds will be used to compute the ``Expires`` header and the ``Cache-Control: max-age`` parameter of responses to requests which call this view. For example: ``http_cache=datetime.timedelta(days=1)`` instructs the requesting browser to 'cache this response for a day, please'. - Zero (``0``). If the value is zero, the ``Cache-Control`` and ``Expires`` headers present in all responses from this view will be composed such that client browser cache (and any intermediate caches) are instructed to never cache the response. - A two-tuple. If it's a two tuple (e.g. ``http_cache=(1, {'public':True})``), the first value in the tuple may be a nonzero integer or a ``datetime.timedelta`` instance; in either case this value will be used as the number of seconds to cache the response. The second value in the tuple must be a dictionary. The values present in the dictionary will be used as input to the ``Cache-Control`` response header. For example: ``http_cache=(3600, {'public':True})`` means 'cache for an hour, and add ``public`` to the Cache-Control header of the response'. All keys and values supported by the ``webob.cachecontrol.CacheControl`` interface may be added to the dictionary. Supplying ``{'public':True}`` is equivalent to calling ``response.cache_control.public = True``. Providing a non-tuple value as ``http_cache`` is equivalent to calling ``response.cache_expires(value)`` within your view's body. Providing a two-tuple value as ``http_cache`` is equivalent to calling ``response.cache_expires(value[0], **value[1])`` within your view's body. If you wish to avoid influencing, the ``Expires`` header, and instead wish to only influence ``Cache-Control`` headers, pass a tuple as ``http_cache`` with the first element of ``None``, e.g.: ``(None, {'public':True})``.
2011-07-02remove male pronounChris McDonough
2011-07-02reorderChris McDonough
2011-07-01prep for 1.1a4Chris McDonough
2011-07-01fixChris McDonough
2011-07-01fix wiki tests tooChris McDonough
2011-07-01run setup.py developChris McDonough
2011-07-01use assertEqualChris McDonough