Index
This directory contains the shared Python libraries used across AIOps services.
Use this page as a quick index for what is available in libs/python and how the libraries are connected.
The dependency graph below shows internal runtime dependencies declared in each package pyproject.toml.
A --> B means that package A depends on package B.
Dependency Graph
flowchart LR
subgraph Common
service_context["service-context"]
service_contracts["service-contracts"]
service_observability["service-observability"]
pydantic_settings["pydantic-settings-kit"]
pii_sanitizer["pii-sanitizer"]
protobuf_converters["protobuf-converters"]
utc_datetime["utc-datetime"]
end
subgraph Storage
alembic_testkit["alembic-testkit"]
sqlalchemy_postgres["sqlalchemy-postgres-kit"]
unit_of_work["unit-of-work-kit"]
omni_box["omni-box"]
redis_client["redis-client-kit"]
postgres_partition["postgres-partition-manager"]
end
subgraph Communication
grpc_healthcheck["grpc-healthcheck"]
grpc_interceptor["grpc-interceptor-kit"]
grpc_server["grpc-server-kit"]
grpc_client["grpc-client-kit"]
grpc_stubs["grpc-stubs"]
kafka_publisher["kafka-publisher-kit"]
asgi_mw["asgi-middlewares-kit"]
end
subgraph Runtime
api_core["api-runtime-core"]
fastapi_rt["fastapi-service-runtime"]
grpc_service["grpc-service-runtime"]
dishka_providers["dishka-providers"]
service_warmup["service-warmup"]
apscheduler_runtime["apscheduler-runtime"]
end
dishka_providers --> sqlalchemy_postgres
dishka_providers --> unit_of_work
grpc_interceptor --> service_context
grpc_interceptor --> service_contracts
grpc_service --> grpc_server
grpc_service --> redis_client
grpc_service --> service_observability
grpc_service --> service_warmup
fastapi_rt --> api_core
Library Index
Ссылки ведут на pyproject.toml пакета (или на README.md, если он есть).
| Library | Purpose | Internal dependencies |
|---|---|---|
alembic-testkit |
Alembic migration testing utilities for AIOps platform | - |
api-runtime-core |
Shared API runtime primitives | service-observability, service-warmup |
apscheduler-runtime |
APScheduler runtime helpers for AIOps workers | - |
asgi-middlewares-kit |
ASGI middleware utilities | - |
credential-client |
Credential service client (protocol + optional gRPC) | service-contracts, grpc-client-kit |
dishka-providers |
Generic Dishka providers for AIOps platform infrastructure | sqlalchemy-postgres-kit, unit-of-work-kit, … |
fastapi-service-runtime |
FastAPI service runtime | api-runtime-core, asgi-middlewares-kit, … |
grpc-client-kit |
gRPC client utilities | - |
grpc-healthcheck |
gRPC health check utilities for AIOps platform | - |
grpc-interceptor-kit |
Reusable gRPC interceptors for AIOps platform | service-context, service-contracts |
grpc-server-kit |
Common gRPC server utilities for AIOps platform | - |
grpc-service-runtime |
gRPC server infrastructure for AIOps platform | grpc-server-kit, redis-client-kit, service-observability, service-warmup |
grpc-stubs |
Compiled Python gRPC stubs for all proto services | - |
herald-client |
Herald notification client | service-contracts, grpc-client-kit |
identity-client |
Identity service client | service-contracts, grpc-client-kit |
kafka-publisher-kit |
Kafka producer infrastructure utilities for AIOps platform | - |
pii-sanitizer |
PII masking utilities for AIOps platform | - |
postgres-partition-manager |
PostgreSQL partition lifecycle management with extensible hooks | - |
protobuf-converters |
Common protobuf helpers for AIOps platform | - |
pydantic-settings-kit |
Common Pydantic settings for AIOps platform infrastructure | - |
redis-client-kit |
Redis infrastructure utilities for AIOps platform | - |
service-context |
Request-scoped context variables for AIOps platform | - |
service-contracts |
Common schemas for all services | - |
service-observability |
Logging, metrics, tracing, Sentry (all optional via extras) | - |
service-warmup |
Application warmup utilities for AIOps platform | - |
sqlalchemy-postgres-kit |
PostgreSQL infrastructure utilities for AIOps platform | - |
omni-box |
Unified Outbox/Inbox library for AIOps platform | - |
unit-of-work-kit |
Unit of Work pattern implementation for AIOps platform | - |
utc-datetime |
Standardized date and time utilities for AIOps platform | - |