Skip to main content

Automagic url namespace resolution

Project description

Django supports namespaces that help applications find out their current namespace and refer to themselves in a stable way even if there are more than one instance of the same module in the url patterns.

However, Django does not automatically set the current_app context which means that the app will actually resolve the namespaced urls to the last announced instance of itself.

This context processor digs the detail up and voilá.

Usage

The context processor needs to be added to the template configuration. The rude way to do it is as follows:

TEMPLATES[0]['OPTIONS']['context_processors'].append(
    'namespaced.context_processors.namespaced')

Using a context processor for this use is a bit questionable and generally a middleware would be the correct place to edit requests. However middlewares are executed at a stage where the URL resolution has not been matched and will traverse all URLs even if they are not going to be used. This code is mostly relevant in views anyway.

This enables you to have two separate instances of the same app in two different urls. Normally Django would always refer to the last instance by the app name which will mess up all internal linkage within any of the previous instances. Let’s assume we have this inside an app:

{% url 'myapp:index' %}

To make this work for both instances, the urls.py should look something like this:

urlpatterns = [
    url(r'^first/', include('myapp.urls', namespace='first', app_name='myapp')),
    url(r'^last/', include('myapp.urls', namespace='last', app_name='myapp)),
]

The apps can refer to themselves with myapp:, each other with first: and last:. It will most likely make sense to use the explicit names in the rest of the project.

For now, the use without namespaces has not been tested.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-namespaced, version 1.0.1
Filename, size File type Python version Upload date Hashes
Filename, size django_namespaced-1.0.1-py2-none-any.whl (9.3 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size django_namespaced-1.0.1-py3-none-any.whl (9.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size django-namespaced-1.0.1.tar.gz (18.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page