generator-daburupy-click

daburupy-click a Yeoman generator for a basic python command-line project using Click that includes pytest, Sphinx, a Makefile and a few other standard pieces to get your project going.

If you haven't used yeoman templates before, take a look at the Getting Started with Yeoman article on the project page.

Get ready, get set...

Install npm

If you haven't already installed npm, you'll need to do that first.

One pretty easy way to install npm and node is with nvm. If you want to go this route, use curl to kick off the install script:

curl https://raw.githubusercontent.com/creationix/nvm/v0.33.8/install.sh | bash

At the time of this writing, 0.3.88 was the current version, but it may well have changed since then. Go to the Github project page to find the latest release.

After installing, you'll need to close and reopen your terminal, or run the following command:

source ~/.bashrc

You can then verify that nvm installed correctly by running the following command:

nvm --version

Lastly, just install node.

nvm install node

Install yeoman

If you haven't already installed Yeoman, perform the following steps:

npm install -g yo

Install bower

If you haven't already installed Bower, perform the following steps:

npm install -g bower

Install the daburupy-click Generator

npm install -g generator-daburupy-click

Create Your Project

From a command prompt go into the directory in which you'd love to start your new python project and execute the template generator.

cd /my/target/directory
yo daburupy-click

The generator will ask you a few questions and, based on your answers, generate your new project.

Next Steps

Once the project skeleton has been generated, you can use the Makefile to create your virtual environment.

make venv

Now that you have a virtual environment, go ahead and activate it.

source venv/bin/activate

At this point, you can install the project's required modules, run the example test and generate the project's Sphinx documentation.

make install
make test
make docs

Build and Run the Application

This template includes some starter code for your Click application, and you should be able to build and run it at this point.

To install the application into your virtual environment, you can use the Makefile.

make build

At this point, you should have an executable that is the same as your project's name. To verify it's good to go, run it with the --help flag.

<my-project-name> --help

Start Coding

If everything else went well, you can start coding your project.