Skip to main content

Creates a new python package from basic template

Project description

# Pypkg Generator
> Create a simple template of a python package.

[![PyPI version](](

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

## Installation

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/

## Meta

Daniel Omar Vergara Pérez – [@dan1_net]( –


## Contributing

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.2.tar.gz (4.3 kB view hashes)

Uploaded source

Built Distribution

pypkg_generator-0.4.2-py3-none-any.whl (7.5 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