/django-startproject

Django 1.5 project template with useful features

Primary LanguageCSSMIT LicenseMIT

django-startproject

Project template for the Django Web framework.

Copyright (c) 2013 Marcus R. Brown and Contributors.

The django-startproject project is distributed under the MIT License.

Overview

django-startproject is a Django project template. You use it to create a new Django project that includes a bunch of useful functionality out-of-the-box. The purpose is to consolidate frequently repeated setup and configuration actions into only a few, and to promote rapid app development.

It is originally based on Randall Degges' django-skel project, and contains other features hacked in for use on my own projects and seen in others. I would like to extend it to support different project types via type-specific branches.

Contributions, criticisms, and suggestions are welcome.

Getting Started

Prerequisites

Projects that are created using django-startproject work best within a Python virtualenv environment. Run the following commands from a shell to bootstrap the new project's environment:

mkvirtualenv myproject
pip install -r https://raw.github.com/igetgames/django-startproject/master/requirements/development.txt

After the packages have been installed, create the new project with the following command:

django-admin.py startproject --template=https://github.com/igetgames/django-startproject/zipball/master -n Procfile myproject

Usage

The django-heroku-fabfile project contains a Fabric fabfile that can be used for project configuration and maintenance.

TODO: Document available tasks.

Author

The django-startproject project was created by Marcus R. Brown (@igetgames on Twitter). Send feedback to mrossbrown@gmail.com.

Support via Gittip