Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/octue/octue-sdk-python
The python SDK for @Octue services and digital twins.
https://github.com/octue/octue-sdk-python
data data-service data-service-development-kit data-services digital-twin digital-twin-application digital-twin-web digital-twins microservice microservices python python3 renewable-energy renewables sdk sdk-python wind-energy wind-energy-analytics
Last synced: about 2 months ago
JSON representation
The python SDK for @Octue services and digital twins.
- Host: GitHub
- URL: https://github.com/octue/octue-sdk-python
- Owner: octue
- License: other
- Created: 2017-03-21T16:35:04.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2024-12-16T13:36:54.000Z (about 2 months ago)
- Last Synced: 2024-12-16T22:10:58.620Z (about 2 months ago)
- Topics: data, data-service, data-service-development-kit, data-services, digital-twin, digital-twin-application, digital-twin-web, digital-twins, microservice, microservices, python, python3, renewable-energy, renewables, sdk, sdk-python, wind-energy, wind-energy-analytics
- Language: Python
- Homepage: https://octue.com
- Size: 6.34 MB
- Stars: 10
- Watchers: 3
- Forks: 4
- Open Issues: 84
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://badge.fury.io/py/octue)
[](https://github.com/octue/octue-sdk-python/actions/workflows/release.yml)
[](https://codecov.io/gh/octue/octue-sdk-python)
[](https://octue-python-sdk.readthedocs.io/en/latest/?badge=latest)
[](https://github.com/pre-commit/pre-commit)
[](https://github.com/ambv/black)
[](https://doi.org/10.5281/zenodo.10961975)
# Octue Python SDK 
The python SDK for running [Octue](https://octue.com) data services, digital twins, and applications - get faster data
groundwork so you have more time for the science!
Read the docs [here.](https://octue-python-sdk.readthedocs.io/en/latest/)
Uses our [twined](https://twined.readthedocs.io/en/latest/) library for data validation.
## Installation and usage
To install, run one of:
```shell
pip install octue
```
```shell
poetry add octue
```
The command line interface (CLI) can then be accessed via:
```shell
octue --help
```
```text
Usage: octue [OPTIONS] COMMAND [ARGS]...
The CLI for the Octue SDK. Use it to start an Octue data service or digital
twin locally or run an analysis on one locally.
Read more in the docs: https://octue-python-sdk.readthedocs.io/en/latest/
Options:
--id UUID UUID of the analysis being undertaken. None
(for local use) will cause a unique ID to be
generated.
--logger-uri TEXT Stream logs to a websocket at the given URI.
--log-level [debug|info|warning|error]
Log level used for the analysis. [default:
info]
--force-reset / --no-force-reset
Forces a reset of analysis cache and outputs
[For future use, currently not implemented]
[default: force-reset]
--version Show the version and exit.
-h, --help Show this message and exit.
Commands:
deploy Deploy a python app to the cloud as an Octue service or digital...
run Run an analysis on the given input data using an Octue service...
start Start an Octue service or digital twin locally as a child so it...
```
## Deprecated code
When code is deprecated, it will still work but a deprecation warning will be issued with a suggestion on how to update
it. After an adjustment period, deprecations will be removed from the codebase according to the [code removal schedule](https://github.com/octue/octue-sdk-python/issues/415).
This constitutes a breaking change.
## Developer notes
### Installation
We use [Poetry](https://python-poetry.org/) as our package manager. For development, run the following from the
repository root, which will editably install the package:
```shell
poetry install --all-extras
```
Then run the tests to check everything's working.
### Testing
These environment variables need to be set to run the tests:
- `GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/service/account/file.json`
- `TEST_PROJECT_NAME=`
Then, from the repository root, run
```shell
python3 -m unittest
```
or
```shell
tox
```
## Contributing
Take a look at our [contributing](/docs/contributing.md) page.