diff options
Diffstat (limited to 'CHANGES.rst')
| -rw-r--r-- | CHANGES.rst | 30 |
1 files changed, 16 insertions, 14 deletions
diff --git a/CHANGES.rst b/CHANGES.rst index 53bf0ab60..1790bb69f 100644 --- a/CHANGES.rst +++ b/CHANGES.rst @@ -12,11 +12,22 @@ Features documentation for more information about why this change was made. See https://github.com/Pylons/pyramid/pull/3413 -- It is now possible to declare a route to not contain a trailing slash - when it is mounted via ``config.include(..., route_prefix=...)`` or via - ``with config.route_prefix_context(...)`` by specifying a ``pattern`` of - ``''``. This change is backward incompatible, see the notes below. - See https://github.com/Pylons/pyramid/pull/3414 +- It is now possible to control whether a route pattern contains a trailing + slash when it is composed with a route prefix using + ``config.include(..., route_prefix=...)`` or + ``with config.route_prefix_context(...)``. This can be done by specifying + an empty pattern and setting the new argument + ``inherit_slash=True``. For example:: + + with config.route_prefix_context('/users'): + config.add_route('users', '', inherit_slash=True) + + In the example, the resulting pattern will be ``/users``. Similarly, if the + route prefix were ``/users/`` then the final pattern would be ``/users/``. + If the ``pattern`` was ``'/'``, then the final pattern would always be + ``/users/``. This new setting is only available if the pattern supplied + to ``add_route`` is the empty string (``''``). + See https://github.com/Pylons/pyramid/pull/3420 Bug Fixes --------- @@ -74,15 +85,6 @@ Backward Incompatibilities documentation for more information about why this change was made. See https://github.com/Pylons/pyramid/pull/3413 -- Changed the URL generation and matching for a route with a ``pattern`` of - ``''`` when the route is mounted with a ``route_prefix`` via either - ``config.include(..., route_prefix=...)`` or - ``with config.route_prefix_context(...)``. This route will now match a bare - URL without a trailing slash. To preserve the old behavior, set the - ``pattern`` to ``'/'`` instead of the empty string and the URL will contain - a trailing slash. This only affects mounted routes using ``route_prefix``. - See https://github.com/Pylons/pyramid/pull/3414 - Documentation Changes --------------------- |