Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

No project description provided.

Project Description

Docs can be found in the docs folder.

App Template

This is a bare-bones skeleton app template, for use with the startapp command.

You will need git, python 2.7+ and pip to create a new app with this template.

Create environment variables for the app and module name (e.g. django-foo-bar and foo_bar), so we can use them in subsequent commands:

$ export APP=<app_name>
$ export MODULE=<module_name>

Install or upgrade Django:

$ pip install -U Django

Create an app from the template:

$ mkdir $APP
$ startapp -e ini,md,yml -n .coveragerc \
--template= \

Make the file executable, for convenience:

$ cd $APP
$ chmod 755

Create a remote repository on GitHub, then initialise a local repository and push an initial commit:

$ git init
$ git add -A
$ git commit -m 'Initial commit.'
$ git remote add origin$APP.git
$ git push

Now, get to work on your app! You might want to start with:

  • Add a LICENSE.txt file (e.g. MIT).
  • Read the contributing docs.
  • Update the docs (e.g. overview, installation and usage).
  • Remove the App Template section (these instructions) from (this file).

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(23.1 kB) Copy SHA256 Hash SHA256
Wheel 2.7 Aug 13, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting