cumulocity-python-api
This project is a Python client for the Cumulocity REST API to make it easier to develop programs, scripts, device agents or microservices in Python.
See also the documentation on Read the Docs.
[!IMPORTANT] The Cumulocity Python API will be discontinued in favor of its spiritual successor, the Cumulocity Python SDK (pyc8y package) - re-envisioned and reimplemented for asyncio. The
c8y_apimodule is considered deprecated for new solutions and will only receive essential updates for continuous support of already existing production code.
Installation
Prerequisites
Before installing the module (or any module for that matter) consider creating a virtual environment for your project. This is generally preferred over installing modules and dependencies globally:
cd <project-root>
python3 -m venv venv
source venv/bin/activate
Installation from PyPI
The recommended way is to install the lastest distribution package directly from the Python Package Index (PyPI). You can either add c8y_api as a dependency to your project using setup.cfg, or install it manually:
pip install c8y_api
Installation using pip
Releases are also archived within the GitHub releases page. The module is released as standard Python wheel (.whl file). It can be downloaded and installed using pip using the following command:
pip install <release wheel file>
Like installing from PyPI, this will install all necessary dependencies automatically. For your reference, the module's dependencies are also listed in file requirements.txt.
Manual installation
Alternatively, you can clone the repository. The module sources can be used directly within your Python 3 project. Simply copy the c8y_api folder to your sources root and install the requirements by running the following command:
pip3 install -r requirements.txt
The requirements.txt file is part of the sources.
If the c8y_api folder is in your sources root folder all imports should work right away. Alternatively you can add c8y_api to your PYHTONPATH:
export PYTHONPATH=<project-root>/c8y_api; $PYTHONPATH
Licensing
This project is licensed under the Apache 2.0 license - see https://www.apache.org/licenses/LICENSE-2.0
These tools are provided as-is and without warranty or support. They do not constitute part of the Cumulocity product suite. Users are free to use, fork and modify them, subject to the license agreement. While Cumulocity GmbH welcomes contributions, we cannot guarantee to include every contribution in the master project.
You can find additional information in the Cumulocity Tech Community. There is also an introductory article (Getting started with the Cumulocity Python API) available.
1 maintainer
Release files for c8y-api 3.7.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| c8y_api-3.7.3.tar.gz | 298.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| c8y_api-3.7.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 425.9 kB
Release files / c8y_api-3.7.3.tar.gz
| Download URL | c8y_api-3.7.3.tar.gz |
|---|---|
| Size | 298.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e49f543242e8d756e1f6ab92cea754f251d861128ca2d766de8b2206532e7164
|
|
BLAKE2b-256 checksum How to use checksums |
14411095dfbc48bd3951d3a77874cc5576bfe29dc2b512bf3884bf32bbf8ce03
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / c8y_api-3.7.3-py3-none-any.whl
| Download URL | c8y_api-3.7.3-py3-none-any.whl |
|---|---|
| Size | 127.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9d2d09cea76d7ef433b5ee9a890b0edb1bbe310a35a0774b69b388591630d24a
|
|
BLAKE2b-256 checksum How to use checksums |
ab759dec34be8b8262c33b2d22be2621541360bdc3d4f5c76fa820724aad2a2d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
