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

Create basic files and directories for pip-dist enabled Python apps.

Project Description

PipApp creates directories and files for Pip-distributable Python application.

Inspired by no-nonsense blog post about Python application distribution (https://gehrcke.de/2014/02/distributing-a-python-command-line-application/).

Requirements

Python 3.

Install

Install latest version: pip install pipapp.

Usage

Execute

pipapp [PROJECTNAME]

and basic set of files and directories (as descibed in no-nonsense blog post) are automagically created in ./PROJECTNAME directory. The main source file is PROJECTNAME.py in ./PROJECTNAME/PROJECTNAME directory. PipApp is not used after initial creation of directories and files, so you can go ahead and develop, register with PyPi and upload the application to PyPi.

If current directory is not good, you can specify directory where to create files and dirs:

-d DIR, --dir DIR  Root directory where to create new project files and dirs. Default is current directory.

For example, if you execute pipapp hobbyproject, you get following directories and files in your current directory:

hobbyproject/
├── CHANGES
├── hobbyproject
│   ├── __init__.py
│   ├── __main__.py
│   └── hobbyproject.py
├── hobbyproject-runner.py
├── LICENSE
├── MANIFEST.in
├── README.rst
├── setup.cfg
└── setup.py

When first executing the script a file $HOME/.pipapp_defaults is created. The file includes some configuration items such as author name and email and set of classifiers to be used in generated setup.py.

About

PipApp is meant to give quick start to develop pip-distributable Python applications by providing basic set of files and directories. Currently basic set is enough and if you need more professional style of working, please see https://www.jeffknupp.com/blog/2013/08/16/open-sourcing-a-python-project-the-right-way/.

Release History

Release History

This version
History Node

0.4

History Node

0.3

History Node

0.2

History Node

0.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pipapp-0.4.tar.gz (5.5 kB) Copy SHA256 Checksum SHA256 Source Jun 13, 2016

Supported By

WebFaction WebFaction Technical Writing 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 Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting