floof/config/routing.py

   1 """Routes configuration
   2
   3 The more specific and detailed routes should be defined first so they
   4 may take precedent over the more generic routes. For more information
   5 refer to the routes manual at http://routes.groovie.org/docs/
   6 """
   7 from pylons import config
   8 from routes import Mapper
   9
  10 def make_map():
  11     """Create, configure and return the routes Mapper"""
  12     map = Mapper(directory=config['pylons.paths']['controllers'],
  13                  always_scan=config['debug'], explicit=True)
  14     map.minimization = False
  15
  16     # explicit = True disables a broken feature called "route memory",
  17     # where it adds everything matched in the current request as default variables
  18     # for the next one.  This is wrong because it doesn't invalidate things lower down in
  19     # the hierarchy when higher up things change.  Rails port failure.
  20     # NOTE: this also disables actions defaulting to index, sorry.
  21
  22     require_POST = dict(conditions={'method': ['POST']})
  23
  24     # get rid of trailing slashes
  25     map.redirect('/*(url)/', '/{url}',
  26                  _redirect_code='301 Moved Permanently')
  27
  28
  29     # The ErrorController route (handles 404/500 error pages); it should
  30     # likely stay at the top, ensuring it can always be resolved
  31     map.connect('/error/{action}', controller='error')
  32     map.connect('/error/{action}/{id}', controller='error')
  33
  34     map.connect('home', '/', controller='main', action='index')
  35
  36     # Account stuff
  37     with map.submapper(controller="account") as sub:
  38         sub.connect('login',            '/account/login',           action='login')
  39         sub.connect('login_begin',      '/account/login_begin',     action='login_begin', **require_POST)
  40         sub.connect('login_finish',     '/account/login_finish',    action='login_finish')
  41         sub.connect('logout',           '/account/logout',          action='logout', **require_POST)
  42         sub.connect('register',         '/account/register',        action='register')
  43         sub.connect('register_finish',  '/account/register_finish', action='register_finish', **require_POST)
  44
  45     # with map.submapper()
  46     map.connect('/users', controller='users', action='list')
  47     map.connect('user_page', '/users/{name}', controller='users', action='view')
  48
  49     # Comments
  50     with map.submapper(controller='comments') as sub:
  51         sub.connect('/*owner_url/comments', action='thread')
  52         sub.connect('/*owner_url/comments/reply', action='reply')
  53         sub.connect('/*owner_url/comments/reply_done', action='reply_done', **require_POST)
  54         sub.connect('/*owner_url/comments/{id}', action='thread')
  55         sub.connect('/*owner_url/comments/{id}/reply', action='reply')
  56         sub.connect('/*owner_url/comments/{id}/reply_done', action='reply_done', **require_POST)
  57
  58     with map.submapper(controller="art") as sub:
  59         sub.connect('new_art',      '/art/new',         action="new")
  60         sub.connect('create_art',   '/art/create',      action="create")
  61         sub.connect('rate_art',     '/art/{id}/rate',   action="rate")
  62         sub.connect('show_art',     '/art/{id}',        action="show")
  63
  64     with map.submapper(controller='tag') as sub:
  65         sub.connect('delete_tag', '/art/{art_id}/tag/{id}')
  66         sub.connect('create_tag', '/art/{art_id}/tag')
  67
  68     with map.submapper(controller='relation') as sub:
  69         sub.connect('create_relation', '/art/{art_id}/relations/{kind}/create', action="create")
  70         # TODO: conditions: kind = by|for|of|character?
  71
  72     map.resource('tag','tags', controller="tag",
  73         parent_resource=dict(member_name='art', collection_name='art'))
  74         # Yeah, parent resources are specified kinda dumb-ly.  Would be better if you could pass in the
  75         # real parent resource instead of mocking it up with a silly dict.  We should file a feature request.
  76
  77     # I think resources is the right way to go for most things.  It ensures all of our actions have the right
  78     # methods on them, at least.  It does require the use of silly _method="delete" post parameters though.
  79
  80     # One sticking point though is, it'll happily allow you to add any formatting string you want, like art/1.json
  81     # I wonder if there's a way to place requirements on that, or disable it until we actually have formats.
  82     # It just serves the same action as usual but with a format argument in the context.
  83
  84     # map.connect('/art/new', controller='art', action='new')
  85     # map.connect('/art/upload', controller='art', action='upload')
  86     # map.connect('show_art', '/art/{id}', controller='art', action='show')
  87     # map.connect('/art/{id}/tag', controller='art', action='tag')
  88
  89     # map.connect('/tag/{id}/delete', controller='tag', action='delete')
  90
  91     map.connect('search', '/search', controller='search', action='index')
  92     # map.connect( '/search/{query}', controller='search', action='index')
  93     map.connect('saved_searches', '/search/list', controller='search', action='list')
  94
  95
  96     # default routing is back so we can test stuff.
  97     # please don't take it away until we have some more core features in.
  98     map.connect('/{controller}/{action}')
  99     map.connect('/{controller}/{action}/{id}')
 100
 101     return map