Skip to main content

Python software developer kit for the Omnia Timeseries API.

Project description

OMNIA Timeseries SDK for Python

Python software developer kit for the Omnia Timeseries API.

General

About

This is the Python SDK for developers and data scientists working with Omnia Timeseries. The package integrates with pandas to help you work easily and efficiently with the data.

Getting started

Run the below command in a Python environment to install the latest release

pip install omnia_timeseries_sdk

.. or upgrade existing installation

pip install --upgrade omnia_timeseries_sdk

To access Omnia you have to set the following environmental variables. The values are provided by the Omnia administrators.

set omniaResourceId="omnia-resource-id"
set omniaClientId="your-client-id"
set omniaClientSecret="very-very-secret-shared-key"

Import the Omnia client in your own scripts...

from omnia_timeseries_sdk import OmniaClient

... and get to work. Here is an introduction.

Take a look at the resources listed below to learn more.

Resources

Contribute

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

Install Python version 3.7 or later from either https://www.python.org or https://www.anaconda.com.

Clone the source code repository

At the desired location, run:

git clone https://github.com/equinor/omnia-timeseries-sdk-python.git

Installing

To get the development environment running:

... create an isolated Python environment and activate it,

python -m venv /path/to/new/virtual/environment

/path/to/new/virtual/environment/Scripts/activate

... install the dev dependencies in requirements.txt,

pip install -r requirements.txt

.. and install the package in development mode.

python setup.py develop

You should now be able to import the package in the Python console,

import omnia_timeseries_sdk
help(omnia_timeseries_sdk)

Running the tests

The automated tests are run using Tox.

tox

The test automation is configured in tox.ini.

Building the package

Build tarball and wheel distributions by:

python setup.py sdist bdist_wheel

The distribution file names adhere to the PEP 0427 convention {distribution}-{version}(-{build tag})?-{python tag}-{abi tag}-{platform tag}.whl.

Deployment

Wait for it...

Versioning

We apply the "major.minor.micro" versioning scheme defined in PEP 440.

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details.

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for omnia-timeseries-sdk, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size omnia_timeseries_sdk-0.1.0-py3-none-any.whl (13.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size omnia_timeseries_sdk-0.1.0.tar.gz (190.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page