Metadata-Version: 2.4
Name: cognite-power-ops
Version: 1.1.7
Summary: SDK for power markets operations on Cognite Data Fusion
License: Apache 2.0
License-File: LICENSE
Author: Cognite
Author-email: support@cognite.com
Requires-Python: >=3.10,<3.13
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: PyYAML (>=6.0,<7.0)
Requires-Dist: StrEnum (>=0.4.15,<0.5.0) ; python_version < "3.11"
Requires-Dist: arrow (>=1.2.0,<2.0.0)
Requires-Dist: black (>=26.5.1,<27.0.0)
Requires-Dist: cachelib (>=0.13.0,<0.14.0)
Requires-Dist: cognite-pygen (>=1.4.0,<2.0.0)
Requires-Dist: cognite-sdk[pandas] (>=8.6.0,<9)
Requires-Dist: dacite (>=1.8.1,<2.0.0)
Requires-Dist: deepdiff (>=8.6.2,<9.0.0)
Requires-Dist: loguru (>=0.7.0,<0.8.0)
Requires-Dist: pandas-stubs (>=2.3.1,<2.4.0)
Requires-Dist: pydantic (>=2.0,<3.0)
Requires-Dist: pydantic-settings (>=2.0,<3.0)
Requires-Dist: tabulate (>=0.9,<0.10)
Requires-Dist: toml (>=0.10)
Requires-Dist: tomli (>=2.0.1,<3.0.0) ; python_version < "3.11"
Requires-Dist: tomli-w (>=1.0.0,<2.0.0)
Requires-Dist: typer (>=0.12.0,<0.13.0)
Requires-Dist: typing_extensions (>=4)
Project-URL: Documentation, https://cognite-power-ops-sdk.readthedocs-hosted.com/en/latest/
Project-URL: Homepage, https://github.com/cognitedata/power-ops-sdk
Project-URL: Repository, https://github.com/cognitedata/power-ops-sdk
Description-Content-Type: text/markdown

# Welcome to PowerOps SDK

[![release](https://img.shields.io/github/actions/workflow/status/cognitedata/power-ops-sdk/sdk-release.yml?style=for-the-badge)](https://github.com/cognitedata/power-ops-sdk/actions/workflows/sdk-release.yml)
[![Documentation Status](https://readthedocs.com/projects/cognite-power-ops-sdk/badge/?version=latest&style=for-the-badge)](https://cognite-power-ops-sdk.readthedocs-hosted.com/en/latest/?badge=latest)
[![Github](https://shields.io/badge/github-cognite/power_ops_sdk-green?logo=github&style=for-the-badge)](https://github.com/cognitedata/power-ops-sdk)
[![PyPI](https://img.shields.io/pypi/v/cognite-power-ops?style=for-the-badge)](https://pypi.org/project/cognite-power-ops/)
[![Downloads](https://img.shields.io/pypi/dm/cognite-power-ops?style=for-the-badge)](https://pypistats.org/packages/cognite-power-ops)
[![GitHub](https://img.shields.io/github/license/cognitedata/power-ops-sdk?style=for-the-badge)](https://github.com/cognitedata/power-ops-sdk/blob/master/LICENSE)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge)](https://github.com/ambv/black)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=for-the-badge)](https://github.com/astral-sh/ruff)
[![mypy](https://img.shields.io/badge/mypy-checked-000000.svg?style=for-the-badge&color=blue)](http://mypy-lang.org)

## What is it?

The PowerOps SDK is a domain-specific SDK for interacting with Cognite Data Fusion (CDF) for the power operations' domain. Requires PowerOps to be deployed and configured for CDF project before using, see [project setup instructions](https://github.com/cognitedata/power-ops-sdk/blob/main/SETUP.md) for more details.

This SDK is used as a submodule in the [power-ops-toolkit](https://github.com/cognitedata/power-ops-sdk-toolkit) repository (private). All toolkit configuration and toolkit deployment workflows are maintained in that repo.

## Main Features

* `cognite.powerops.client.PowerOpsClient` used to interact with CDF in a domain-specific language.
* Resource Sync, `resync`, used to sync configuration files with CDF through the CLI tool `powerops`.

## Installation

```bash
pip install cognite-power-ops
```

## Configuration

Configuration of the `PowerOpsClient` and `resync` is done through a yaml file and environment variables.

### YAML configuration

The configuration is in `.yaml` format and the path to the configuration file must be explicitly provided. Refer to the [example config file](https://github.com/cognitedata/power-ops-sdk/blob/main/power_ops_config.yaml) for the most up to date example of required fields.

Secrets should not be written directly in this configuration file as the file is intended to be committed to git. Instead use the following syntax to refer to an environment variable as a value.

```yaml
project: "${PROJECT}"
base_url: "https://${CLUSTER}.cognitedata.com"
```

If you are using a `.env` file etc. then you must handle loading the proper environment variables prior to instantiating `PowerOpsClient` or running `resync`.

## Usage

### Run Resync

Refer to the [resync documentation](https://github.com/cognitedata/power-ops-sdk/blob/main/RESYNC.md).

### PowerOpsClient

Using YAML configuration:

```python
from dotenv import load_dotenv
from cognite.powerops.client import PowerOpsClient

load_dotenv()
power_ops_client = PowerOpsClient.from_config("power_ops_config.yaml")

```

Using an existing CogniteClient:

```python
from cognite.powerops.client import PowerOpsClient

# Refer to the Cognite SDK documentation for the different ways to instantiate a CogniteClient
cognite_config = {} # dict with configuration
cognite_client = CogniteClient.load(cognite_config)

# Instantiate PowerOpsClient with existing CogniteClient
power_ops_client = PowerOpsClient(client=cognite_client, read_dataset="xid_dataset", write_dataset="xid_dataset")

```

For more examples on using the PowerOpsClient, see the examples section of the documentation.

## Running Tests

Run the test suite with:

```bash
pytest
```

Most tests run against an in-memory mock of `PowerOpsClient` (`tests/mock_powerops.py`) and don't require CDF access. Tests that do need a real CDF connection are marked with `@pytest.mark.cdf`.

To skip the CDF-dependent tests, e.g. when running locally without CDF credentials configured, use the `--skipcdf` flag. This is also what CI uses:

```bash
pytest --skipcdf
```

