Utilities for easier development of extractors for CDF
Project description
Cognite Python extractor-utils
The extractor-utils package is an extension of the Cognite Python SDK intended to simplify the development of data
extractors or other integrations for Cognite Data Fusion.
Documentation is hosted here, including a quickstart tutorial.
The changelog is found here.
Overview
The best way to start a new extractor project is to use the cogex CLI. You can install that from PyPI:
pip install cognite-extractor-manager
To initialize a new extractor project, run
cogex init
in the directory you want your extractor project in. The cogex CLI will prompt you for some information about your
project, and then set up a poetry environment, git repository, commit hooks with type and style checks and load a
template.
Contributing
The package is open source under the Apache 2.0 license, and contribtuions are welcome.
This project adheres to the Contributor Covenant v2.0 as a code of conduct.
Development environment
We use uv to manage dependencies and to administrate virtual environments. To develop
extractor-utils, follow the following steps to set up your local environment:
-
Install uv if you haven't already.
-
Clone repository:
$ git clone git@github.com:cognitedata/python-extractor-utils.git -
Move into the newly created local repository:
$ cd python-extractor-utils -
Create virtual environment and install dependencies:
$ uv sync
Code requirements
All code must pass black and isort style checks to be merged. It is recommended to install pre-commit hooks to ensure this locally before commiting code:
$ poetry run pre-commit install
Each public method, class and module should have docstrings. Docstrings are written in the Google style. Please include unit and/or integration tests for submitted code, and remember to update the changelog.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cognite_extractor_utils-7.12.1.tar.gz.
File metadata
- Download URL: cognite_extractor_utils-7.12.1.tar.gz
- Upload date:
- Size: 92.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2f47acb0fc7e069a8a9b59898d8111eb444018456bf298db6fd84d4d894a209a
|
|
| MD5 |
ed01110bba2f026d4490d63c7b82c05e
|
|
| BLAKE2b-256 |
d70b8180a329a298cde0f4e3876497ccbf61bf8532ad28cfdf93d040c0c49fd7
|
File details
Details for the file cognite_extractor_utils-7.12.1-py3-none-any.whl.
File metadata
- Download URL: cognite_extractor_utils-7.12.1-py3-none-any.whl
- Upload date:
- Size: 125.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ed18296cbc25a690b5ead20f73d33c926512e5b17a848d7c8724200df97be94f
|
|
| MD5 |
ffa734eee230d9de59aa1af1e6077604
|
|
| BLAKE2b-256 |
50fea6029dd9e673ae68d43beea660a35c568a20cb48c3704e0e2550cbfbdde2
|
