python-dev-tools 2019.3.19

Needed and up-to-date tools to develop in Python

Python Dev Tools

Needed and up-to-date tools to develop in Python (WORK IN PROGRESS)

Documentation

The full documentation can be read at https://python-dev-tools.readthedocs.io.

Installation

• Short version: pip install python-dev-tools

• Long version: https://python-dev-tools.readthedocs.io/en/latest/installation.html

• Use the provided linter, formatter and precommit hook where applicable

Installation with Visual Studio Code

• pip install --user --upgrade python-dev-tools

• Be sure to have the official Python extension installed in VS Code

• In VS Code, open settings (F1 key, then type “Open Settings (JSON)”, then enter)

• Add in the opened JSON file:

"python.linting.enabled": true,
"python.linting.flake8Enabled": true,
"python.linting.flake8Path": "/home/vincent/.local/bin/whatalinter",

• Adapt the previous path according to your installation.

Features

Integrate features of commonly used tools. This package provides usual dependencies to develop Python software.

• Simple linter

  • whatalinter a_python_file.py lints a_python_file.py

  • output is compatible with the one of pycodestyle (formerly named pep8) for easy integration in text editors and IDE

  • based on

    • pycodestyle: https://github.com/PyCQA/pycodestyle

    • pyflakes: https://github.com/PyCQA/pyflakes

    • mccabe: https://github.com/pycqa/mccabe

    • pydocstyle: https://github.com/PyCQA/pydocstyle

• Simple formatter

  • TODO

• Simple precommit hook

  • TODO

License

BSD 3-Clause license, feel free to contribute: https://python-dev-tools.readthedocs.io/en/latest/contributing.html.

TODO

• documentation

• linter

  • add more linters

• formatter

• precommit

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

2019.03.02

• Add pydocstyle linter

2019.03.01

• Add McCabe complexity checker

2019.02.26

• Add pyflakes linter

• Add pycodestyle linter

2019.02.23

• First release on PyPI.