Skip to content
A Yeoman generator for Python projects.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app Branch on package_or_module in tasks.py template May 9, 2019
.gitignore Let there be light! Apr 23, 2019
.prettierrc.toml Use Prettier Apr 23, 2019
LICENSE Add license May 1, 2019
README.md Fix installation and use instructions May 18, 2019
package.json v0.2.0 May 9, 2019

README.md

generator-python

A Yeoman generator for a Python 3 package with docs, lint, tests, and continuous integration.

npm code style: Prettier

Preview

Take a look at the sample project built with this generator. It is tested on Travis CI and published on PyPI with documentation on Read the Docs.

Install

This generator assumes you are using Poetry for managing Python packages. It will use whatever Python version is activated in your environment. I recommend using pyenv to manage different versions of Python.

# Required
$ curl -sSL https://raw.githubusercontent.com/sdispater/poetry/master/get-poetry.py | python
$ yarn global add yo @thejohnfreeman/generator-python
# Optional
$ curl https://pyenv.run | bash

Use

From within your project directory:

$ pyenv local 3.6-dev
$ yo @thejohnfreeman/python

Options

Although there are some parameters to this generator, such as the package name and author, there are no optional pieces. Instead, I recommend you include every generated file in your first commit, then delete the files you don't want in your second commit, and go from there. That way, if you ever change your mind later, you can resurrect the file that was generated for you, not by re-running the generator and potentially overwriting other files, but by asking Git for the version you deleted:

$ git checkout $(git rev-list -1 HEAD -- "$file")^ -- "$file"
Option Type Description
project_name string The project name. The project namespace is distinct from the package namespace. Think GitHub and Read the Docs, where your project coexists with projects from other language ecosystems. Default is the name of the current directory.
package_or_module "package"
"module"
Whether this will be a package (directory) or module (single file).
package_name string The package (or module) name, i.e. the name your users will import.This will be the name of your PyPI package, too, but if that name is already taken, you will need to change it in pyproject.toml and README.rst. Default is the project name sanitized to a Python identifier.
version string The first version string. Default is 0.1.0.
author string The author name. Default comes from your Git configuration. This generator assumes a single author. If you need to add more, add them after the generator finishes.
email string The author email. Default comes from your Git configuration.
repository string The repository URL. Default is the project name within your namespace on github.com.
python "3.6‑dev"
"3.7‑dev"
"3.8‑dev"
The minimum supported version of Python. Default is 3.6-dev.

Why not Cookiecutter?

I explain my reasons on my blog.

You can’t perform that action at this time.