Added content to readme
This commit is contained in:
parent
f42769d229
commit
72110c25c9
1 changed files with 35 additions and 1 deletions
36
README.md
36
README.md
|
@ -1,2 +1,36 @@
|
|||
# django-client-reverse [![Circle CI](https://circleci.com/gh/RealOrangeOne/django-client-reverse.svg?style=svg)](https://circleci.com/gh/RealOrangeOne/django-client-reverse)
|
||||
Django module to access URL reversing
|
||||
Django server component for accessing URL reversing on the client.
|
||||
|
||||
##### Why?
|
||||
The django templating system is great, especially the [URL reversing template tag](). The problem is that most modern web apps have a large amount of their logic inside files outside of the templates, such as javascript files. This means that URLs can no longer be generated by reverse lookup. This is where _django-client-reverse_ steps in!
|
||||
|
||||
This module allows access to the reversing functions, from the client, outside of the project template! Simply send an extra request to the URL you set up, and the reversed URL will be returned. Support for both `args` and `kwargs`!
|
||||
|
||||
## Installation
|
||||
Installation can be done using pip, eventually.
|
||||
|
||||
## Setup
|
||||
Once installed, add the package to your `INSTALLED_APPS` at any point after the django core apps.
|
||||
|
||||
INSTALLED_APPS = {
|
||||
...
|
||||
'django-client-reverse',
|
||||
...
|
||||
}
|
||||
|
||||
Next, setup the URL for your endpoint in any `urls.py` file. Both the url regex and the namespace are not important, anything can be used.
|
||||
|
||||
from django_client_reverse import urls as reverse_urls
|
||||
urlpatterns = [
|
||||
url(r'^reverse/$', include(reverse_urls, namespace="reverser")),
|
||||
]
|
||||
Thats it!
|
||||
|
||||
## Usage
|
||||
Just send a `POST` request to the URL you setup, and the reversed URL will be returned.
|
||||
#### Params:
|
||||
- __ident__: The reverse string, using standard django syntax.
|
||||
- __args__ (optional): arguements for the reverse.
|
||||
- __kwargs__ (optional): Key word arguements for the reverse.
|
||||
|
||||
__Note__: If a reverse cannot be found, then status `404` is returned.
|
||||
|
|
Reference in a new issue