[![ci](https://github.com/us-irs/cfdp-py/actions/workflows/ci.yml/badge.svg)](https://github.com/us-irs/cfdp-py/actions/workflows/ci.yml)
[![Documentation Status](https://readthedocs.org/projects/cfdp-py/badge/?version=latest)](https://cfdp-py.readthedocs.io/en/latest/?badge=latest)
[![codecov](https://codecov.io/gh/us-irs/cfdp-py/graph/badge.svg?token=FBL1NR54BI)](https://codecov.io/gh/us-irs/cfdp-py)
[![PyPI version](https://badge.fury.io/py/cfdp-py.svg)](https://badge.fury.io/py/cfdp-py)
cfdp-py - High level Python library for CFDP components
======================
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](https://public.ccsds.org/Pubs/727x0b5.pdf).
The underlying base packet library used to generate the packets to be sent is the
[spacepackets](https://github.com/us-irs/spacepackets-py) library.
# Install
You can install this package from PyPI
Linux:
```sh
python3 -m pip install cfdp-py
```
Windows:
```sh
py -m pip install cfdp-py
```
# Examples
You can find all examples [inside the documentation](https://cfdp-py.readthedocs.io/en/latest/examples.html) and the `examples` directory of this repository.
# Tests
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:
```sh
pip install coverage pytest
pip install cfdp-py[test]
```
Running tests regularly:
```sh
pytest .
```
Running tests with coverage:
```sh
coverage run -m pytest
```
# Documentation
The documentation is built with Sphinx
Install the required dependencies first:
```sh
pip install -r docs/requirements.txt
```
Then the documentation can be built with
```sh
cd docs
make html
```
You can run the doctests with
```sh
make doctest
```
Raw data
{
"_id": null,
"home_page": null,
"name": "cfdp-py",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "ccsds, space, communication, packet, file-transfer",
"author": null,
"author_email": "Robin Mueller <robin.mueller.m@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/8f/8a/a5ca29f637e4dd7c1cc6805f0e3de1c1c6de4fee9896dbec4a88cb8ce373/cfdp_py-0.1.1.tar.gz",
"platform": null,
"description": "[![ci](https://github.com/us-irs/cfdp-py/actions/workflows/ci.yml/badge.svg)](https://github.com/us-irs/cfdp-py/actions/workflows/ci.yml)\n[![Documentation Status](https://readthedocs.org/projects/cfdp-py/badge/?version=latest)](https://cfdp-py.readthedocs.io/en/latest/?badge=latest)\n[![codecov](https://codecov.io/gh/us-irs/cfdp-py/graph/badge.svg?token=FBL1NR54BI)](https://codecov.io/gh/us-irs/cfdp-py)\n[![PyPI version](https://badge.fury.io/py/cfdp-py.svg)](https://badge.fury.io/py/cfdp-py)\n\ncfdp-py - High level Python library for CFDP components\n======================\n\nThe `cfdp-py` library offers some high-level CCSDS File Delivery Protocol (CFDP) components to\nperform file transfers according to the [CCSDS Blue Book 727.0-B-5](https://public.ccsds.org/Pubs/727x0b5.pdf).\nThe underlying base packet library used to generate the packets to be sent is the\n[spacepackets](https://github.com/us-irs/spacepackets-py) library.\n\n# Install\n\nYou can install this package from PyPI\n\nLinux:\n\n```sh\npython3 -m pip install cfdp-py\n```\n\nWindows:\n\n```sh\npy -m pip install cfdp-py\n```\n\n# Examples\n\nYou can find all examples [inside the documentation](https://cfdp-py.readthedocs.io/en/latest/examples.html) and the `examples` directory of this repository.\n\n# Tests\n\nIf you want to run the tests, it is recommended to install `pytest` and `coverage` (optional)\nfirst. You also have to install the package with the optional `test` feature:\n\n```sh\npip install coverage pytest\npip install cfdp-py[test]\n```\n\nRunning tests regularly:\n\n```sh\npytest .\n```\n\nRunning tests with coverage:\n\n```sh\ncoverage run -m pytest\n```\n\n# Documentation\n\nThe documentation is built with Sphinx\n\nInstall the required dependencies first:\n\n```sh\npip install -r docs/requirements.txt\n```\n\nThen the documentation can be built with\n\n```sh\ncd docs\nmake html\n```\n\nYou can run the doctests with\n\n```sh\nmake doctest\n```\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Library for high level CCSDS File Delivery Protocol (CFDP) components",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/us-irs/cfdp-py"
},
"split_keywords": [
"ccsds",
" space",
" communication",
" packet",
" file-transfer"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5f8685be11103c844d03a722d75dfbf6cfd7a6f63552964ff53a7780f388c191",
"md5": "8df6bcf1de3a7692b7b873a868bea7f0",
"sha256": "c73c430b924c55a15f0ef99716fad443f2aefaa67f6aac8676235bbea24d5a37"
},
"downloads": -1,
"filename": "cfdp_py-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8df6bcf1de3a7692b7b873a868bea7f0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 42365,
"upload_time": "2024-04-23T08:42:57",
"upload_time_iso_8601": "2024-04-23T08:42:57.994988Z",
"url": "https://files.pythonhosted.org/packages/5f/86/85be11103c844d03a722d75dfbf6cfd7a6f63552964ff53a7780f388c191/cfdp_py-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8f8aa5ca29f637e4dd7c1cc6805f0e3de1c1c6de4fee9896dbec4a88cb8ce373",
"md5": "da7d1203cc900a3bb10b000789d3c205",
"sha256": "f3003aed10fb39ba5a4bd43effc87b6d7f38aadc390f704921ffa2285c88aff3"
},
"downloads": -1,
"filename": "cfdp_py-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "da7d1203cc900a3bb10b000789d3c205",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 61199,
"upload_time": "2024-04-23T08:43:00",
"upload_time_iso_8601": "2024-04-23T08:43:00.087786Z",
"url": "https://files.pythonhosted.org/packages/8f/8a/a5ca29f637e4dd7c1cc6805f0e3de1c1c6de4fee9896dbec4a88cb8ce373/cfdp_py-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-23 08:43:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "us-irs",
"github_project": "cfdp-py",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "cfdp-py"
}