Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Python project generator

Project description

sire

sire is a command that generates Python 3.7 project templates, with git, travis, mypy (etc.) support.

Version 1.0.4

Build Status codecov.io readthedocs PyPI version Code style: black

Install sire

pip install sire
#or
git clone https://github.com/interrogator/sire && cd sire && python.setup.py install

Usage

sire --mkdocs --virtualenv --git --exclude=mypy <project_name>

Alternative usages (not recommended)

As Python module:

python -m sire.sire mkdocs virtualenv <project_name>

Or from inside Python (why?):

from sire import sire
sire('project_name', mkdocs=True, virtualenv=True, git=True)

What gets generated

Pure Python:

  • <project_name>/<project_name>.py
  • <project_name>/__init__.py
  • setup.py
  • requirements.txt (with black, isort, flake8 etc)
  • tests/tests.py

Optional extras:

  • mkdocs (.readthedocs.yaml, ./docs, .mkdocs.yml)
  • irtualenv (with dependencies installed)
  • git (.git, .gitignore, .pre-commit-config.yaml)

Each of these has an associated flag:

sire -v/--virtualenv -m/--mkdocs -g/--git projname

Other files

  • .coveragerc
  • .travis.yml
  • publish.sh (a script for running tests and authoring a new version)
  • mypy.ini
  • MIT License
  • Empty CHANGELOG
  • .bumpversion.cfg

If you want to skip any of these files, use the --exclude option with comma separation:

sire --exclude=travis,setup.py,mypy projname

Trivia

  • sire actually generated itself.

Contributing

I don't really expect many other people to want this, because it's mostly tailored to my specific ideas about how a Pthon project should look. That said, if you do find this projet useful, you are more than welcome to submit pull/feature requests!

There are dozens of possible new features that could be added, which I'd personally quite like:

  • a --license option, to choose the correct license file
  • Setting git remote automatically (get github username from git global config?)
  • Deleting irrelevant strings --- if no codecoverage, remove the associated badge for example
  • Probably more code could be automatically generated and added for the main and test .py files

While I'd love to have these in sire, coding them will take me longer than doing it manually a few times. So, unless this repo somehow becomes popular or finds some new contributors, don't expect any of this stuff to get done in a hurry, unless you add it yourself.

Project details


Download files

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

Files for sire, version 1.0.4
Filename, size File type Python version Upload date Hashes
Filename, size sire-1.0.4-py3.6.egg (19.4 kB) File type Egg Python version 3.6 Upload date Hashes View hashes
Filename, size sire-1.0.4.tar.gz (11.5 kB) File type Source Python version None Upload date Hashes View hashes

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 SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page