Skip to main content

Creates a new python package from basic template

Project description

Pypkg Generator

Create a simple template of a python package.

Create a basic template of python package with a simple command line tool.


OS X & Linux:


$ pip3 install pypkg-generator

from the source

$ git clone
$ cd pypkg-generator
$ python3 install

Usage example

Open a terminal and type:

$ pkg-generator --help

And it'll display:

  -n, --name TEXT       The name of the package
  -p, --path TEXT       The path where the package will be created
  --tests / --no-tests  Create test suite directory or not, created by default
  --help                Show this message and exit.

There are many options for customization, you can decide what file will be created or not.

You must assign a name, or the project will be name forgotten_name.

$ pkg-generator --name my-awesome-project

You can explicitly pass a path, otherwise, the project will be created in the current directory.

$ pkg-generator --name my-awesome-project --path /home/user/Documents/

Development setup

This project uses pipenv for dependecy resolution. It's a kind of mix between pip and virtualenv. Follow the next instructions to setup the development enviroment.

$ git clone
$ cd pypkg-generator
$ pipenv shell
$ pip3 install -e .

To run the test-suite, inside the pypkg-generator directory:

$ pytest -vv test/


Daniel Omar Vergara Pérez –


  1. Fork it (
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Commit your changes (git commit -am 'Add some fooBar')
  4. Push to the branch (git push origin feature/fooBar)
  5. Create a new Pull Request

Project details

Download files

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

Source Distribution

pypkg-generator-0.4.0.tar.gz (4.6 kB view hashes)

Uploaded source

Built Distribution

pypkg_generator-0.4.0-py3-none-any.whl (6.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page