DET Quant Library

DET Quant Library

Overview

The DET Quant Library is an internal library containing functions and classes that can be used across Quant models.

Exposed Symbols

Some of the package's symbols (i.e. functions, classes, modules, etc.) are exposed via __init__.py files. They can therefore be imported with a more concise notation that does not require specifying their full path.

This section references all exposed symbols, and for each one of them, provides an exhaustive list of the ways they can be imported.

Note: The list below is auto-generated and can be udpated with the following command in the terminal:

poetry run python docs.py

List of Exposed Symbols

Classes:

Battery:
- from detquantlib.assets import Battery
- from detquantlib.assets.battery import Battery
DetDatabase:
- from detquantlib.data import DetDatabase
- from detquantlib.data.databases.detdatabase import DetDatabase
Entsoe:
- from detquantlib.data import Entsoe
- from detquantlib.data.entsoe.entsoe import Entsoe
OutputItem:
- from detquantlib.outputs import OutputItem
- from detquantlib.outputs.outputs_interface import OutputItem
OutputSet:
- from detquantlib.outputs import OutputSet
- from detquantlib.outputs.outputs_interface import OutputSet
PathDefinitions:
- from detquantlib.outputs import PathDefinitions
- from detquantlib.outputs.outputs_interface import PathDefinitions
Sftp:
- from detquantlib.data import Sftp
- from detquantlib.data.sftp.sftp import Sftp
WindTurbine:
- from detquantlib.assets import WindTurbine
- from detquantlib.assets.wind_turbine import WindTurbine
WindTurbineModels:
- from detquantlib.assets import WindTurbineModels
- from detquantlib.assets.wind_turbine import WindTurbineModels

Functions:

list_to_sql_columns:
- from detquantlib.data import list_to_sql_columns
- from detquantlib.data.databases.helpers import list_to_sql_columns
list_to_sql_set:
- from detquantlib.data import list_to_sql_set
- from detquantlib.data.databases.helpers import list_to_sql_set

Configuration

Project Structure

The project mainly follows the standard Poetry structure:

detquantlib
├── pyproject.toml
├── README.md
├── detquantlib
│   └── __init__.py
└── tests
    └── __init__.py

Dependencies

Dependency Manager

Project dependencies are managed by Poetry.

Dependabot

Automated dependency updates are executed with Dependabot.

GitHub Actions

The project's CI/CD pipeline is enforced with GitHub actions workflows.

Workflow: Continuous Integration (CI)

The continuous integration (CI) workflow runs tests to check the integrity of the codebase's content, and linters to check the consistency of its format.

The workflow was inspired by the following preconfigured templates:

Python package: A general workflow template for Python packages.
Poetry action: A GitHub action for installing and configuring Poetry.

Invoke Tasks

The workflow's checks and linters are specified with Invoke tasks, defined in a tasks.py file.

Invoke tasks can be executed directly from the terminal, using the inv (or invoke) command line tool.

For guidance on the available Invoke tasks, execute the following command in the terminal:

inv --list

Use the -h (or --help) argument for help about a particular Invoke task. For example:

inv lint -h

CI Check: Testing

Code changes are tested with the Pytest package.

The CI check is executed with the following Invoke task:

inv test -c

CI Check: Code Formatting

Linters are used to check that the code is properly formatted:

Isort for the imports section
Darglint for the docstrings description
Black for the main code
Pymarkdown for the markdown file README.md

The CI check is executed with the following Invoke task:

inv lint -c

If the CI check fails, execute the following command in the terminal:

inv lint

This command fixes the parts of the code that should be reformatted. Adding the -c (or --check) optional argument instructs the command to only check if parts of the code should be reformatted, without applying any actual changes.

Workflow: Package Publisher

The package publisher workflow checks the validity of package version updates, creates version tags, and publishes package updates to PyPI.

Checking Version Updates

The workflow enforces version control:

The version number is specified via the version field in the pyproject.toml file.
The version number needs to be updated with every new master commit. If the version is not updated, the GitHub workflow will fail.
Version numbers should follow semantic versioning (i.e. X.Y.Z). That is:
- X increments represent major, non-backward compatible updates.
- Y increments represent minor, backward compatible functionality updates.
- Z increments represent patch/bugfix, backward compatible updates.

Creating Version Tags

If the new package version is valid, the workflow automatically creates a new tag for every new master commit.

Publishing Package Updates to PyPI

The workflow automatically publishes every new master commit to PyPI.

Release Notes

When deemed necessary (especially in case of major updates), developers can document code changes in dedicated GitHub release notes.

Release notes can be created via https://github.com/Dynamic-Energy-Trading/detquantlib/releases.

In any case, all codes changes should always be properly described/documented in GitHub issues and/or pull requests.

Metadata

Release files for detquantlib 5.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for detquantlib 5.6.0
File	Size	Uploaded
detquantlib-5.6.0.tar.gz	40.1 kB	Oct 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for detquantlib 5.6.0
File	Interpreter	ABI	Platform	Reset
detquantlib-5.6.0-py3-none-any.whl 47.2 kB Oct 12, 2026	Python 3	none	any	Details

Total release size: 87.4 kB

Release files / detquantlib-5.6.0.tar.gz

Download URL	detquantlib-5.6.0.tar.gz
Size	40.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`0ceb7c67de4ec1b7e723e2c3f31f96c262fc713d8f7ac45e20a12a610d87ae9d`
BLAKE2b-256 checksum How to use checksums	`bf5041bbb444697e5b58408f2f42791a9fc7ce3447b002866fd7761aeb253ce9`
Upload date	Oct 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.5.1 CPython/3.11.17 Linux/6.17.0-1022-azure`

Release files / detquantlib-5.6.0-py3-none-any.whl

Download URL	detquantlib-5.6.0-py3-none-any.whl
Size	47.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5fcff1c086df8acebfe7997227e009af133a92c4dbd20b2b78f6a600abe366ea`
BLAKE2b-256 checksum How to use checksums	`bfe562d8519abe92ddd73c327b958732b896e60d3abf121e06f9aa3ec5839278`
Upload date	Oct 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.5.1 CPython/3.11.17 Linux/6.17.0-1022-azure`