[![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/9d/5d/01a5999a8148f36b9204a136151031211b272877f6e53de0bb7355ddafb5/cfdp_py-0.4.0.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.4.0",
"project_urls": {
"Homepage": "https://github.com/us-irs/cfdp-py"
},
"split_keywords": [
"ccsds",
" space",
" communication",
" packet",
" file-transfer"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e8847c8a39bbc170e0769ddb9263f7baff2d27906bd08c16570af3d63f51e7b2",
"md5": "feb2fa8e3bfa920edca07c5c7e027a20",
"sha256": "44b02aaafcbcf85fab8a1dc2df25b8d986b8f517f689149c9c4bd8db06d61946"
},
"downloads": -1,
"filename": "cfdp_py-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "feb2fa8e3bfa920edca07c5c7e027a20",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 42551,
"upload_time": "2024-11-08T16:27:08",
"upload_time_iso_8601": "2024-11-08T16:27:08.310805Z",
"url": "https://files.pythonhosted.org/packages/e8/84/7c8a39bbc170e0769ddb9263f7baff2d27906bd08c16570af3d63f51e7b2/cfdp_py-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9d5d01a5999a8148f36b9204a136151031211b272877f6e53de0bb7355ddafb5",
"md5": "53d75b97e16443e365e2f4e41a5d5527",
"sha256": "805d804001800e5c165a7b3639570036570c960beecaa70be3203cdd717c93a6"
},
"downloads": -1,
"filename": "cfdp_py-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "53d75b97e16443e365e2f4e41a5d5527",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 62976,
"upload_time": "2024-11-08T16:27:10",
"upload_time_iso_8601": "2024-11-08T16:27:10.136854Z",
"url": "https://files.pythonhosted.org/packages/9d/5d/01a5999a8148f36b9204a136151031211b272877f6e53de0bb7355ddafb5/cfdp_py-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-08 16:27:10",
"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"
}