The tools being used¶

Ruff¶

Ruff is black+flake8+isort+pyupgrade all in one. ruff format is mostly “black” and ruff check is all the rest. It only needs a bit of config in pyproject.toml.

$ pre-commit run --all  # Yes, this runs ruff, too

What ruff actually does depends a lot on the configuration in pyproject.toml. Especially the configured checks. Do you want your python code upgraded to a newer syntax with f-strings? Automatic complexity checking?

You can run it on the commandline if you have it installed globally and you can install the ruff plugin for vscode that automatically formats your code when you save it.

$ ruff format       # Just the "black" visual part
$ ruff check        # Syntax checks
$ ruff check --fix  # Safe fixes for syntax errors

Pytest¶

Pytest is the best test runner. Nicer to work with than python’s standard unittest framework. Tests are discovered automatically when they’re called test_*.py and they work with simple assert statements. Just look at the test of nens-meta itself. Ask a programmer about a quick demo or read the Pytest documentation.

(.venv) $ pytest     # Note: activate the virtualenv!
(.venv) $ pytest -l  # Show local variables when there's an error
(.venv) $ pytest -x  # Stop immediately upon the first error

Everything (like vscode) that recognises a virtualenv should be able to run pytest out of the box.

Coverage¶

TODO, resurrect “createcoverage” for this.

Configured in pyproject.toml, run via tox -e coverage. Shows the coverage as a textual summary and generates htmlcov/index.html for a nice visual representation.

If configured to do so, coverage will warn you if the coverage is lower than the configured minimum level. In .nens.toml, the minimum_coverage setting in [tox] can be set for this.

Pre-commit¶

Pre-commit is the tool to run all sorts of checks and formatters on your code. The big advantage is that pre-commit itself handles the installation of the checkers and formatters so that you don’t have to. Everything is done for you.

$ pip install pre-commit  # One-time global install
$ pre-commit run --all    # Just run this in every project

Optionally you can insert it into your git workflow with pre-commit install, then pre-commit will run and will check your files before adding them to a commit. That’s something for the “hard-core” programmers, probably, as when there’s an error, getting past it might be a tad tricky.

Pre-commit runs everything from ruff to spaces-at-the-end-of-lines checkers to yaml/toml syntax checkers. The configuration happens in .pre-commit-config.yaml.

Ansible-lint¶

When an ansible/ dir is found, ansible-lint is added to the pre-commit config.

See requirements.yml for necessary configuration.

Github actions¶

In the main/master branch and in pull requests, a nens-meta github action is automatically run. At least pre-commit. If you’re a python project also pytest. If you’ve configured coverage, that too.

The way everything is set up hopefully makes working with this kind of checks easier and more comfortable.

If you need more: you can have nens-meta ignore the workflow file and customize it fully. And you can always add a second workflow file next to it.

Dependabot¶

Dependabot is a service build into github. It does a lot of things. nens-meta currently only uses it to update the versions of actions used in the github action workflow steps.

In the future, proper python/javascript dependency checking could be added. Though you can always enable it yourself if you want, of course.