ai4i-core
Consolidated utility libraries for AI4I microservices — a single installable package providing the cross-cutting concerns (FastAPI bootstrap helpers, logging, observability, telemetry, exceptions, and email) shared across the AI4I backend services.
Installation
pip install ai4i-core
Subpackages
| Subpackage | Purpose |
|---|---|
ai4i_core.bootstrap |
FastAPI app-factory helpers: cache, database, Redis, health router, rate limiting, schemas, API versioning |
ai4i_core.context |
Shared contextvars (trace id, tenant id, user id, endpoint path) read by the logging and telemetry layers |
ai4i_core.email |
Provider-agnostic transactional email client (SMTP, console; pluggable providers) |
ai4i_core.exceptions |
Shared exception hierarchy, response envelope, and FastAPI exception handlers |
ai4i_core.logging |
Structured JSON logging with trace/tenant correlation and request middleware |
ai4i_core.observability |
Prometheus metrics collection and ASGI middleware |
ai4i_core.telemetry |
OpenTelemetry tracing, W3C context propagation, OpenSearch query clients |
Usage
from ai4i_core.bootstrap import create_service_app, init_database, init_redis
from ai4i_core.logging import get_logger, RequestMiddleware
from ai4i_core.exceptions import AppError, InsufficientPermissionsError
from ai4i_core.observability import setup_observability, ObservabilityMiddleware
from ai4i_core.telemetry import TraceManager, trace_stage
from ai4i_core.email import EmailClient, EmailMessage
from ai4i_core.context import get_trace_id, get_tenant_id
Each subpackage's __init__.py (__all__) lists its full public surface.
Requirements
- Python
>= 3.11
License
MIT — see LICENSE.
Links
1 maintainer
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 ai4i_core-1.0.6.tar.gz.
File metadata
- Download URL: ai4i_core-1.0.6.tar.gz
- Upload date:
- Size: 53.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a3ac6cb6ba7612f3cf306e61624f9cf251c939ca4e1fe3b884a3880680a2eb75
|
|
| MD5 |
19deae3d072ffa666f428a71db1f1e78
|
|
| BLAKE2b-256 |
0019e98cfb8bea9cc6f23f13df1b0775df7a44a5277b17bfb5acd64cddb5f289
|
File details
Details for the file ai4i_core-1.0.6-py3-none-any.whl.
File metadata
- Download URL: ai4i_core-1.0.6-py3-none-any.whl
- Upload date:
- Size: 70.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
163b13a646057d92c41fafeb672414bdedaba00b4b6aa418b2ba427b65b27abf
|
|
| MD5 |
ca0a63dc81717f3cc4d5c16e0c938fae
|
|
| BLAKE2b-256 |
80c192c909e8e9e4025bedaf1284c54ad6aef926c60bc4602d03f35bdbe246ca
|
