evan-logger 0.1.1__tar.gz

evan_logger-0.1.1/LICENSE

@@ -0,0 +1 @@
+MIT License.

evan_logger-0.1.1/PKG-INFO

@@ -0,0 +1,311 @@
+Metadata-Version: 2.4
+Name: evan-logger
+Version: 0.1.1
+Summary: Structured colored logger with trace/span context and sampling
+Author-email: Evan <e2002florespulido@gmail.com>
+License: MIT License.
+Project-URL: Homepage, https://github.com/EvanFloresLv/Logger.git
+Project-URL: Repository, https://github.com/EvanFloresLv/Logger.git
+Keywords: logging,colorlog,structured-logging,trace
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: tomli>=2.4.0
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: colorlog>=6.7.0
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: pytest>=9.0.2
+Dynamic: license-file
+
+# Project logger
+
+A production-ready Python logging framework designed for modern backends and AI pipelines.
+
+It supports:
+- Structured JSON logs (ELK / GCP Logging / Datadog ready)
+- Trace + Span IDs (contextvars, async-safe)
+- Automatic context (file:line Class.method())
+- Per-module log levels
+- Sampling filters for hot paths (reduce noise + cost)
+
+---
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Architecture](#architecture)
+- [Features](#features)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Configuration](#configuration)
+- [Project Structure](#project-structure)
+- [Development](#development)
+- [Testing](#testing)
+- [Deployment](#deployment)
+- [Roadmap](#roadmap)
+- [Contributing](#contributing)
+- [License](#license)
+- [Contact](#contact)
+
+---
+
+## Overview
+
+This project provides a clean, extensible logging layer for Python services.
+
+It’s built to solve common production pain points:
+- Logs without structure are hard to search
+- Async + threads break context
+- Trace correlation is missing
+- Hot loops spam logs and increase cloud costs
+- Large codebases need per-module control
+
+This logger provides a single unified API for:
+- console logs (pretty + colored)
+- file logs (JSON structured)
+- trace/span correlation
+- sampling
+
+---
+
+## Architecture
+
+```
+LoggerConfig
+    ↓
+Logger (singleton)
+    ↓
+logging.Logger (stdlib)
+    ↓
+Handlers
+    ├── Console handler (colored)
+    └── File handler (.log or .json)
+    ↓
+Filters
+    └── SamplingFilter
+    └── DeterministicFilter
+    ↓
+ContextLogger (LoggerAdapter)
+    ├── context
+    ├── trace_id
+    └── span_id
+```
+
+### Core Components:
+
+1. **API Layer:** Interfaces (CLI, SDK, REST) for uploading and managing files
+2. **Service Layer:** Business logic for versioning and lifecycle rules
+3. **Repository Layer:** Abstract persistence interfaces for storage and metadata
+4. **Infrastructure Layer:** Cloud storage providers and NoSQL database adapters
+
+---
+
+## Features
+
+1. Structured JSON logging
+    - Compatible with ELK, GCP Logging, Datadog, Splunk
+    - Includes context, trace_id, span_id, module, function, line, exception
+
+2. Trace + Span IDs
+    - Uses contextvars (async-safe)
+    - Supports manual trace/span injection
+
+3. Automatic context resolution
+    - Adds file:line Class.method() automatically
+    - Works for functions, methods, decorators
+
+4. Per-module log levels
+    - Example: src.core=WARNING while the rest stays INFO
+
+5. Sampling filter
+    - Sample DEBUG/INFO logs for noisy paths
+    - Always keep WARNING/ERROR/CRITICAL
+
+6. Singleton logger factory
+    - Global configuration
+    - Safe Logger.configure(...) entrypoint
+
+---
+
+## Installation
+```bash
+pip install <url>
+```
+
+
+Or install from source:
+
+```bash
+git clone <url>
+cd project-name
+pip install -e .
+```
+
+---
+
+### Usage
+
+Basic setup
+```python
+import logging
+from src.logger import Logger
+from src.config import LoggerConfig
+
+Logger.configure(
+    LoggerConfig(
+        name="app",
+        level=logging.INFO,
+        directory="logs",
+        json_logs=True,
+        sample_rate=0.2,
+        module_levels={
+            "src.core": logging.WARNING,
+        },
+    )
+)
+
+logger = Logger().bind("startup")
+logger.info("Service initialized")
+```
+
+Trace + ID span
+
+```python
+from src.logger import Logger
+
+log = Logger()
+log.set_trace()
+log.set_span()
+
+logger = log.bind("request")
+logger.info("Request started")
+```
+
+JSON logs example output
+```json
+{
+  "timestamp": "2026-02-04T10:55:01.140Z",
+  "level": "INFO",
+  "message": "Request started",
+  "logger": "app",
+  "context": "api.py:88 EDDController.calculate()",
+  "trace_id": "a1f29c...",
+  "span_id": "91c77d...",
+  "module": "api",
+  "function": "calculate",
+  "line": 88
+}
+```
+
+---
+
+### Configuration
+
+Configuration is done through LoggerConfig.
+
+Example:
+
+```python
+from src.config import LoggerConfig
+
+config = LoggerConfig(
+    name="service",
+    directory="logs",
+    json_logs=True,
+    sample_rate=0.1,
+    level=logging.INFO,
+    module_levels={
+        "src.core": logging.WARNING,
+        "google": logging.ERROR,
+        "httpx": logging.ERROR,
+    },
+)
+```
+
+Key settings
+
+| Field          | Meaning                                        |
+|----------------|------------------------------------------------|
+| json_logs      | Output JSON logs for file handler              |
+| directory      | Where log files are stored                     |
+| deterministic  | Enable deterministic logging                   |
+| sample_rate    | Sampling probability for INFO/DEBUG            |
+| module_levels  | Per-module log level override                  |
+| level          | Global log level                               |
+| name           | Logger name                                    |
+
+---
+
+### Project Structure
+
+```
+src/
+ ├── logger.py              # Logger singleton + ContextLogger
+ ├── config.py              # LoggerConfig + JSONFormatter + SamplingFilter
+ ├── core/
+ │    ├── filters.py        # Log filtering logic
+ │    ├── formatters.py     # Log formatting logic
+ │    └── tracer.py         # contextvars trace_id/span_id
+ └── decorators/
+      ├── functions.py      # function_log decorator
+      └── classes.py        # class_log decorator
+
+```
+---
+
+### Development
+```bash
+pip install -r requirements-dev.txt
+```
+
+---
+
+### Testing
+```
+pytest tests/
+```
+
+---
+
+### Deployment
+
+The service can be deployed as:
+
+```
+Python SDK library
+FastAPI microservice
+Serverless function (Cloud Run / Lambda / Azure Functions)
+Internal data platform component
+```
+
+---
+
+### Roadmap
+
+1. Request middleware integration for Flask/FastAPI
+2. Deterministic sampling by trace_id (avoid partial traces)
+3. Rotating file handler support
+4. OpenTelemetry bridge
+5. Log batching / async writer for high throughput
+
+---
+
+### Contributing
+
+Contributions are welcome.
+Please follow the coding standards and submit PRs with tests and documentation updates.
+
+---
+
+### License
+
+MIT License.
+
+---
+
+### Contact
+
+Maintainer: Evan Flores
+Email: *efloresp06@liverpool.com.mx*
+Organization: **Liverpool**

evan_logger-0.1.1/README.md

@@ -0,0 +1,291 @@
+# Project logger
+
+A production-ready Python logging framework designed for modern backends and AI pipelines.
+
+It supports:
+- Structured JSON logs (ELK / GCP Logging / Datadog ready)
+- Trace + Span IDs (contextvars, async-safe)
+- Automatic context (file:line Class.method())
+- Per-module log levels
+- Sampling filters for hot paths (reduce noise + cost)
+
+---
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Architecture](#architecture)
+- [Features](#features)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Configuration](#configuration)
+- [Project Structure](#project-structure)
+- [Development](#development)
+- [Testing](#testing)
+- [Deployment](#deployment)
+- [Roadmap](#roadmap)
+- [Contributing](#contributing)
+- [License](#license)
+- [Contact](#contact)
+
+---
+
+## Overview
+
+This project provides a clean, extensible logging layer for Python services.
+
+It’s built to solve common production pain points:
+- Logs without structure are hard to search
+- Async + threads break context
+- Trace correlation is missing
+- Hot loops spam logs and increase cloud costs
+- Large codebases need per-module control
+
+This logger provides a single unified API for:
+- console logs (pretty + colored)
+- file logs (JSON structured)
+- trace/span correlation
+- sampling
+
+---
+
+## Architecture
+
+```
+LoggerConfig
+    ↓
+Logger (singleton)
+    ↓
+logging.Logger (stdlib)
+    ↓
+Handlers
+    ├── Console handler (colored)
+    └── File handler (.log or .json)
+    ↓
+Filters
+    └── SamplingFilter
+    └── DeterministicFilter
+    ↓
+ContextLogger (LoggerAdapter)
+    ├── context
+    ├── trace_id
+    └── span_id
+```
+
+### Core Components:
+
+1. **API Layer:** Interfaces (CLI, SDK, REST) for uploading and managing files
+2. **Service Layer:** Business logic for versioning and lifecycle rules
+3. **Repository Layer:** Abstract persistence interfaces for storage and metadata
+4. **Infrastructure Layer:** Cloud storage providers and NoSQL database adapters
+
+---
+
+## Features
+
+1. Structured JSON logging
+    - Compatible with ELK, GCP Logging, Datadog, Splunk
+    - Includes context, trace_id, span_id, module, function, line, exception
+
+2. Trace + Span IDs
+    - Uses contextvars (async-safe)
+    - Supports manual trace/span injection
+
+3. Automatic context resolution
+    - Adds file:line Class.method() automatically
+    - Works for functions, methods, decorators
+
+4. Per-module log levels
+    - Example: src.core=WARNING while the rest stays INFO
+
+5. Sampling filter
+    - Sample DEBUG/INFO logs for noisy paths
+    - Always keep WARNING/ERROR/CRITICAL
+
+6. Singleton logger factory
+    - Global configuration
+    - Safe Logger.configure(...) entrypoint
+
+---
+
+## Installation
+```bash
+pip install <url>
+```
+
+
+Or install from source:
+
+```bash
+git clone <url>
+cd project-name
+pip install -e .
+```
+
+---
+
+### Usage
+
+Basic setup
+```python
+import logging
+from src.logger import Logger
+from src.config import LoggerConfig
+
+Logger.configure(
+    LoggerConfig(
+        name="app",
+        level=logging.INFO,
+        directory="logs",
+        json_logs=True,
+        sample_rate=0.2,
+        module_levels={
+            "src.core": logging.WARNING,
+        },
+    )
+)
+
+logger = Logger().bind("startup")
+logger.info("Service initialized")
+```
+
+Trace + ID span
+
+```python
+from src.logger import Logger
+
+log = Logger()
+log.set_trace()
+log.set_span()
+
+logger = log.bind("request")
+logger.info("Request started")
+```
+
+JSON logs example output
+```json
+{
+  "timestamp": "2026-02-04T10:55:01.140Z",
+  "level": "INFO",
+  "message": "Request started",
+  "logger": "app",
+  "context": "api.py:88 EDDController.calculate()",
+  "trace_id": "a1f29c...",
+  "span_id": "91c77d...",
+  "module": "api",
+  "function": "calculate",
+  "line": 88
+}
+```
+
+---
+
+### Configuration
+
+Configuration is done through LoggerConfig.
+
+Example:
+
+```python
+from src.config import LoggerConfig
+
+config = LoggerConfig(
+    name="service",
+    directory="logs",
+    json_logs=True,
+    sample_rate=0.1,
+    level=logging.INFO,
+    module_levels={
+        "src.core": logging.WARNING,
+        "google": logging.ERROR,
+        "httpx": logging.ERROR,
+    },
+)
+```
+
+Key settings
+
+| Field          | Meaning                                        |
+|----------------|------------------------------------------------|
+| json_logs      | Output JSON logs for file handler              |
+| directory      | Where log files are stored                     |
+| deterministic  | Enable deterministic logging                   |
+| sample_rate    | Sampling probability for INFO/DEBUG            |
+| module_levels  | Per-module log level override                  |
+| level          | Global log level                               |
+| name           | Logger name                                    |
+
+---
+
+### Project Structure
+
+```
+src/
+ ├── logger.py              # Logger singleton + ContextLogger
+ ├── config.py              # LoggerConfig + JSONFormatter + SamplingFilter
+ ├── core/
+ │    ├── filters.py        # Log filtering logic
+ │    ├── formatters.py     # Log formatting logic
+ │    └── tracer.py         # contextvars trace_id/span_id
+ └── decorators/
+      ├── functions.py      # function_log decorator
+      └── classes.py        # class_log decorator
+
+```
+---
+
+### Development
+```bash
+pip install -r requirements-dev.txt
+```
+
+---
+
+### Testing
+```
+pytest tests/
+```
+
+---
+
+### Deployment
+
+The service can be deployed as:
+
+```
+Python SDK library
+FastAPI microservice
+Serverless function (Cloud Run / Lambda / Azure Functions)
+Internal data platform component
+```
+
+---
+
+### Roadmap
+
+1. Request middleware integration for Flask/FastAPI
+2. Deterministic sampling by trace_id (avoid partial traces)
+3. Rotating file handler support
+4. OpenTelemetry bridge
+5. Log batching / async writer for high throughput
+
+---
+
+### Contributing
+
+Contributions are welcome.
+Please follow the coding standards and submit PRs with tests and documentation updates.
+
+---
+
+### License
+
+MIT License.
+
+---
+
+### Contact
+
+Maintainer: Evan Flores
+Email: *efloresp06@liverpool.com.mx*
+Organization: **Liverpool**

evan_logger-0.1.1/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "evan-logger"
+version = "0.1.1"
+description = "Structured colored logger with trace/span context and sampling"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { file = "LICENSE" }
+authors = [{ name="Evan", email="e2002florespulido@gmail.com" }]
+keywords = ["logging", "colorlog", "structured-logging", "trace"]
+dependencies = [
+    "pydantic>=2.12.5",
+    "tomli>=2.4.0",
+    "pydantic-settings>=2.0",
+    "colorlog>=6.7.0",
+    "python-dotenv>=1.2.1",
+    "pytest>=9.0.2"
+]
+
+[project.urls]
+Homepage = "https://github.com/EvanFloresLv/Logger.git"
+Repository = "https://github.com/EvanFloresLv/Logger.git"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

evan_logger-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+