Manual

Project Structure

flowchart
    . --> docs
    . --> src
    src --> calc.py
    src --> main.py
    . --> tests
    tests --> unity
    tests --> functional
    tests --> integral

On docs directory, you can find all the documentation of the project. The documentation is made with mkdocs. To run the documentation, you must run the command task docs on the root of the project.

On src directory, you can find the source code of the project. - calc.py: contains all the functions of the project - main.py: contains the cli of the project

On tests directory, you can find all the tests of the project. The tests are divided into three categories: - unity: tests that test a single function - functional: tests that test a group of functions - integral: tests that test the entire application

calc.py

The calc.py file contains the functions and classes to do the calculation.

cmd.py

The cli is build using Typer, on this link you can get more information about how to build a cli using this library.

test

To do tests we are using pytest. The configuration can be found on pyproject.toml.

We are using pytest-cov to generate the coverage report.

task tests

Documentation

The documentation is made with mkdocs and staylized with the teme mkdocs-material. All the documentation configuration can be found on mkdocs.yml.

Code documentation

The Code docuemntation is been made with mkdocstrings. So it's automatically generated from the docstrings of the code.

::: modulo

To get mode details about docstrings, check at docstrings @ Google.