python-everywhere 0.1.0

A template project for Python

This is a sample to help you with integrating services into your Python project !

Inspired by rust-everywhere.

Table of Contents

• Features

• Installation

• Testing

  • pytest

  • Coverage

  • Coveralls

• Linter

• Type Checking

• Continuous Integration

• Documentation

• Comunication

• Code Review

Features

• Travis CI integration

• pytest integration for testing

• flake8 integration (invoke by pytest)

• pylint integration (invoke by pytest)

• coverage integration (invoke by pytest)

• pydocstyle integration

• mypy integration (optional static type checker)

• Publish to PyPI with Travis CI automatically (when tagging new release)

• Publish to GitHub with Travis CI automatically (when tagging new release)

Installation

python setup.py install

Testing

pytest

With pytest-runner, we will have python setup.py pytest.

With addopts = --doctest-modules in pytest.ini, we will also invoke doctest.

With alias in setup.cfg, we can just use python setup.py test.

run your test code :

python setup.py test
python setup.py test --addopts -v   # verbose

Here is the pytest’s documetation about integrating with setuptools.

Coverage

With coverage, we can generate testing coverage report. With pytest-cov and --cov-report html --cov-report term in the pytest.ini, we can generate testing coverage report along with running testing code.

Coveralls

Please visit https://coveralls.io/ to create coveralls for your repo.

Linter

Flake8

python setup.py flake8

Here is the flake8’s documetation about integrating with setuptools.

Type Checking

mypy

mypy everywhere

Continuous Integration

Travis CI

Please visit https://travis-ci.org/profile/USERNAME to open Travis CI support for your repo.

Documentation

python build_doc.py

Comunication

Gitter

Please visit https://gitter.im/USERNAME#createroom to add chat room for your repo.

Code Review

Code Climate

Please visit https://codeclimate.com/github/signup to add automated code review for your repo.