envoy-schema
Public schema for the models/schema associated all envoy API endpoints.
This repository was built as a shared dependency for the envoy utility server and any external clients wishing to integrate.
Envoy: https://github.com/bsgip/envoy
Envoy Server Models
The models served under envoy_schema.server are derived from the following standards:
- IEEE: Smart Energy Profile (2030.5-2018)
- Sunspec: Common Smart Inverter Profile
- Common Smart Inverter Profile (Australia)
Versioning
The main branch is the active development branch. Releases will be tagged off the associated release branch.
| CSIP-Aus Version | envoy-schema versions | release branches |
|---|---|---|
v1.1a |
v0.*, v1.* |
csipaus.org/ns/v1.2 |
v1.2 |
v0.*, v1.* |
csipaus.org/ns/v1.2 |
v1.3 |
v2.* |
csipaus.org/ns/v1.3 |
Envoy Admin Models
The models served under envoy_schema.admin are typically only used for services directly integrating with the envoy utility server (via the admin server). This is for machine-machine services that are not typically exposed externally.
Installation
Install directly from pypi
# Using uv
uv add envoy-schema
# Using pip
pip install envoy-schema
Development
To install envoy-schema for development purposes, after cloning this repository:
# Using uv
uv sync --python 3.13 --all-extras
uv run pytest
# Using pip
pip install -e .[all]
pytest
We use the following linting/formatting tools:
Contributions via a pull request are welcome but will be validated using the above tools.
Tests can be run with: pytest from the root directory.
Release files for envoy-schema 2.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| envoy_schema-2.6.0.tar.gz | 42.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| envoy_schema-2.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size:97.1 kB
Release files / envoy_schema-2.6.0.tar.gz
| Download URL | envoy_schema-2.6.0.tar.gz |
|---|---|
| Size | 42.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3a672865b1126d1c3aa5ba6d3333f73bfdac533c113d0b6cffa1e2135f74fea4
|
|
BLAKE2b-256 checksum How to use checksums |
2dc380e8cb698d69240507cdd57920247a0565655a3d2cbff627afd3a87c321f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.13
|
Release files / envoy_schema-2.6.0-py3-none-any.whl
| Download URL | envoy_schema-2.6.0-py3-none-any.whl |
|---|---|
| Size | 54.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9c7cbb3f7f3f25cbc824844f6f2a65cee47063465f17f64c0c2252ca76325d0b
|
|
BLAKE2b-256 checksum How to use checksums |
805ef038c367addb0d8b230e8b229411167ff0a8fa0a2cef059d5f00ed8fd2fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.13
|