The cfdp-py library offers some high-level CCSDS File Delivery Protocol (CFDP) components to perform file transfers according to the CCSDS Blue Book 727.0-B-5. The underlying base packet library used to generate the packets to be sent is the spacepackets library.

You can install this package from PyPI

Install command assuming an active virtual environment:

pip install cfdp-py

You can find all examples inside the documentation and the examples directory of this repository.

If you want to run the tests, it is recommended to install pytest and coverage (optional) first. You also have to install the package with the optional test feature:

pip install coverage pytest
pip install cfdp-py[test]

Running tests regularly:

pytest .

Running tests with coverage:

coverage run -m pytest

The documentation is built with Sphinx

Install the required dependencies first:

pip install -r docs/requirements.txt

Then the documentation can be built with

cd docs
make html

You can run the doctests with

make doctest

Linting:

ruff check .

Formatting:

ruff format .