A Python library that helps building NGSI-LD entities and interacting with a NGSI-LD Context Broker
Project description
The ngsildclient library
Overview
ngsildclient is a Python library that helps building NGSI-LD entities and allows to interact with a NGSI-LD Context Broker.
The library primary purpose is to ease and speed up the development of a NGSI Agent and is also useful for Data Modeling in the design stage.
Key Features
Build NGSI-LD entities
The task of building a large NGSI-LD compliant entity is tedious, error-prone and results in a significant amount of code.
ngsildclient provides primitives to build and manipulate NGSI-LD compliant entities without effort, in respect with the ETSI specifications.
Implement the NGSI-LD API
ngsildclient provides a NGSI-LD API Client implementation.
Acting as a Context Producer/Consumer ngsildclient is able to send/receive NGSI-LD entities to/from the Context Broker for creation and other operations.
The library wraps a large subset of the API endpoints and supports batch operations, queries, subscriptions.
Where to get it
The source code is currently hosted on GitHub at : https://github.com/Orange-OpenSource/python-ngsild-client
Binary installer for the latest released version is available at the Python package index.
pip install ngsildclient
Installation
ngsildclient requires Python 3.9+.
One should use a virtual environment. For example with pyenv.
mkdir myagent && cd myagent
pyenv virtualenv 3.10.4 myagent
pyenv local myagent
pip install ngsildclient
Getting started
The following code snippet builds a NGSI-LD entity related to a measure of air quality in Bordeaux then sends it to the Context Broker.
from ngsildclient import Entity, Client
e = Entity("AirQualityObserved", "Bordeaux-AirProbe42-2022-03-24T09:00:00Z")
e.tprop("dateObserved").gprop("location", (44.84044, -0.5805))
e.prop("PM25", 12, unitcode="GP").prop("PM10", 18, unitcode="GP")
e.prop("NO2", 8, unitcode="GP").prop("O3", 83, unitcode="GP")
e.rel("refDevice", "Device:AirProbe42")
with Client() as client:
client.upsert(e)
The corresponding JSON-LD payload has been generated.
Asynchronous Client
Alternatively you can prefer the Asynchronous Client, typically when user interactivity is not needed and seeking for performance - i.e. writing a real-time NGSI-LD agent.
from ngsildclient import AsyncClient
async with AsyncClient() as client:
await client.upsert(e)
Documentation
User guide is available on Read the Docs.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ngsildclient-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c498e03a0651e4b32560b2c1dbc1fd288a204dc92006d02700d0757bd95cad20 |
|
MD5 | f0a026a08c569608c27c694a4352a98a |
|
BLAKE2b-256 | b2ae564c35d4238cb640bbd24c9d4335f28d2e02dab9f09570fa07acd11a61e4 |