Skip to main content

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/.

Project details


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
pipapp-0.4.tar.gz (5.5 kB) Copy SHA256 hash SHA256 Source None Jun 13, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page