The template used for standalone opensource Django apps in Ambition
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

README.rst{{repo_name}}.png{{repo_name}}/badge.png?branch=develop Latest PyPI version Number of PyPI downloads

{# {#

Setup Instructions

To start a new project with this template:

virtualenv env
. ./env/bin/activate
pip install jinja2
python --author-name <Your Name> --author-email --pypi-name pypy-package-name --repo-name github-repo-name --project-name python_project_name --rtd-subdomain my-project
python --help

The script will create all of the necessary folders and scaffolding for an app with project_name. Note that while most will name their projects something like "django-regex-field", the app name is normally a version of that string without "django" and with underscores instead of dashes. For example, "regex_field" would be an appropriate project name. Remember to rename your base folder to be your repo name rather than the project name.

Once the project is copied, it is up to the user to open the file and modify the following args:

  • description: A short summary of the app. Be sure to write a description, otherwise it will show up as UNKNOWN on pypi.
  • keywords: Relevant words associated with your project. Ex: 'api, python, datetime'
  • install_requires: Any required packages

Other things to note:

  • The .travis.yml file installs all necessary testing requirements, such as

flake8, and coverage. Note that it is required that your repo have 100% code coverage (including branches)

Adding the project to Github

Go to and:

  • Create the initial public repository with nothing (i.e. no README, no LICENSE, etc).
  • Put a description.

After the repo has been created, go back to your base folder in your project and type:

rm -rf .git # Remove the project template .git folder
git init
git add .
git commit -m 'Project scaffolding'
git remote add origin
git push -u origin master

Please make a "develop" branch of the main project on Github and set "develop" as the default branch after it has been pushed.

Add Documentation

Some project scaffolding documentation has been added for you, but you will need to add docstrings to your functions, classes, and methods yourself. A basic example has been added in docs/ref/project_name, but you'll have to manually tweak that yourself.

Don't forget to add a github webhook to ReadTheDocs so the documentaion is automatically updated on each build.

Python Versions

This project automatically has travisci build for python 2.7, and 3.4.d

Register on pypi

To register the project before you make an initial release, run:

python register


{{ repo_name }}

{# Please put your description here #} I have failed to provide a good README.rst in my project, and you should shun me if I do any pull requests


To install the latest release, type:

pip install {{ pypi_name }}

To install the latest code directly from source, type:

pip install git+git://{{ repo_name }}.git


Full documentation is available at http://{{ rtd_subdomain }}


MIT License (see LICENSE)