Skip to main content

Module for a code quality related scripts.

Project description

[!IMPORTANT]
This project is under development. All source code and features on the main branch are for the purpose of testing or evaluation and not production ready.

MFD Code Quality

This module provides a set of methods for checking code quality.

Along with the module installation, additional CLI tools appear in your environment.

Usage

When installing mfd-code-quality package all the commands from table below will become available from command-line.
So you can just type i.e. mfd-help in your terminal without a need to call it from Python.
If command requires configuration, the config file will be automatically created and removed after execution.

Available commands

Command Description
mfd-help Log available commands.
mfd-code-standard Check code standard using Ruff (format, check) or flake8. Depending on what is available.
mfd-code-format Format code using ruff check --fix and ruff format.
mfd-import-tests Try to import each Python file to check import problems.
mfd-system-tests Run system tests.
mfd-unit-tests Run unit tests.
mfd-unit-tests-with-coverage Run unittests and check if diff coverage (new code coverage) is reaching the threshold (80%).
mfd-all-checks Run all available checks.

Available arguments (for all commands)

  • -p / --project-dir - path to the root directory (default: current working directory)

  • -v / --verbose - enable verbose output

[!NOTE] All commands are expected to be run from the root directory of the project.
Recommended file structure:

<project>
├── <package>
│   ├── __init__.py
│   ├── ...
├── tests
│   ├── system
│   │   ├── __init__.py
│   │   └── ...
│   ├── unit
│   │   ├── __init__.py
│   │   └── ...
│   └── __init__.py
├── pyproject.toml
├── README.md
└── ...

Configuration files

We are using two configuration files (created/modified/removed automatically):

  • ruff.toml - for ruff configuration

  • pyproject.toml - for project/generic configuration

Custom configuration

Some modules have custom configuration files. Files are stored in mfd_code_quality/code_standard/config_per_module directory. Configuration files are merged with generic one during configuration process.

OS supported:

OS agnostic

Issue reporting

If you encounter any bugs or have suggestions for improvements, you're welcome to contribute directly or open an issue here.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mfd_code_quality-1.4.0-py3-none-any.whl (43.1 kB view details)

Uploaded Python 3

File details

Details for the file mfd_code_quality-1.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mfd_code_quality-1.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e30a6f1b9e2082c8028161dddcdfb79808fe9d5e3a60d6967c15f5e9f1342352
MD5 255178d6cfd13296bed182facd0be701
BLAKE2b-256 aa18b11206c904f221ef4c1aa38838d635aff3f30afa8abe18e09610a3c9146a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page