https://github.com/dwighthubbard/django-easy-app
https://github.com/dwighthubbard/django-easy-app
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dwighthubbard/django-easy-app
- Owner: dwighthubbard
- License: bsd-3-clause
- Created: 2015-04-12T13:54:45.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2015-05-01T18:52:21.000Z (about 10 years ago)
- Last Synced: 2025-01-12T19:48:09.019Z (5 months ago)
- Language: Python
- Size: 234 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
django-easy-app
***************
This is a django app that trys to simplify using django. Currently
it has features that do the following:
* An *easy_app* script that allows for creating new django projects
that are set up with the djang0-easy-app functionality.
* A django-easy-app django app has the following functionality
that simplify using django.
* The ability to specify the url routing using a new "route"
attribute on django class based view classes. This akes it
possible to write and use class based views without needing
to understand regular expressions and seperately update the
urls.py.
* Adds a *starteasyapp* command to manage.py to allow for easily
creating additional django-easy-app enabled django apps.
Quickstart
==========
Here are some steps for getting things going
Install django-easy-app
-----------------------
Install using pip as follows::
pip install django-easy-app
Set up a new django project
---------------------------
Create a new python project using the django_easy command like this::
django_easy startproject project_name app_name
Example::
$ django_easy startproject foo_project foo
Creating easyapp named: foo
$ tree foo_project
foo_project
├── foo
│ ├── admin.py
│ ├── __init__.py
│ ├── migrations
│ │ └── __init__.py
│ ├── models.py
│ ├── tests.py
│ ├── urls.py
│ └── views.py
├── foo_project
│ ├── __init__.py
│ ├── __init__.pyc
│ ├── settings.py
│ ├── settings.pyc
│ ├── urls.py
│ └── wsgi.py
└── manage.py
3 directories, 14 files
Create views
------------
In the views.py file define a variable named "easydjango" and set the value
to true.
Make sure each view that should be accessible from the web has a `*route*`
attribute that contains the part of the url that should be associated with the
view. This should not include any other part of the url.
So for example foo_app.view.ExampleView below has a route value of `''` (empty
string) which will cause it to be accessible at
http://hostname:portnumber/appname/classroute/ for the project created in the
previous example. The URL when running runserver
would be http://localhost:8000/foo_app/
.. code-block:: python
from django.http import HttpResponse
from django.views.generic import View
easydjango = True
class NameView(View):
route = ''
def get(self, request):
name = request.GET.get('name', 'World!')
return HttpResponse('Hello %s' % name)
.. image:: docs/images/no_args.png
:scale: 50
:alt: View without arguments
.. image:: docs/images/with_args.png
:scale: 50
:alt: View passing a name argument