comparison env/lib/python3.7/site-packages/Routes-2.4.1.dist-info/METADATA @ 0:26e78fe6e8c4 draft

"planemo upload commit c699937486c35866861690329de38ec1a5d9f783"
author shellac
date Sat, 02 May 2020 07:14:21 -0400
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:26e78fe6e8c4
1 Metadata-Version: 2.0
2 Name: Routes
3 Version: 2.4.1
4 Summary: Routing Recognition and Generation Tools
5 Home-page: https://routes.readthedocs.io/
6 Author: Ben Bangert
7 Author-email: ben@groovie.org
8 License: MIT
9 Keywords: routes webob dispatch
10 Platform: UNKNOWN
11 Classifier: Development Status :: 5 - Production/Stable
12 Classifier: Intended Audience :: Developers
13 Classifier: License :: OSI Approved :: MIT License
14 Classifier: Topic :: Internet :: WWW/HTTP
15 Classifier: Topic :: Software Development :: Libraries :: Python Modules
16 Classifier: Programming Language :: Python :: Implementation :: PyPy
17 Classifier: Programming Language :: Python :: Implementation :: CPython
18 Classifier: Programming Language :: Python
19 Classifier: Programming Language :: Python :: 2
20 Classifier: Programming Language :: Python :: 2.6
21 Classifier: Programming Language :: Python :: 2.7
22 Classifier: Programming Language :: Python :: 3
23 Classifier: Programming Language :: Python :: 3.2
24 Classifier: Programming Language :: Python :: 3.3
25 Classifier: Programming Language :: Python :: 3.4
26 Classifier: Programming Language :: Python :: 3.5
27 Requires-Dist: repoze.lru (>=0.3)
28 Requires-Dist: six
29 Provides-Extra: middleware
30 Requires-Dist: webob; extra == 'middleware'
31
32 Routes is a Python re-implementation of the Rails routes system for mapping
33 URL's to Controllers/Actions and generating URL's. Routes makes it easy to
34 create pretty and concise URL's that are RESTful with little effort.
35
36 Speedy and dynamic URL generation means you get a URL with minimal cruft
37 (no big dangling query args). Shortcut features like Named Routes cut down
38 on repetitive typing.
39
40 See `the documentation for installation and usage of Routes <http://readthedocs.org/docs/routes/en/latest/>`_.
41
42 .. image:: https://secure.travis-ci.org/bbangert/routes.png?branch=master
43 :alt: Build Status
44 :target: https://secure.travis-ci.org/bbangert/routes
45
46
47 Routes Changelog
48 %%%%%%%%%%%%%%%%
49
50 Release 2.4.0 (January 1, 2017)
51 ===============================
52
53 * Release as a universal wheel. PR #75.
54 * Convert readthedocs links for their .org -> .io migration for hosted projects. PR #67.
55
56
57 Release 2.3.1 (March 30, 2016)
58 ==============================
59 * Backwards compatability fix - connect should work with mandatory
60 routename and optional path. Patch by Davanum Srinivas (PR #65).
61
62 Release 2.3 (March 28, 2016)
63 ============================
64 * Fix sub_domain equivalence check. Patch by Nikita Uvarov
65 * Add support for protocol-relative URLs generation (i.e. starting with double
66 slash ``//``). PR #60. Patch by Sviatoslav Sydorenko.
67 * Add support for the ``middleware`` extra requirement, making possible to
68 depend on ``webob`` optionally. PR #59. Patch by Sviatoslav Sydorenko.
69 * Fix matching of an empty string route, which led to exception in earlier
70 versions. PR #58. Patch by Sviatoslav Sydorenko.
71 * Add support for the ``requirements`` option when using
72 mapper.resource to create routes. PR #57. Patch by Sean Dague.
73 * Concatenation fix when using submappers with path prefixes. Multiple
74 submappers combined the path prefix inside the controller argument in
75 non-obvious ways. The controller argument will now be properly carried
76 through when using submappers. PR #28.
77
78 Release 2.2 (July 21, 2015)
79 ===========================
80 * Fix Python 3 support. Patch by Victor Stinner.
81
82 Release 2.1 (January 17, 2015)
83 ==============================
84 * Fix 3 other route matching groups in route.py to use anonymous groups for
85 optional sections to avoid exceeding regex limits. Fixes #15.
86 * Printing a mapper now includes the Controller/action parameters from the
87 route. Fixes #11.
88 * Fix regression that didn't allow passing in params 'host', 'protocol', or
89 'anchor'. They can now be passed in with a trailing '_' as was possible
90 before commit d1d1742903fa5ca24ef848a6ae895303f2661b2a. Fixes #7.
91 * URL generation with/without SCRIPT_NAME was resulting in the URL cache
92 failing to return the appropriate cached URL generation. The URL cache
93 should always include the SCRIPT_NAME, even if its empty, in the cache
94 to avoid this, and now does. Fixes #6.
95 * Extract Route creation into separate method in Mapper. Subclasses of Route
96 can be created by Mappers now.
97 * Use the first X_FORWARDED_FOR value if there are multiple proxies in the
98 path. Fixes #5.
99
100 Release 2.0 (November 17, 2013)
101 ===============================
102 * Python 3.2/3.3 Support. Fixes Issue #2. Thanks to Alejandro Sánchez for
103 the pull request!
104
105 Release 1.13 (March 12, 2012)
106 =============================
107 * Fix bug with dots forcing extension by default. The portion with the dot can
108 now be recognized. Patch by Michael Basnight.
109
110 Release 1.12.3 (June 5, 2010)
111 =============================
112 * Fix bug with URLGenerator not properly including SCRIPT_NAME when generating
113 URL's and the singleton is not present.
114
115 Release 1.12.2 (May 5, 2010)
116 ============================
117 * Fix bug with routes URLGenerator not properly including SCRIPT_NAME when
118 generating qualified URL's.
119
120 Release 1.12.1 (March 11, 2010)
121 ===============================
122 * Fix bug with routes not generating URL's with callables in defaults.
123 * Fix bug with routes not handling sub-domain defaults during generation.
124
125 Release 1.12 (February 28, 2010)
126 ================================
127 * Split up the Routes docs.
128 * Fix bug with relative URL's using qualified merging host and URL without
129 including the appropriate slash. Fixes #13.
130 * Fix bug with mapper.extend and Routes modifying their original args.
131 Fixes #24.
132 * Fix url.current() not returning current args when explicit is True.
133 * Added explicit way to directly use the Mapper to match with environ.
134 * Fix bug with improper len placement for submapper.
135 * Adding regular expression builder for entire regexp for faster rejection
136 in a single regexp match should none of the routes match.
137 * Give Mapper a tabular string representation.
138 * Make SubMapper objects nestable and add route-generation helpers.
139 * Add SubMapper-based collections.
140 * Make the deprecated Mapper.minimization False (disabled) by default.
141 * Make the mapper explicit (true) by default.
142
143 Release 1.11 (September 28, 2009)
144 =================================
145 * Extensive documentation rewrite.
146 * Added Mapper.extend function that allows one to add lists of Routes objects
147 to the mapper in one batch, optionally with a path_prefix.
148 * Added Mapper.submapper function that returns a SubMapper object to enable
149 easier declaration of routes that have multiple keyword argument options
150 in common.
151 * Mapper controller_scan argument now handles None, and lists of controller
152 names in addition to a callable.
153 * Route object now takes a name parameter, which is the name it responds to.
154 This name is automatically added when called by using Mapper's connect
155 class method.
156 * Added optional LRU object for use with Routes when URL's change too often
157 for the Routes urlcache dict to be a viable option.
158
159 Release 1.10.3 (February 8, 2009)
160 =================================
161 * Tweak to use WebOb Request rather than Paste.
162 * Performance tweaks for URL recognition.
163 * Bugfix for routes.middleware not re.escaping the path_info before moving it
164 to the script name.
165
166 Release 1.10.2 (January 11, 2009)
167 =================================
168 * Bugfix for unicode encoding problems with non-minimized Route generation.
169 Spotted by Wichert Akkerman.
170 * Bugfix for when environ is {} in unit tests.
171
172 Release 1.10.1 (September 27, 2008)
173 ===================================
174 * Removing LRU cache due to performance and threading issues. Cache does hit
175 a max-size for the given routes.
176
177 Release 1.10 (September 24, 2008)
178 =================================
179 * Adding LRU cache instead of just dict for caching generated routes. This
180 avoids slow memory leakage over long-running and non-existent route
181 generation.
182 * Adding URLGenerator object.
183 * Adding redirect routes.
184 * Static routes can now interpolate variable parts in the path if using {}
185 variable part syntax.
186 * Added sub_domain condition option to accept False or None, to require that
187 there be no sub-domain provided for the route to match.
188
189 Release 1.9.2 (July 8, 2008)
190 ============================
191 * Fixed bug in url_for which caused it to return a literal when it shouldn't
192 have.
193
194 Release 1.9.1 (June 28, 2008)
195 =============================
196 * Fixed bug in formatted route recognition with formatting being absorbed
197 into the id.
198
199 Release 1.9 (June 12, 2008)
200 ===========================
201 * Fix undefined arg bug in url_for.
202 * Fixed bug with url_for not working properly outside of a request when
203 sub-domains are active. Thanks Pavel Skvazh.
204 * Add non-minimization option to Routes and the Mapper for generation and
205 recognition.
206 * Add Routes 2.0 style syntax for making routes and regexp. For example, this
207 route will now work: '{controller}/{action}/{id}'.
208 * Fixed Routes to not use quote_plus when making URL's.
209 * WARNING: Mapper now comes with hardcode_names set to True by default. This
210 means routes generated by name must work for the URL.
211 * Actually respect having urlcache disabled.
212 * WARNING: Calling url_for with a set of args that returns None now throws an
213 exception. Code that previously checked to see if a url could be made must
214 be updated accordingly.
215 * Updated url_for to return url in a literal for use in templating that may
216 try to escape it again.
217 * Added option to use X_FORWARDED_PROTO for proxying behind https to work
218 easier.
219 * Fixed map.resource to be less restrictive on id than just spaces.
220 * Fixed Mapper.create_regs not being thread safe, particularly when
221 always_scan=True.
222
223 Release 1.8 (March 28, 2008)
224 ============================
225 * Fixed bug of map.resource not allowing spaces in id.
226 * Fixed url generation to properly handle unicode defaults in addition to
227 unicode arguments.
228 * Fixed url_for to handle lists as keyword args when generating query
229 parameters.
230 * WARNING: Changed map.resource to not use ';', for actions, but the
231 normal '/'. This means that formatted URL's will also now have the format
232 come AFTER the action. Ie: /messsages/4.xml;rss -> /messages/4/rss.xml
233
234 Release 1.7.3 (May 28th, 2008)
235 ==============================
236 * Fixed triple escaping bug, since WSGI servers are responsible for basic
237 unescaping.
238
239 Release 1.7.2 (Feb. 27th, 2008)
240 ===============================
241 * Fixed bug with keyword args not being coerced to raw string properly.
242
243 Release 1.7.1 (Nov. 16th, 2007)
244 ===============================
245 * Fixed bug with sub-domains from route defaults getting encoded to unicode
246 resulting in a unicode route which then caused url_for to throw an
247 exception.
248 * Removed duplicate assignment in map.resource. Patch by Mike Naberezny.
249 * Applied test patch fix for path checking. Thanks Mike Naberezny.
250 * Added additional checking of remaining URL, to properly swallow periods in
251 the appropriate context. Fixes #57.
252 * Added mapper.hardcode_names option which restricts url generation to the
253 named route during generation rather than using the routes default options
254 during generation.
255 * Fixed the special '_method' attribute not being recognized during POST
256 requests of Content-Type 'multipart/form-data'.
257
258 Release 1.7 (June 8th, 2007)
259 ============================
260 * Fixed url_unquoting to only apply for strings.
261 * Added _encoding option to individual routes to toggle decoding/encoding on a
262 per route basis.
263 * Fixed route matching so that '.' and other special chars are only part of the
264 match should they not be followed by that character. Fixed regexp creation so
265 that route parts with '.' in them aren't matched properly. Fixes #48.
266 * Fixed Unicode decoding/encoding so that the URL decoding and encoding can be
267 set on the mapper with mapper.encoding. Fixes #40.
268 * Don't assume environ['CONTENT_TYPE'] always exists: it may be omitted
269 according to the WSGI PEP.
270 * Fixed Unicode decode/encoding of path_info dynamic/wildcard parts so that
271 PATH_INFO will stay a raw string as it should. Fixes #51.
272 * Fixed url_for (thus redirect_to) to throw an exception if a Unicode
273 string is returned as that's an invalid URL. Fixes #46.
274 * Fixed Routes middleware to only parse POST's if the content type is
275 application/x-www-form-urlencoded for a HTML form. This properly avoids
276 parsing wsgi.input when it doesn't need to be.
277
278 Release 1.6.3 (April 10th, 2007)
279 ================================
280 * Fixed matching so that an attempt to match an empty path raises a
281 RouteException. Fixes #44.
282 * Added ability to use characters in URL's such as '-' and '_' in
283 map.resource. Patch by Wyatt Baldwin. Fixes #45.
284 * Updated Mapper.resource handling with name_prefix and path_prefix checking
285 to specify defaults. Also ensures that should either of them be set, they
286 override the prefixes should parent_resource be specified. Patch by Wyatt
287 Baldwin. Fixes #42.
288 * Added utf-8 decoding of incoming path arguments, with fallback to ignoring
289 them in the very rare cases a malformed request URL is sent. Patch from
290 David Smith.
291 * Fixed treatment of '#' character as something that can be left off and
292 used in route paths. Found by Mike Orr.
293 * Added ability to specify parent resource to map.resource command. Patch from
294 Wyatt Baldwin.
295 * Fixed formatted route issue with map.resource when additional collection
296 methods are specified. Added unit tests to verify the collection methods
297 work properly.
298 * Updated URL parsing to properly use HTTP_HOST for hostname + port info before
299 falling back to SERVER_PORT and SERVER_NAME. Fixes #43.
300 * Added member_name and collection_name setting to Route object when made with
301 map.resource.
302 * Updated routes.middleware to make the Routes matched accessible as
303 environ['routes.route'].
304 * Updating mapper object to use thread local for request data (such as
305 environ) and middleware now deletes environ references at the end of the
306 request.
307 * Added explicit option to Routes and Mapper. Routes _explicit setting will
308 prevent the Route defaults from being implicitly set, while setting Mapper
309 to explicit will prevent Route implicit defaults and stop url_for from using
310 Route memory. Fixes #38.
311 * Updated config object so that the route is attached if possible.
312 * Adding standard logging usage with debug messages.
313 * Added additional test for normal '.' match and fixed new special matching to
314 match it properly. Thanks David Smith.
315 * Fixed hanging special char issue with 'special' URL chars at the end of a URL
316 that are missing the variable afterwards.
317 * Changed Routes generation and recognition to handle other 'special' URL chars
318 , . and ; as if they were /. This lets them be optionally left out of the
319 resulting generated URL. Feature requested by David Smith.
320 * Fixed lookahead assertion in regexp builder to properly handle two grouped
321 patterns in a row.
322 * Applied patch to generation and matching to handle Unicode characters
323 properly. Reported with patch by David Smith.
324
325 Release 1.6.2 (Jan. 5, 2007)
326 ============================
327 * Fixed issue with method checking not properly handling different letter
328 cases in REQUEST_METHOD. Reported by Sean Davis.
329 * redirect_to now supports config.redirect returning a redirect, not just
330 raising one.
331
332 Release 1.6.1 (Dec. 29, 2006)
333 =============================
334 * Fixed zipsafe flag to be False.
335
336 Release 1.6 (Dec. 14th, 2006)
337 =============================
338 * Fixed append_slash to take effect in the route generation itself instead of
339 relying on url_for function. Reported by ToddG.
340 * Added additional url_for tests to ensure map.resource generates proper named
341 routes.
342 * WARNING: Changed map.resource initialization to accept individual member and
343 collection names to generate proper singular and plural route names. Those
344 using map.resource will need to update their routes and url_for statements
345 accordingly.
346 * Added additional map.resource recognition tests.
347 * Added WSGI middleware that does route resolving using new `WSGI.org Routing
348 Vars Spec <http://wsgi.org/wsgi/Specifications/routing_args>`_.
349 * Added _absolute keyword option route connect to ignore SCRIPT_NAME settings.
350 Suggested by Ian Bicking.
351
352 Release 1.5.2 (Oct. 16th, 2006)
353 ===============================
354 * Fixed qualified keyword to keep host port names when used, unless a host
355 is specifically passed in. Reported by Jon Rosebaugh.
356 * Added qualified keyword option to url_for to have it generate a full
357 URL. Resolves #29.
358 * Fixed examples in url_for doc strings so they'll be accurate.
359
360 Release 1.5.1 (Oct. 4th, 2006)
361 ==============================
362 * Fixed bug with escaping part names in the regular expression, reported by
363 James Taylor.
364
365 Release 1.5 (Sept. 19th, 2006)
366 ==============================
367 * Significant updates to map.resource and unit tests that comb it thoroughly
368 to ensure its creating all the proper routes (it now is). Increased unit
369 testing coverage to 95%.
370 * Added unit tests to ensure controller_scan works properly with nested
371 controller files and appropriately scans the directory structure. This
372 brings the Routes util module up to full code coverage.
373 * Fixed url_for so that when the protocol is changed, port information is
374 removed from the host.
375 * Added more thorough testing to _RequestConfig object and the ability to
376 set your own object. This increases testing coverage of the __init__ module
377 to 100%.
378 * Fixed bug with sub_domain not maintaining port information in url_for and
379 added unit tests. Reported by Jonathan Rosebaugh.
380 * Added unit tests to ensure sub_domain option works with named routes, cleaned
381 up url_for memory argument filtering. Fixed bug with named routes and sub_domain
382 option not working together, reported by Jonathan Rosebaugh.
383 * Changed order in which sub-domain is added to match-dict so it can be used
384 in a conditions function.
385
386 Release 1.4.1 (Sept. 6th, 2006)
387 ===============================
388 * Added sub_domains option to mapper, along with sub_domains_ignore list for
389 subdomains that are considered equivilant to the main domain. When sub_domains
390 is active, url_for will now take a sub_domain option that can alter the host
391 the route will go to.
392 * Added ability for filter functions to provide a _host, _protocol, _anchor arg
393 which is then used to create the URL with the appropriate host/protocol/anchor
394 destination.
395 * Patch applied from Ticket #28. Resolves issue with Mapper's controller_scan
396 function requiring a valid directory argument. Submitted by Zoran Isailovski.
397
398 Release 1.4 (July 21, 2006)
399 ===========================
400 * Fixed bug with map.resource related to member methods, found in Rails version.
401 * Fixed bug with map.resource member methods not requiring a member id.
402 * Fixed bug related to handling keyword argument controller.
403 * Added map.resource command which can automatically generate a batch of routes intended
404 to be used in a REST-ful manner by a web framework.
405 * Added URL generation handling for a 'method' argument. If 'method' is specified, it
406 is not dropped and will be changed to '_method' for use by the framework.
407 * Added conditions option to map.connect. Accepts a dict with optional keyword args
408 'method' or 'function'. Method is a list of HTTP methods that are valid for the route.
409 Function is a function that will be called with environ, matchdict where matchdict is
410 the dict created by the URL match.
411 * Fixed redirect_to function for using absolute URL's. redirect_to now passes all args to
412 url_for, then passes the resulting URL to the redirect function. Reported by climbus.
413
414 Release 1.3.2 (April 30th, 2006)
415 ================================
416 * Fixed _filter bug with inclusion in match dict during matching, reported by David Creemer.
417 * Fixed improper url quoting by using urllib.encode, patch by Jason Culverhouse.
418
419 Release 1.3.1 (April 4th, 2006)
420 ===============================
421 * Mapper has an optional attribute ``append_slash``. When set to ``True``, any URL's
422 generated will have a slash appended to the end.
423 * Fixed prefix option so that if the PATH_INFO is empty after prefix regexp, its set to
424 '/' so the match proceeds ok.
425 * Fixed prefix bug that caused routes after the initial one to not see the proper url
426 for matching. Caught by Jochen Kupperschmidt.
427
428 Release 1.3 (Feb. 25th, 2006)
429 =============================
430 * url_for keyword filters:
431 Named routes can now have a _filter argument that should specify a function that takes
432 a dict as its sole argument. The dict will contain the full set of keywords passed to
433 url_for, which the function can then modify as it pleases. The new dict will then be
434 used as if it was the original set of keyword args given to url_for.
435 * Fixed Python 2.3 incompatibility due to using keyword arg for a sort statement
436 when using the built-in controller scanner.
437
438 Release 1.2 (Feb. 17th, 2006)
439 =============================
440 * If a named route doesn't exist, and a url_for call is used, instead of using the
441 keyword arguments to generate a URL, they will be used as query args for the raw
442 URL supplied. (Backwards Incompatible)
443 * If Mapper has debug=True, using match will return two additional values, the route
444 that matched, if one did match. And a list of routes that were tried, and information
445 about why they didn't pass.
446 * url_for enhancements:
447 Can now be used with 'raw' URL's to generate proper url's for static content that
448 will then automatically include SCRIPT_NAME if necessary
449 Static named routes can now be used to shortcut common path information as desired.
450 * Controller Scanner will now sort controller names so that the longest one is first. This
451 ensures that the deepest nested controller is executed first before more shallow ones to
452 increase predictability.
453 * Controller Scanner now scans directories properly, the version in 1.1 left off the
454 directory prefix when created the list of controllers.
455 (Thanks to Justin for drawing my attention to it)
456
457 Release 1.1 (Jan. 13th, 2006)
458 =============================
459 * Routes Mapper additions:
460 Now takes several optional arguments that determine how it will
461 generate the regexp's.
462 Can now hold a function for use when determining what the available
463 controllers are. Comes with a default directory scanner
464 Given a directory for the default scanner or a function, the Mapper
465 will now automatically run it to get the controller list when needed
466 * Syntax available for splitting routes to allow more complex route paths, such
467 as ':controller/:(action)-:(id).html'
468 * Easier setup/integration with Routes per request. Setting the environ in a
469 WSGI environ will run match, and setup everything needed for url_for/etc.
470
471 Release 1.0.2 (Dec. 30th, 2005)
472 ===============================
473 * Routes where a default was present but None were filling in improper values.
474 * Passing a 0 would evaluate to None during generation, resulting in missing
475 URL parts
476
477 Release 1.0.1 (Dec. 18th, 2005)
478 ===============================
479 * Request Local Callable - You can now designate your own callable function that
480 should then be used to store the request_config data. This is most useful for
481 environments where its possible multiple requests might be running in a single
482 thread. The callable should return a request specific object for attributes to
483 be attached. See routes.__init__.py for more information.
484
485 Release 1.0 (Nov. 21st, 2005)
486 =============================
487 * routes.__init__ will now load the common symbols most people will
488 want to actually use.
489 Thus, you can either::
490
491 from routes import *
492
493 Or::
494
495 from routes import request_config, Mapper
496
497 The following names are available for importing from routes::
498
499 request_config, Mapper, url_for, redirect_to
500
501 * Route Names - You can now name a route, which will save a copy of the defaults
502 defined for later use by url_for or redirect_to.
503 Thus, a route and url_for looking like this::
504
505 m.connect('home', controller='blog', action='splash')
506 url_for(controller='blog', action='splash') # => /home
507
508 Can now be used with a name::
509
510 m.connect('home_url','home', controller='blog', action='splash')
511 url_for('home_url') # => /home
512
513 Additional keywords can still be added to url_for and will override defaults in
514 the named route.
515 * Trailing / - Route recognition earlier failed on trailing slashes, not really a bug,
516 not really a feature I guess. Anyways, trailing slashes are o.k. now as in the Rails
517 version.
518 * redirect_to now has two sets of tests to ensure it works properly
519
520