Traide Core Python

A Python library for core Traide functionality including observability utilities.

Installation

Core Installation

This package can be installed from GitHub:

uv add git+https://github.com/traide/traide-core-python.git

Or add it to your pyproject.toml:

[dependencies]
traide-core-python = {git = "https://github.com/traide/traide-core-python.git"}

Optional Extras

The package supports optional extras for framework-specific integrations:

FastAPI support:

uv add "traide-core-python[fastapi]@git+https://github.com/traide/traide-core-python.git"

Or in pyproject.toml:

[dependencies]
traide-core-python = {git = "https://github.com/traide/traide-core-python.git", extras = ["fastapi"]}

FastStream support:

uv add "traide-core-python[faststream]@git+https://github.com/traide/traide-core-python.git"

Or in pyproject.toml:

[dependencies]
traide-core-python = {git = "https://github.com/traide/traide-core-python.git", extras = ["faststream"]}

Usage

from traide.observability.tracing_config import configure_tracing, TracingType
from traide.observability.logging_config import LoggingConfig, LogType, LogLevel
from traide.observability.sentry_config import SentryConfig, configure_sentry

# Or import everything from observability
from traide.observability import configure_tracing, LoggingConfig, SentryConfig

Development

Install development dependencies:

uv sync --extra dev

Install pre-commit hooks:

uv run pre-commit install

Run all checks:

uv run pre-commit run --all-files

Run tests:

uv run pytest