Без ссылочной целостности любой веб проект не представляет интереса. Раньше ссылки вбивались в код как есть. Потом в обиход вошел термин url reverse. Подход простой: функция (например url_for) принимала строку — имя url и параметры, требуемые для корректного построения адреса, на выходе получается строка url. Таким образом, в проекте можно переименовывать адреса ресурсов не теряя ссылочную целостность. Такой подход применяется в werkzeug, django, pyramid (+1), rails (2.3 paths and urls, 3.6 naming routes) и др.

Для примера возьмем следующее приложение написанное при помощи библиотеки insanities.

from insanities import web
import views

ns = web.namespace

app = web.cases(
  web.match('/', 'index') | views.index,
  web.prefix('/docs') | ns('docs') | web.cases(
    web.match('') | views.docs,
    web.match('/new', 'new') | views.new_doc,
    web.prefix('/<int:doc_id>') | ns('item') | view.get_doc | web.cases(
      web.match('') | views.show_doc,
      web.match('/update', 'update') | views.update_doc,
      web.match('/delete', 'delete') | views.delete_doc,
    )
  )
)

url_for = web.Reverse.from_handler(app)

url_for('index')                      # '/'
url_for('docs')                       # '/docs'
url_for('docs.new')                   # '/docs/new'
url_for('docs.item', doc_id=1)        # '/docs/1'
url_for('docs.item.update', doc_id=1) # '/docs/1/update'
url_for('docs.item.delete', doc_id=1) # '/docs/1/delete'

Тут все просто. url строится по названию адреса (второй атрибут web.match) с учетом web.namespace. Но что, если надо реализовать ресурс “события”? А еще опубликовать этот ресурс в нескольких местах? Прикинем следующую функцию-фабрику. (Пример не очень хорош)

from insanities import web
import views

ns = web.namespace

def event_factory():
  return web.cases(
    web.match('') | views.events,
    web.match('/new', 'new') | views.new_event,
    web.prefix('/<int:event_id>') | ns('item') | views.get_event | web.cases(
      web.match('') | views.show_event,
      web.match('/update', 'update') | views.update_event,
      web.match('/delete', 'delete') | views.delete_event,
    )
  )

И пристроим ее в двух разных местах нашего приложения

...

app = web.cases(
  web.match('/', 'index') | views.index,
  web.prefix('/docs') | ns('docs') | web.cases(
    web.match('') | views.docs,
    web.match('/new', 'new') | views.new_doc,
    web.prefix('/<int:doc_id>') | ns('item') | view.get_doc | web.cases(
      web.match('') | views.show_doc,
      web.match('/update', 'update') | views.update_doc,
      web.match('/delete', 'delete') | views.delete_doc,
      web.prefix('/events') | ns('events') | event_factory(),
    )
  ),
  web.prefix('/events') | ns('events') | event_factory(),
)

С учетом всего написаного url_for будет работать так

...
url_for = web.Reverse.from_handler(app)

url_for('docs.item.events', doc_id=1)                         # '/docs/1/events'
url_for('docs.item.events.item', doc_id=1, event_id=1)        # '/docs/1/events/1'
url_for('docs.item.events.item.update', doc_id=1, event_id=1) # '/docs/1/events/1/update'
url_for('events')                                             # '/events'
url_for('events.item', event_id=1)                            # '/events/1'
url_for('events.item.update', event_id=1)                     # '/events/1/update'

Проблема заключается в следующем: наверняка, в views.show_event надо будет дать ссылку на обновление или удаление данного элемента. На момент вызова учитывается текущий namespace и можно делать url относительно его. Напиример если мы попали в views.show_event с namespace равеным ‘events’.

url_for('.')                          # '/events'
url_for('.item', event_id=1)          # '/events/1'
url_for('.item.update', event_id=1)   # '/events/1/update'

Но в случае с ‘docs.item.events’ такой трюк не пройдет, т.к. для построения url нужен так же и doc_id (по правде говоря, он попадает во views.show_event).

Как удобнее решать такие ситуации — не знаю. Можно использовать предопределенный url reverse объект.

url_for.events()                         # '/events'
url_for.events.item(event_id=1)          # '/events/1'
url_for.events.item.update(event_id=1)   # '/events/1/update'

url_for.docs.item.events(doc_id=1)          # '/docs/1/events'

predefined = url_for.docs.item(doc_id=1)
predefined.events()                         # '/docs/1/events'
predefined.events.item(event_id=1)          # '/docs/1/events/1'
predefined.events.item.update(event_id=1)   # '/docs/1/events/1/update'

Т.е. url_for атрибуты которого возвращают новый объект url_for частично заполненный. Синтаксис приведенный выше — неоднозначен. Жду предложений по этому поводу.