Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/astrojuanlu/cookiecutter-pylib

cookiecutter template for pure Python libraries. As simple as possible. No magic.
https://github.com/astrojuanlu/cookiecutter-pylib

Last synced: 2 months ago
JSON representation

cookiecutter template for pure Python libraries. As simple as possible. No magic.

Awesome Lists containing this project

README

        

# cookiecutter-pylib

[![No Maintenance Intended](http://unmaintained.tech/badge.svg)](http://unmaintained.tech/)

_This project is archived, use https://github.com/astrojuanlu/copier-pylib instead_

[Cookiecutter](https://github.com/audreyr/cookiecutter) template for pure Python libraries.

_As simple as possible. No magic._

## Features

- [flit] for simple packaging.
- [pytest] for testing.
- [tox] for automation of test runners and other stuff.
- [Sphinx] for documentation
- [GitHub Actions] for continuous integration and publishing to PyPI.
- [Read the Docs] for continuous documentation.
- [mypy] for type checks.
- [black] for automatic Python code formatting.
- [flake8], [isort] and [pydocstyle] for style checks.
- [pre-commit] for optional automation of style checks.

## Usage

Install `cookiecutter`:

```
pip install cookiecutter
```

Generate a Python package:

```
cookiecutter gh:astrojuanlu/cookiecutter-pylib
```

## License

[MIT License](LICENSE)

[cookiecutter]: https://github.com/audreyr/cookiecutter/
[mypy]: http://mypy.readthedocs.io/
[flit]: https://flit.readthedocs.io/
[pytest]: https://docs.pytest.org/
[Sphinx]: http://www.sphinx-doc.org/
[tox]: https://tox.readthedocs.io/
[black]: https://black.readthedocs.io/
[flake8]: https://flake8.pycqa.org/
[isort]: https://pycqa.github.io/isort/
[pydocstyle]: http://www.pydocstyle.org/
[pre-commit]: https://github.com/pre-commit/pre-commit
[GitHub Actions]: https://github.com/features/actions
[Read the Docs]: https://readthedocs.org