Javascript url handling for Django that doesn't hurt.
Project description
Javascript url handling for Django that doesn’t hurt.
Overview
Django JS Reverse is a small django app that makes url handling of named urls in javascript easy and non-annoying..
For example you can retrieve a named url:
urls.py:
url(r'^/betterliving/(?P<category_slug>[-\w]+)/(?P<entry_pk>\d+)/$', 'get_house', name='betterliving_get_house'),
in javascript like:
Urls.betterlivingGetHouse('house', 12)
Result:
/betterliving/house/12/
Requirements
Python version |
Django versions |
---|---|
3.10 3.9 3.8 |
4.1, 4.0, 3.2, 3.1, 3.0, 2.2, 2.1, 2.0, 1.11, 1.10, 1.9, 1.8 4.1, 4.0, 3.2, 3.1, 3.0, 2.2, 2.1, 2.0, 1.11, 1.10, 1.9, 1.8 4.1, 4.0, 3.2, 3.1, 3.0, 2.2, 2.1, 2.0, 1.11, 1.10, 1.9, 1.8 |
3.7 |
2.2, 2.1, 2.0, 1.11, 1.10, 1.9, 1.8 |
3.6 |
2.2, 2.1, 2.0, 1.11, 1.10, 1.9, 1.8 |
3.5 |
2.2, 2.1, 2.0, 1.11, 1.10, 1.9, 1.8 |
3.4 |
2.0, 1.11, 1.10, 1.9, 1.8, 1.7, 1.6, 1.5 |
2.7 |
1.11, 1.10, 1.9, 1.8, 1.7, 1.6, 1.5 |
Installation
Install using pip …
pip install django-js-reverse
… or clone the project from github.
git clone https://github.com/ierror/django-js-reverse.git
Add 'django_js_reverse' to your INSTALLED_APPS setting.
INSTALLED_APPS = ( ... 'django_js_reverse', )
Usage with webpack
Install using npm
npm install --save django-js-reverse
Include none-cached view …
urlpatterns = patterns('', url(r'^jsreverse.json$', 'django_js_reverse.views.urls_json', name='js_reverse'), )
… or a cached one that delivers the urls JSON
from django_js_reverse import views urlpatterns = patterns('', url(r'^jsreverse.json$', cache_page(3600)(views.urls_json), name='js_reverse'), )
Include JavaScript in your bundle:
// utils/djangoReverse.mjs import _ from 'lodash/fp'; import djangoJsReverse from 'django-js-reverse'; export default _.once( async () => { const res = await fetch('/jsreverse.json'); const data = await res.json(); return djangoJsReverse(data); } )
// somePlace.mjs import djangoReverse from './utils/djangoReverse'; (async () => { const urls = await djangoReverse(); const url = urls.someViewName('some-arg'); ... })();
Usage as static file
First generate static file by
./manage.py collectstatic_js_reverse
If you change some urls or add an app and want to update the reverse.js file, run the command again.
After this add the file to your template
<script src="{% static 'django_js_reverse/js/reverse.js' %}"></script>
Usage with views
Include none-cached view …
urlpatterns = patterns('', url(r'^jsreverse/$', 'django_js_reverse.views.urls_js', name='js_reverse'), )
… or a cached one that delivers the urls javascript
from django_js_reverse.views import urls_js urlpatterns = patterns('', url(r'^jsreverse/$', cache_page(3600)(urls_js), name='js_reverse'), )
Include javascript in your template
<script src="{% url js_reverse %}" type="text/javascript"></script>
or, if you are using Django > 1.5
<script src="{% url 'js_reverse' %}" type="text/javascript"></script>
Usage as template tag
You can place the js_reverse JavaScript inline into your templates, however use of inline JavaScript is not recommended, because it will make it impossible to deploy a secure Content Security Policy. See django-csp
{% load js_reverse %} <script type="text/javascript" charset="utf-8"> {% js_reverse_inline %} </script>
Use the urls in javascript
If your url names are valid javascript identifiers ([$A-Z_][-Z_$]*)i you can access them by the Dot notation:
Urls.betterlivingGetHouse('house', 12)
If the named url contains invalid identifiers use the Square bracket notation instead:
Urls['betterliving-get-house']('house', 12) Urls['namespace:betterliving-get-house']('house', 12)
You can also pass javascript objects to match keyword aguments like the examples bellow:
Urls['betterliving-get-house']({ category_slug: 'house', entry_pk: 12 }) Urls['namespace:betterliving-get-house']({ category_slug: 'house', entry_pk: 12 })
Options
Optionally, you can overwrite the default javascript variable ‘Urls’ used to access the named urls by django setting
JS_REVERSE_JS_VAR_NAME = 'Urls'
Optionally, you can change the name of the global object the javascript variable
used to access the named urls is attached to. Default is this
JS_REVERSE_JS_GLOBAL_OBJECT_NAME = 'window'
Optionally, you can disable the minfication of the generated javascript file by django setting
JS_REVERSE_JS_MINIFY = False
By default all namespaces are included
JS_REVERSE_EXCLUDE_NAMESPACES = []
To exclude any namespaces from the generated javascript file, add them to the JS_REVERSE_EXCLUDE_NAMESPACES setting
JS_REVERSE_EXCLUDE_NAMESPACES = ['admin', 'djdt', ...]
If you want to include only specific namespaces add them to the JS_REVERSE_INCLUDE_ONLY_NAMESPACES setting tips: * Use “” (empty string) for urls without namespace * Use “foo0” to include urls just from “foo” namaspace and not from any subnamespaces (e.g. “foo:bar”)
JS_REVERSE_INCLUDE_ONLY_NAMESPACES = ['poll', 'calendar', ...]
If you run your application under a subpath, the collectstatic_js_reverse needs to take care of this. Define the prefix in your django settings:
JS_REVERSE_SCRIPT_PREFIX = '/myprefix/'
By default collectstatic_js_reverse writes its output (reverse.js) to your project’s STATIC_ROOT. You can change the output path:
JS_REVERSE_OUTPUT_PATH = 'some_path'
Running the test suite
tox
License
Contact
Enjoy!
0.10.1b1 (unreleased)
Update for Django 4.0 and 4.1, Python 3.8, 3.9, 3.10
0.10.1a1 (unreleased)
Update pypi deploy username and token
0.10.1a (2019-08-02)
support webpack and other bundlers
0.10.0 (2019-08-01)
deprecate django_js_reverse.VERSION. It will now always be (0, 9, 2)
deprecate js_reverse_inline
use setuptools.setup
0.9.1
Fix: avoid XSS introduced in 0.9.0 when using js_reverse_inline. A low threat as content injected is likely to be trusted input from the urlconfig.
0.9.0
New: Support for Python 3.7
New: Support for Django 2.2
New: Unit Tests Script prefix with no slash, changed URL Conf`#72 <https://github.com/ierror/django-js-reverse/issues/72>`__ Thank you graingert
Fix: “ROOT_URLCONF not taken into account” #73 #74 Thank you LuukOost and graingert
Refactoring: “move template logic to view” #64 Thank you graingert
Fix: “Now using LooseVersion instead of StrictVersion to avoid issues with rc releases” #67 Thank you kavdev
0.8.2
0.8.1
Fix: The tests folder of the #53 was still present in the build. => Added cleanup to the release make command.
0.8.0
0.7.3
New: Support for Django 1.10
Chg: Renamed “production” branch to “master”
Fix: #48 - “Change False to ‘window’ in global object name in README.” Thank you karamanolev
Fix: PR #45 - “Fix: collectstatic_js_reverse usage message” Thank you ghedsouza
Fix: PR #44 - “Remove duplicate _get_url call” Thank you razh
0.7.2
Fix: #42 - “Templatetag js_reverse_inline breaks on Django 1.9” Thank you tommikaikkonen
Optimized imports
0.7.1
Fix: #41 - make it possible to use number 0 as url argument
0.7.0
New: By default collectstatic_js_reverse writes its output (reverse.js) to your project’s STATIC_ROOT. Now You can change settings: JS_REVERSE_OUTPUT_PATH Thank you mjnaderi
New: Support for Django 1.9 Thank you mjnaderi
New: It’s now possible to include specific namespaces only. See JS_REVERSE_INCLUDE_ONLY_NAMESPACES setting for details. Thank you BrnoPCmaniak
0.6.1
Refactored: Separate the view functionality from the JS generation
New: Replaced slimit by rjsmin based on #33 Thank you chripede
0.6.0
0.5.1
Fix: Current ply breaks slimit => force ply==3.4
0.5.0
New: Django allows you to have multiple URL patterns with the same name.
This release adds support for the featuer. Thank you defrex
New: Test support for django 1.8
New: test for script_prefix without ending slash
0.4.6
New: You can change the name (default=this) of the global object the javascript variable used to access the named urls is attached to by changing JS_REVERSE_JS_GLOBAL_OBJECT_NAME setting. Thank you aumo
0.4.5
Fix: If you run your application under a subpath, the collectstatic_js_reverse needs to take care of this. You can now define a setting JS_REVERSE_SCRIPT_PREFIX that handles this issue. Thank you lizter for reporting the issue
0.4.4
Improvement: management command collectstatic_js_reverse throws an error if settings.STATIC_ROOT is not set
Tests: exluded a debug print from coverage
Removed: support for django 1.4
New: Templatetag to include js-reverse-js inline in your templates
0.4.3
New: Add better support for django rest framework Django rest framework generates url names like user-list, so it get’s converted now as well so Urls['user-list']() or the cleaner Urls.user_list() are both usable.
Fix: JSReverseStaticFileSaveTest is working and being tested again
Improvement: Cleanup Javascript Thank you bulv1ne for the pull request
New: Test support for the latest pypy versions pypy3-2.4.0 and pypy-2.5.0
Fix: Get rid of test warning “MIDDLEWARE_CLASSES is not set.” for Django >= 1.7
0.4.2
Provided PyPI wheel Package
0.4.1
Fix: collectstatic runner: moved to own management command collectstatic_js_reverse
0.4.0
Add ability to save in file:
<script src="{% static 'django_js_reverse/js/reverse.js' %}"></script>``
to do this run ./manage.py collectstatic
Add JS_REVERSE_EXCLUDE_NAMESPACES option to exclude namespaces from import default is []
To exclude e.g. admin and Django Debug Toolbar:
JS_REVERSE_EXCLUDE_NAMESPACES = ['admin', 'djdt']
Thank you Andertaker
0.3.4
New: Support for nested namespaces. Thank you hyperair
New: Support for arguments within namespace path. Thank you hyperair
New: Support for optional url arguments. Thank you hyperair
0.3.3
New: Django 1.7 support
0.3.2
New: Default minification of the generated javascript file
Fix: content type of the jsreverse script. Thank you @emcsween
Testing: Use selenium for better testing
0.3.1
Added support for namespaces
0.3.0
Test support for pypy, python 3.4, django 1.6
Refactored include of JS_REVERSE_JS_VAR_NAME js var name
Get rid of “DeprecationWarning: The mimetype keyword argument is depracated, use content_type instead”
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-js-reverse-swh-0.10.1b1.dev0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e153b18549775ed7773ee254498fa6aadbbaac48603ee5c793d4b0fb8ffd1f8d |
|
MD5 | 12c3bf4d4cac3ed4cab7a61d37c26626 |
|
BLAKE2b-256 | 71f667fc97a675b47d7304927f79cc19dfad485a812dc6828d3f4d1d84b2ec4a |
Hashes for django_js_reverse_swh-0.10.1b1.dev0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fa823dc6e1bd3b2ce3fd2611b80031dfa0db47c36b9e2adf7616c6038edc80da |
|
MD5 | 3e19a8f4b8711c93b96a7de81c139232 |
|
BLAKE2b-256 | 7b58ac1b16f42371ce1664a601ae7fdf866f18f602d00776fb8cb0b925c044c5 |