The new router logic in the trunk is looking fairly stable now, and needs feedback.
See the comments in router.example.py for summary documentation (reproduced below), and ask here if you have questions. The simplest possible router is: routers = dict() This sets all the defaults (including default_application=init). The next most simple router: routers = dict( BASE = dict(default_application = 'myapp') ) Either of those will perform component removal from outgoing URLs. If 'myapp' needs to override specific routing parameters, you'll do something like this: routers = dict( BASE = dict(default_application = 'myapp'), myapp = dict(default_controller = 'defcon') ) To use the new language facility (URLs like /a/pt-br/c/f/...), you'll need to do something like this early in your model: if request.uri_language: T.force(request.uri_language) This is not tested, and it'd be great if someone could give it a shot. Notice that with language translation, static files are served preferentially from language-specific subdirectories. applications/appname/static/pt-br/... If the incoming URL for a static file is tagged pt-br, we look first in static/pt-br/ and then in static/, so it's not necessary to duplicate files that don't need translation. If you're already using routes.py, just add a routers=dict(... entry, and it will be used preferentially; you shouldn't have to remove your regex-based rewrites. Feedback, please. # routers are dictionaries of URL routing parameters. # # For each request, the effective router is: # the built-in default base router (shown below), # updated by the BASE router in routes.py routers, # updated by the app-specific router in routes.py routers, # updated by the app-specific router from applcations/app/routes.py routers (if any) # # # Router members: # # default_application: default application name # applications: list of all recognized applications, or 'ALL' to use all currently installed applications # Names in applications are always treated as an application names when they appear first in an incoming URL. # Set applications to [] to disable the removal of application names from outgoing URLs. # domains: dict used to map domain names to application names # default_controller: name of default controller # default_function: name of default function (all controllers) # root_static: list of static files accessed from root # (mapped to the selected application's static/ directory) # domain: the domain that maps to this application (alternative to using domains in the base router) # languages: list of all supported languages # Names in controllers are always treated as language names when they appear in an incoming URL after # the (optional) application name. # controllers: list of valid controllers in selected app # or "DEFAULT" to use all controllers in the selected app plus 'static' # or [] to disable controller-name removal. # Names in controllers are always treated as controller names when they appear in an incoming URL after # the (optional) application and language names. # default_language # The language code (for example: en, it-it) optionally appears in the URL following # the application (which may be omitted). For incoming URLs, the code is copied to # request.language; for outgoing URLs it is taken from request.language. # If languages=[], language support is disabled. # The default_language, if any, is omitted from the URL. # check_args: set to False to suppress arg checking # request.raw_args always contains a list of raw args from the URL, not unquoted # request.args are the same values, unquoted # By default (check_args=True), args are required to match args_match. # acfe_match: regex for valid application, controller, function, extension /a/c/f.e # file_match: regex for valid file (used for static file names) # args_match: regex for valid args (see also check_args flag) # # # The built-in default router supplies default values (undefined members are None): # # default_router = dict( # default_application = 'init', # applications = 'ALL', # default_controller = 'default', # controllers = 'DEFAULT', # default_function = 'index', # default_language = None, # languages = [], # root_static = ['favicon.ico', 'robots.txt'], # domains = dict(), # check_args = True, # map_hyphen = True, # acfe_match = r'\w+$', # legal app/ctlr/fcn/ext # file_match = r'(\w+[-=./]?)+$', # legal file (path) name # args_match = r'([\w@ -]+[=.]?)+$', # legal arg in args # ) # # See rewrite.map_url_in() and rewrite.map_url_out() for implementation details.