pytest-alphamoon 0.5.2

Static code checks used at Alphamoon

pytest-alphamoon

Set of simple static code checks at Alphamoon.

---

This pytest plugin was generated with Cookiecutter along with @hackebrot's cookiecutter-pytest-plugin template. Source code is based on pytest-isort plugin.

Features

Package contains several plugins, as shown in Table below:

Plugin	Description
import-check	Checks no imports from scripts/notebooks/user_settings
init-check	Checks no __init__.py file in scripts/notebooks
notebook-check	Checks notebooks (.ipnyb files) are clean, without outputs
newline-check	Checks files (requirements*, .gitignore or custom) for newline at the end of file
testdir-check	Checks test files (files matching patterns: test_*.py or *_test.py) are under /tests directory
annotation-check	Checks integration tests function/class definition (all class and functions defined under integration_tests prefixed with test*) has decorator @integration_test
adr-check	Checks Architecture Decision Record files has consistent (unique) numbering (by default plugin searches for .adr-dir for declaration of ADR files directory)
requirements-coherence-check	Checks requirements defined in setup.py against those in requirements[-dev].txt (library names presence and versions if specified).
requirements-versions-check	Checks whether requirements versions are fixed
sorted-requirements-check	Checks if requirements* files are sorted
commit-message-check	Checks whether git commit messages follow the naming convention

Requirements

git-python>=1.0.3
pytest>=3.5.0

Installation

You can install "pytest-alphamoon" via pip from PyPI:

$ pip install pytest-alphamoon

Usage

You can add arbitrary plugin from this package by specifying its name in pytest.ini addopts section with plugin names as shown in Table above along with any other plugin you are currently using.

[pytest]
addopts = --init-check --import-check --notebook-check  --newline-check --testdir-check
          --annotation-check --adr-check --requirements-coherence-check --requirements-versions-check
          --sorted-requirements-check --commit-message-check
import_forbidden_from =
    scripts
    user_settings
    notebooks

notebook_allowed_in =
    notebooks

init_forbidden_in =
    scripts
    notebooks

adr_rel_path = .adr-dir

requirements_path=
    requirements.txt
    requirements-dev.txt

check_commit_messages_from = 0f95a3b033d27e1845b85ff59739889043fd598d

pytest_nesting_level = 1

Parameters, like import_forbidden_from, shown in example configuration above are optional. If custom values are not provided in pytest.ini file, default parameters are used.

After setting up configuration file specified checks are loaded and executed automatically within test session, after invoking command:

$ pytest

Contributing

Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.

License

Distributed under the terms of the MIT license, "pytest-alphamoon" is free and open source software

Issues

If you encounter any problems, please email us at [e-mail], along with a detailed description.