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 1.5.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-1.5.0.tar.gz | 42.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| envoy_schema-1.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size:97.5 kB
Release files / envoy_schema-1.5.0.tar.gz
| Download URL | envoy_schema-1.5.0.tar.gz |
|---|---|
| Size | 42.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e5f4069b775ae49cdd4b61796be81f60d69e350756b332798a224853ad97cb8b
|
|
BLAKE2b-256 checksum How to use checksums |
5bb661ac9d4ff36f42e52b8f28886a0a9a1ad3c93dbefd4d064559c65359b771
|
| 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-1.5.0-py3-none-any.whl
| Download URL | envoy_schema-1.5.0-py3-none-any.whl |
|---|---|
| Size | 55.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
61c556395ee324f762574b3ad8234ab9d888eae7bbd4dc83c609b0d49aa8f11f
|
|
BLAKE2b-256 checksum How to use checksums |
740aefd0e50e711d3002c888b160db592882fc8eef711c11f25bd0d32f95342b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.13
|