otel-declarative 0.1.2__py3-none-any.whl

otel_declarative/Reporters/structured_reporter.py

@@ -0,0 +1,154 @@
+import logging
+import structlog
+from typing import List, Any, Callable, Type, cast
+from otel_declarative.Logging.logger_factory import LogConfig
+from otel_declarative.constants import ObservabilityInternalNamespace
+from otel_declarative.Infrastructure.async_log_engine import AsyncInfrastructureRegistry
+from otel_declarative.Engines.log_processors import get_otel_context_injectors, get_field_renamer_processor
+from otel_declarative.Models.Log.topology import ProcessorTopology, InjectionLayer, RenamingLayer, ProcessorChain
+from otel_declarative.Models.Log.state import ReporterEngineState
+from otel_declarative.Models.Log.context import LogContext, StructuredLogSettings
+from otel_declarative.Models.Log.constants import LogFormat
+
+
+class StructuredReporterFactory:
+    """
+    结构化日志工厂
+
+    职责:
+        1、配置编排: 聚合运行时配置、服务上下文与 OTel 处理器链
+        2、引擎初始化: 负责 structlog 全局配置的原子化注入
+        3、异步桥接: 协调 AsyncLogInfrastructure 构建非阻塞日志流水线
+        4、记录器分发: 提供符合 structlog 协议的高性能记录器实例
+    """
+    def __init__(self, settings: StructuredLogSettings, log_context: LogContext, base_log_config: LogConfig):
+        """
+        :param settings: 结构化日志引擎全局设置模型
+        :param log_context: 服务身份元数据上下文
+        :param base_log_config: 基础日志配置
+        """
+        self._settings: StructuredLogSettings = settings
+        self._log_context: LogContext = log_context
+        self._base_config: LogConfig = base_log_config
+        # 初始化引擎状态为 '待命' 快照, 消除离散布尔变量
+        self._state: ReporterEngineState = ReporterEngineState.create_initial(_format=settings.log_format)
+
+    def setup(self) -> None:
+        """
+        执行结构化日志系统的全量初始化流
+
+        [Fix]
+        逻辑:
+            1、原子检查: 确保全局配置仅执行一次
+            2、异步链路预热: 通过 AsyncInfrastructureRegistry 构建非阻塞的 QueueHandler
+            3、2026.01.15 - 逻辑更改 - 流水线拆解与重组:
+                - 分别获取上游组件 Context Injectors 与下游组件 Field Renamer
+                - 调用 _build_full_processor_chain 执行拓扑排序, 解决 EventRenamer 竞争条件
+            4、配置注入: 将完整的处理器链与物理异步 Sink 绑定至 structlog 全局单例
+            5、状态切换: 原子替换引擎快照, 标记系统就绪
+        """
+        if self._state.is_ready:
+            return
+
+        # --- 1、构建底层异步 Handler (IoC 桥接 LoggerFactory) ---
+        async_handler: logging.Handler = self._build_physical_async_sink()
+
+        # --- 2、编排全链路观测处理器链 (基于分层容器模型) ---
+        injection_layer: InjectionLayer = get_otel_context_injectors(field_mapping=self._settings.field_mapping, log_context=self._log_context)
+        renaming_layer: RenamingLayer = get_field_renamer_processor(field_mapping=self._settings.field_mapping)
+        topology = ProcessorTopology(injection_layer=injection_layer, renaming_layer=renaming_layer)
+        final_chain: ProcessorChain = topology.to_chain()
+        processor_list: List[Callable] = final_chain.unwrap()
+
+        # --- 3、执行底层核心库配置注入 ---
+        self._configure_structlog_core(processor_list, async_handler)
+
+        # --- 4、原子替换状态快照, 确保线程安全 ---
+        self._state = ReporterEngineState(
+            is_ready=True,
+            active_format=self._settings.log_format,
+            processor_count=len(processor_list),
+            has_async_infra=self._settings.enable_async
+        )
+
+    def get_logger(self, name: str = "otel.declarative") -> structlog.BoundLogger:
+        """
+        获取一个预配置完成的结构化记录器实例
+
+        提供 Fail-safe 保护: 若引擎未就绪, 将自动触发引导流
+
+        :parma name: 记录器逻辑名称, 用于在日志中标识模块
+        :return: 具备异步能力, 携带 TraceID 与服务元数据的 structlog 记录器
+        """
+        if not self._state.is_ready:
+            self.setup()
+
+        root_ns = ObservabilityInternalNamespace.DEFAULT_LAYER.value
+        if not name.startswith(root_ns):
+            namespaced_name = f"{root_ns}.{name}"
+        else:
+            namespaced_name = name
+        return structlog.get_logger(namespaced_name)
+
+    @property
+    def state(self) -> ReporterEngineState:
+        """
+        暴露当前引擎的只读运行状态快照
+
+        :return: ReporterEngineState 实例
+        """
+        return self._state
+
+    # --- 内部组件编排逻辑 ---
+
+    def _build_physical_async_sink(self) -> logging.Handler:
+        """
+        协调异步基础设置管理器构建非阻塞输出句柄
+
+        :return: 配置完成的 QueueHandler 实例
+        """
+        infra_manager = AsyncInfrastructureRegistry.get_infrastructure(settings=self._settings, log_config=self._base_config)
+        return infra_manager.build_async_handler()
+
+    def _configure_structlog_core(self, processors: List[Callable], sink_handler: logging.Handler) -> None:
+        """
+        执行 structlog 全局单例的底层配置注入, 完成 stdlib logging 的桥接
+
+        :param processors: 已排序并封装的处理器 Callable 列表
+        :param sink_handler: 异步消费端 QueueHandler
+        """
+        # 1、获取并配置统一的业务根  Logger
+        root_ns = ObservabilityInternalNamespace.DEFAULT_LAYER.value
+        root_business_logger = logging.getLogger(root_ns)
+
+        # 2、挂载异步 Sink
+        root_business_logger.handlers.clear()
+        root_business_logger.addHandler(sink_handler)
+
+        # 3、实施隔离, 禁止向 root logger 冒泡
+        root_business_logger.propagate = False
+        root_business_logger.setLevel(logging.NOTSET)
+
+        # 4、根据配置模型选择最终渲染器策略
+        renderer: Callable = (
+            structlog.processors.JSONRenderer() if self._settings.log_format == LogFormat.JSON
+            else structlog.dev.ConsoleRenderer(colors=True)
+        )
+
+        # 3、解包处理器链并注入全局配置
+        structlog.configure(
+            processors=processors + [renderer],
+            # 使用 stdlib 工厂，它会自动将 get_logger("A") 映射为 logging.getLogger("A")
+            # 配合 get_logger 方法中的命名空间前缀注入，实现路由闭环
+            logger_factory=structlog.stdlib.LoggerFactory(),
+            # 消除协议不匹配警告:
+            # 强转 stdlib.BoundLogger 以匹配 structlog 严格的 BindableLogger 协议
+            wrapper_class=cast(Type[structlog.typing.BindableLogger], cast(Any, structlog.stdlib.BoundLogger)),
+            cache_logger_on_first_use=True,
+        )
+
+    def __repr__(self) -> str:
+        """
+        提供可监测的工厂状态摘要
+        """
+        return str(self._state)

otel_declarative/__init__.py

@@ -0,0 +1,13 @@
+from otel_declarative.provider import ObservabilityProvider
+from otel_declarative.settings import ObservabilitySettings
+from otel_declarative.Factories.extractor_factory import ExtractorFactory
+from otel_declarative.Reporters.structured_reporter import StructuredReporterFactory
+from otel_declarative.Models.summary_models import BaseSummary
+
+__all__ = [
+    "ObservabilityProvider",
+    "ObservabilitySettings",
+    "ExtractorFactory",
+    "StructuredReporterFactory",
+    "BaseSummary",
+]

otel_declarative/constants.py

@@ -0,0 +1,79 @@
+from enum import Enum, unique
+
+@unique
+class OtelProtocol(str, Enum):
+    """
+    OpenTelemetry 传输协议枚举
+    """
+    GRPC = "grpc"
+    HTTP = "http"
+
+@unique
+class OtelSecurityMode(str, Enum):
+    """
+    OpenTelemetry 传输安全模式
+    """
+    # 明文传输, 适合 K8S Pod 间本地通信
+    INSECURE = "insecure"
+    # 加密传输, 带有证书校验, 适合跨机房或外网
+    TLS = "tls"
+
+@unique
+class TraceStatus(str, Enum):
+    """
+    追踪执行状态枚举
+
+    用于标准化 OTel Span 的最终状态标签
+    """
+    # 业务逻辑正常完成且耗时在 SLA 范围内
+    SUCCESS = "success"
+    # 捕获到业务逻辑错误或系统级未处理异常
+    FAILED = "failed"
+    # 业务逻辑虽然成功, 但执行时间超过预设的慢查询阈值
+    SLOW = "slow_threshold"
+
+@unique
+class TraceStage(str, Enum):
+    """
+    追踪生命周期阶段枚举
+
+    定义数据路径拦截器在执行过程中的核心拦截点
+    """
+    # 阶段 1: 拦截器启动阶段, 执行参数捕获
+    PRE = "PRE_EXECUTE"
+    # 阶段 2: 业务成功返回节点, 执行结果摘要提取
+    POST = "POST_EXECUTE"
+    # 阶段 3: 异常触发阶段, 执行堆栈跟踪与现场快照记录
+    ERROR = "ERROR_EXECUTE"
+
+@unique
+class ExtractionSource(str, Enum):
+    """
+    声明式提取源枚举
+
+    职责:
+        1、定义路径解析引擎在执行 JMEPath 检索时的定义命名空间
+        2、确保声明式 YAML 配置中的提取路径具有统一的根起点
+    """
+    # 代指业务函数的位置参数列表
+    ARGS = "args"
+    # 代指业务函数的关键字参数字典
+    KWARGS = "kwargs"
+    # 代指业务函数执行完成后的返回值对象
+    RESULTS = "results"
+    # 代指操作系统环境变量空间
+    ENV = "env"
+    # 代指被探测对象的运行时 Python 类型信息
+    TYPE = "type"
+
+@unique
+class ObservabilityInternalNamespace(str, Enum):
+    """
+    观测引擎内部专用空间枚举
+
+    职责: 统一管理系统内部使用的逻辑标识符, 消除魔术字符串
+    """
+    # structlog 与 stdlib logging 之间的异步桥接节点名称
+    LOG_BRIDGE = "structlog.bridge"
+    # 默认观测层级名称
+    DEFAULT_LAYER = "otel.declarative"

otel_declarative/provider.py

@@ -0,0 +1,217 @@
+import time
+import functools
+import structlog
+from datetime import datetime, timezone
+from typing import Any, Callable, Optional, TypeVar, cast, Dict
+from opentelemetry import trace
+from opentelemetry.trace import Status, StatusCode, Span, Tracer
+from otel_declarative.settings import ObservabilitySettings
+from otel_declarative.constants import TraceStatus, TraceStage
+from otel_declarative.Models.summary_models import InputSummary, OutputSummary
+from otel_declarative.Factories.extractor_factory import ExtractorFactory
+from otel_declarative.Interfaces.extractor import IExtractor
+from otel_declarative.Reporters.structured_reporter import StructuredReporterFactory
+
+T = TypeVar("T", bound=Callable[..., Any])
+
+class ObservabilityProvider:
+    """
+    观测性组件提供者
+
+    职责:
+        1、链路编排: 管理 OpenTelemetry Span 的生命周期
+        2、策略映射: 调用 ExtractorFactory 为不同业务层级匹配声明式提取器
+        3、属性注入: 将提取出的强类型摘要数据转换为 Span Attributes
+        4、性能剖析: 自动度量业务函数的执行耗时并执行 SLA 判定
+    """
+    def __init__(self, settings: ObservabilitySettings, extractor_factory: ExtractorFactory, reporter_factory: StructuredReporterFactory):
+        """
+        :param settings: 观测性全局配置对象
+        :param extractor_factory: 预初始化完成的策略提取器工厂
+        :param reporter_factory: 具备异步桥接能力的结构化记录器工厂
+        """
+        self._settings: ObservabilitySettings = settings
+        self._extractor_factory: ExtractorFactory = extractor_factory
+        self._reporter_factory: StructuredReporterFactory = reporter_factory
+        # 获取标准 OTel Tracker 单例
+        self._tracer: Tracer = trace.get_tracer(self._settings.service_name)
+        # 初始化基础设施层记录器
+        self._infra_logger = self._reporter_factory.get_logger("otel_declarative.Infrastructure")
+
+    def trace_data_path(self, layer: str) -> Callable[[T], T]:
+        """
+        构造数据路径追踪切片的异步装饰器
+
+        逻辑:
+            1、透明拦截异步函数调用现场
+            2、自动获取对应层级的结构化 BoundLogger
+            3、管理全生命周期中的 PRE >> EXECUTE >> POST / ERROR 观测流
+            4、自动清理上下文环境
+
+        :param layer: 逻辑分层标识符 (需在 YAML 配置中定义对应的映射规则)
+        :return: 异步函数装饰器
+        """
+        def decorator(func: T) -> T:
+            @functools.wraps(func)
+            async def wrapper(*args: Any, **kwargs: Any) -> Any:
+                if not self._settings.enable_tracing:
+                    return await func(*args, **kwargs)
+
+                # 每次调用前先清理上下文, 防止线程复用污染
+                structlog.contextvars.clear_contextvars()
+                log = self._reporter_factory.get_logger(layer)
+
+                # 启动 OTel Span
+                # 注: Span 名称约定使用 'Layer.FunctionName' 格式, 以优化 Jaeger 展示
+                span_name = f"{layer}.{func.__qualname__}"
+                with self._tracer.start_as_current_span(span_name) as span:
+                    # 执行 PRE 阶段
+                    extractor: Optional[IExtractor] = self._handle_pre_execute(
+                        span=span,
+                        layer=layer,
+                        args=args,
+                        kwargs=kwargs,
+                        log=log
+                    )
+
+                    start_pref = time.perf_counter()
+                    try:
+                        # 执行业务主逻辑
+                        result = await func(*args, **kwargs)
+
+                        # 执行 POST 阶段
+                        execution_duration = time.perf_counter() - start_pref
+                        self._handle_post_execute(
+                            span=span,
+                            layer=layer,
+                            extractor=extractor,
+                            result=result,
+                            duration_sec=execution_duration,
+                            log=log
+                        )
+
+                        return result
+                    except Exception as e:
+                        self._handle_error_execute(
+                            span=span,
+                            layer=layer,
+                            exception=e,
+                            log=log
+                        )
+                        raise e
+                    finally:
+                        structlog.contextvars.clear_contextvars()
+
+            return cast(T, wrapper)
+        return decorator
+
+    def _handle_pre_execute(self, span: Span, layer: str, args: Any, kwargs: Any, log: Any) -> Optional[IExtractor]:
+        """
+        处理进入业务函数前的观测逻辑
+
+        :param span: 当前活跃的 Span 实例
+        :param layer: 逻辑层级标识
+        :param args: 原始位置参数
+        :param kwargs: 原始关键字参数
+        :param log: 绑定的结构化记录器实例
+        :return: 匹配到的通用提取器实例 (供 POST 阶段复用)
+        """
+        try:
+            # 从工厂获取声明式提取器
+            extractor: Optional[IExtractor] = self._extractor_factory.get_extractor(layer)
+            if not extractor:
+                return None
+
+            # 执行基于 YAML 规则的数据提取
+            input_dto: InputSummary = extractor.extract_input(args, kwargs)
+
+            # 注入 OTel 属性
+            attributes: Dict[str, Any] = input_dto.to_otel_attributes()
+            for k, v in attributes.items():
+                span.set_attribute(k, v)
+            # 将提取的业务上下文绑定至 structlog
+            structlog.contextvars.bind_contextvars(**attributes)
+            log.info(f"观测切面入口触发", stage=TraceStage.PRE.value, **attributes)
+
+            # 记录生命周期事件
+            span.add_event(TraceStage.PRE.value, {"at": datetime.now(timezone.utc).isoformat()})
+            return extractor
+        except Exception:
+            self._infra_logger.exception(f"观测路径提取失败 [PRE]", layer=layer, stage=TraceStage.PRE.value)
+            return None
+
+    def _handle_post_execute(self, span: Span, layer: str, extractor: Optional[IExtractor], result: Any, duration_sec: float, log: Any) -> None:
+        """
+        处理业务成功返回后的观测逻辑
+
+        :param span: 当前活跃的 Span 实例
+        :param layer: 逻辑层级标识
+        :param extractor: 之前匹配到的提取器
+        :param result: 业务执行结果
+        :param duration_sec: 业务逻辑真实执行时长
+        :param log: 绑定的结构化记录器实例
+        """
+        try:
+            # 1、提取输出摘要
+            output_attributes: Dict[str, Any] = {}
+            if extractor:
+                output_dto: OutputSummary = extractor.extract_output(result)
+                output_attributes = output_dto.to_otel_attributes()
+                # 修正: 循环调用单数形式的 set_attribute 以符合 API 签名
+                for k, v in output_dto.to_otel_attributes().items():
+                    span.set_attribute(k, v)
+
+            # 2、性能画像与 SLA 判定
+            duration_ms = duration_sec * 1000
+            span.set_attribute("performance.duration_ms", duration_ms)
+
+            trace_status_value: str
+            if duration_sec > self._settings.slow_query_threshold:
+                trace_status_value = TraceStatus.SLOW.value
+                span.set_attribute("trace.status", TraceStatus.SLOW.value)
+                span.set_status(Status(StatusCode.OK, f"SLA Violation: {duration_ms:.2f}ms"))
+            else:
+                trace_status_value = TraceStatus.SUCCESS.value
+                span.set_attribute("trace.status", TraceStatus.SUCCESS.value)
+                span.set_status(Status(StatusCode.OK))
+
+            log.info(
+                f"观测切面执行完成",
+                stage=TraceStage.POST.value,
+                latency=f"{duration_ms:.2f}ms",
+                trace_status=trace_status_value,
+                **output_attributes,
+            )
+
+
+            span.add_event(TraceStage.POST.value, {"latency": f"{duration_ms:.2f}ms"})
+        except Exception:
+            self._infra_logger.exception(f"观测路径提取失败 [POST]", layer=layer, stage=TraceStage.POST.value)
+
+    def _handle_error_execute(self, span: Span, layer: str, exception: Exception, log: Any) -> None:
+        """
+        处理业务逻辑崩溃时的异常观测逻辑
+
+        :param span: 当前活跃的 Span 实例
+        :param layer: 业务逻辑层级标识
+        :param exception: 捕获到的异常对象
+        :param log: 绑定的结构化记录器实例
+        """
+        # 设置 Span 状态为错误, 触发下游报警
+        span.set_status(Status(StatusCode.ERROR, str(exception)))
+        span.set_attribute("trace.status", TraceStatus.FAILED.value)
+        # 自动记录异常堆栈
+        span.record_exception(exception)
+
+        # 记录生命周期事件并附加异常信息
+        log.error(
+            f"观测切面业务崩溃",
+            stage=TraceStage.ERROR.value,
+            exception=type(exception).__name__,
+            exception_message=str(exception),
+            exc_info=True
+        )
+        span.add_event(TraceStage.ERROR.value, {
+            "exception.type": type(exception).__name__,
+            "exception.message": str(exception)
+        })

otel_declarative/settings.py

@@ -0,0 +1,150 @@
+import os
+import logging
+from typing import Optional, List, Dict
+from pydantic_settings import BaseSettings, SettingsConfigDict
+from pydantic import Field, field_validator, BaseModel, ConfigDict
+from otel_declarative.constants import OtelProtocol, OtelSecurityMode
+
+class OtelExporterSettings(BaseModel):
+    """
+    OpenTelemetry 导出器专用子模型
+
+    职责:
+        1、封装 OTLP 导出相关的传输协议、端点与安全配置
+        2、集中管理 TLS 证书路径等敏感信息
+    """
+    model_config = ConfigDict(frozen=True)
+
+    endpoint: str = Field(
+        default="http://otel-collector.monitoring:4317",
+        description="OTLP Collector 的接受端点"
+    )
+
+    protocol: OtelProtocol = Field(
+        default=OtelProtocol.GRPC,
+        description="传输协议类型: grpc 或 http"
+    )
+
+    security_mode: OtelSecurityMode = Field(
+        default=OtelSecurityMode.INSECURE,
+        description="传输安全模式: insecure 或 tls"
+    )
+
+    # --- TLS 专用配置 ---
+    ca_certificate_path: Optional[str] = Field(
+        default=None,
+        description="CA 根证书路径, 若开启 TLS 且该值为空, 则使用系统默认 CA 束"
+    )
+
+    client_key_path: Optional[str] = Field(
+        default=None,
+        description="客户端证书路径 (双向 TLS 认证专用)"
+    )
+
+    # --- OTLP 自定义 Header 支持 ---
+    headers: Optional[Dict[str, str]] = Field(
+        default_factory=dict,
+        description="OTLP 导出器自定义 HTTP Header, 常用于鉴权 (如: {'Authorization': 'Bearer token'})"
+    )
+
+class ObservabilitySettings(BaseSettings):
+    """
+    观测性全局配置对象
+
+    职责:
+        1、定义 OpenTelemetry 的基础导出参数
+        2、定义性能判定阈值与采样策略
+        3、定义声明式映射规则文件的存储路径
+    """
+    # --- 基础配置 ---
+    enable_tracing: bool = Field(
+        default=True,
+        description="全链路追踪全局开关。设置为 False 时，装饰器将进入透传模式，不产生任何 Span 或属性"
+    )
+    service_name: str = Field(
+        default="deepstream-worker-sidecar",
+        description="向 OpenTelemetry 注册的服务唯一标识"
+    )
+
+    # --- 性能判定与采样策略 ---
+    slow_query_threshold: float = Field(
+        default=0.5,
+        ge=0.0,
+        description="慢查询判定阈值 (s), 当执行耗时超过该值时, TraceStatus 将被标记为 SLOW"
+    )
+    sampling_rate: float = Field(
+        default=1.0,
+        ge=0.0,
+        le=1.0,
+        description="追踪采样率 (0.0 - 1.0), 针对高频元数据路径, 适当调低以优化 CPU/IO"
+    )
+
+    # --- 策略化提取引擎注册表 ---
+    mapping_config_path: str = Field(
+        default="config/observability_mapping.yaml",
+        description="存储声明式观测数据提取映射规则的 YAML 配置文件路径"
+    )
+
+    otel: OtelExporterSettings = Field(
+        default_factory=OtelExporterSettings,
+        description="OpenTelemetry 传输层详细设置"
+    )
+
+    # --- 第三方专业库集成配置 ---
+    enable_dateparser: bool = Field(
+        default=True,
+        description="是否启用 dateparser 增强时间戳解析能力"
+    )
+
+    enable_humanize: bool = Field(
+        default=True,
+        description="是否启用 humanize 实现日志数据的可读化转换"
+    )
+
+    use_glom_spec: bool = Field(
+        default=True,
+        description="是否允许在转换阶段使用 glom 声明式结构转换"
+    )
+
+    # 默认时间时区配置
+    default_timezone: str = Field(
+        default="UTC",
+        description="解析模糊时间字符串时的默认时区"
+    )
+
+    # 模型扫描路径配置
+    model_scan_paths: List[str] = Field(
+        default=["Core.Infrastructure.otel_declarative.Models"],
+        description="解析引擎启动时应自动扫描并注册模型的模块路径列表"
+    )
+
+    # --- 配置模型行为定义 ---
+    model_config = SettingsConfigDict(
+        env_prefix="OBS_",
+        case_sensitive=False,
+        frozen=True,
+        extra="ignore"
+    )
+
+    @field_validator("mapping_config_path")
+    @classmethod
+    def validate_mapping_file_exists(cls, v: str) -> str:
+        """
+        验证器: 确保声明式映射配置文件在本地文件系统中真实存在
+
+        :param v: 验证后的文件路径字符串
+        :return: 验证后的路径字符串
+        """
+        if not os.path.isabs(v):
+            logging.warning(
+                f"[otel_declarative Config] 映射规则路径 '{v}' 不是绝对路径"
+                f"在高动态环境 (如 K8S) 下建议使用绝对路径以避免环境歧义"
+            )
+
+        if not os.path.exists(v):
+            logging.warning(
+                f"[otel_declarative Config] 映射规则文件未找到: '{v}'"
+                f"观测引擎将切换至 '零规则' 模式, 仅记录基础 Span 属性"
+            )
+
+        return v

otel_declarative-0.1.2.dist-info/METADATA

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: otel-declarative
+Version: 0.1.2
+Summary: Industrial-grade, declarative OpenTelemetry instrumentation and structured logging engine for Python.
+Author-email: Your Name <giangminh443836@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 YaoYuanZheng
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/vancer17/otel-declarative.git
+Project-URL: Repository, https://github.com/vancer17/otel-declarative.git
+Project-URL: Issues, https://github.com/vancer17/otel-declarative.git
+Keywords: opentelemetry,observability,tracing,logging,declarative,pydantic,structlog
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: opentelemetry-api>=1.20.0
+Requires-Dist: opentelemetry-sdk>=1.20.0
+Requires-Dist: opentelemetry-exporter-otlp>=1.20.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: structlog>=23.1.0
+Requires-Dist: jmespath>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: dateparser>=1.1.0
+Requires-Dist: humanize>=4.0.0
+Requires-Dist: glom>=23.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: types-PyYAML; extra == "dev"
+Requires-Dist: types-requests; extra == "dev"
+Dynamic: license-file
+
+# OTel Declarative
+
+Industrial-grade, declarative OpenTelemetry instrumentation and structured logging engine for Python.
+
+## Documentation
+
+Please visit our [GitHub Repository](https://github.com/vancer17/otel-declarative.git) for full documentation, usage examples, and architecture details.
+
+## Installation
+
+pip install otel-declarative