Mercurial > hg > redirector
comparison README.txt @ 1:55578cf505dd
add some documentation for redirector
| author | Jeff Hammel <k0scist@gmail.com> |
|---|---|
| date | Wed, 10 Mar 2010 10:45:11 -0500 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| 0:af82aaec0377 | 1:55578cf505dd |
|---|---|
| 1 redirector | |
| 2 ========== | |
| 3 | |
| 4 *Control redirects through WSGI middleware.* | |
| 5 | |
| 6 redirector is a piece of WSGI middleware that allows redirects to be | |
| 7 managed within the scope of a python web service. Traditionally, | |
| 8 redirects are done via Apache or some other web server disparate from | |
| 9 the python application. This leads to several undesirable | |
| 10 consequences: | |
| 11 | |
| 12 * there is no way of controlling redirects through the web | |
| 13 * the web server must be restarted when redirects are changed | |
| 14 | |
| 15 Because of this methodology of doing things, it discourages the | |
| 16 stake-holders (the people that actually care about the redirects) from | |
| 17 changing the redirects themselves. Because the redirects are not, in | |
| 18 their mind, content, this leads to unmaintainable systems. The goal | |
| 19 of redirector is to bring the power to create redirects to any | |
| 20 authorized user. | |
| 21 | |
| 22 | |
| 23 Status | |
| 24 ------ | |
| 25 | |
| 26 Redirector is largely in the conceptual stage. While what redirector | |
| 27 does now (regular expression redirects) is sufficient to reproduce | |
| 28 Apache's behavior, it is not enough to realize the vision of bringing | |
| 29 redirects to the people for WSGI apps. | |
| 30 | |
| 31 Even this documentation is thoroughly imcomplete. | |
| 32 | |
| 33 | |
| 34 TODO | |
| 35 ---- | |
| 36 | |
| 37 redirector needs several pieces to become what it should be: | |
| 38 | |
| 39 Types of Redirects | |
| 40 ------------------ | |
| 41 | |
| 42 Currently, only regular expression redirects (a la Apache) are | |
| 43 implemented. Another possibility, probably more applicable, are | |
| 44 something like glob redirects. The reason that these are useful is | |
| 45 that they, with a carefully constructed rule system, can be seen to | |
| 46 match each other. In other words, you can see if the existing set of | |
| 47 redirects is contradictory and if there are superfluous redirects. It | |
| 48 also better matches how non-experts think about redirects. |