From 65f203e7290fdc9905896334ca87f5d34667d961 Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Fri, 21 Jan 2011 21:47:53 -0500 Subject: - Minimally explain usage of custom regular expressions in URL dispatch replacement markers within URL Dispatch chapter. --- docs/narr/urldispatch.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) (limited to 'docs/narr') diff --git a/docs/narr/urldispatch.rst b/docs/narr/urldispatch.rst index 39e97ab8e..8b127924b 100644 --- a/docs/narr/urldispatch.rst +++ b/docs/narr/urldispatch.rst @@ -252,6 +252,18 @@ the match result will be ``{'name': 'biz', 'ext': 'html'}``. This occurs because there is a literal part of ``.`` (period) between the two replacement markers ``{name}`` and ``{ext}``. +Replacement markers can optionally specify a regular expression which will be +used to decide whether a path segment should match the marker. To specify +that a replacement marker should match only a specific set of characters as +defined by a regular expression, you must use a slightly extended form of +replacement marker syntax. Within braces, the replacement marker name must +be followed by a colon, then directly thereafter, the regular expression. +For example, under the hood, the replacement marker ``{foo}`` can more +verbosely be spelled as ``{foo:[^/]+}``. The *default* regular expression +associated with a replacement marker ``[^/]+`` matches one or more characters +which are not a slash. You can use an arbitrary regular expression here to +match a sequence of characters. + It is possible to use two replacement markers without any literal characters between them, for instance ``/{foo}{bar}``. However, this would be a nonsensical pattern without specifying a custom regular expression to -- cgit v1.2.3