core-tests 1.1.5

It contains common elements for testing purposes...

core-tests

---

This project contains basic elements for testing purposes and the ability to run (via console commands) tests and code coverage (unittest-based). This way, we can stick to the DRY -- Don't Repeat Yourself principle and avoid code duplication in each python project where tests coverage and tests execution are expected...

How to Use

Install the package

pip install core-tests

Create entry-point

# manager.py

from click.core import CommandCollection
from core_tests.tests.runner import cli_tests

if __name__ == "__main__":
    cli = CommandCollection(sources=[cli_tests()])
    cli()

Shell commands

Running tests

python manager.py run-tests --test-type unit
python manager.py run-tests --test-type integration
python manager.py run-tests --test-type "another folder that contains test cases under ./tests"
python manager.py run-tests --test-type functional --pattern "*.py"

Using PyTest

The unittest framework cannot discover or run pytest-style tests, it is designed to discover and run tests that are subclasses of unittest.TestCase and follow its conventions. Pytest-style tests (i.e., functions named test_* that are not inside a unittest.TestCase class, or tests using pytest fixtures, parametrize, etc.) are not recognized by unittest’s discovery mechanism, unittest will simply ignore standalone test functions and any pytest-specific features...

That's why you can use PyTest if required.

pip install .[pytest]
python manager.py run-tests --engine pytest

Test coverage

python manager.py run-coverage                  # For `unittest` framework...
python manager.py run-coverage --engine pytest  # For `PyTest`...

Execution Environment

Install libraries

pip install --upgrade pip 
pip install virtualenv

Create the Python Virtual Environment

virtualenv --python={{python-version}} .venv
virtualenv --python=python3.11 .venv

Activate the Virtual Environment

source .venv/bin/activate

Install required libraries

pip install .

Check tests and coverage...

python manager.py run-tests
python manager.py run-coverage