autotel 0.1.0__tar.gz

autotel-0.1.0/.github/dependabot.yml

@@ -0,0 +1,50 @@
+# Dependabot configuration for automated dependency updates
+# See https://docs.github.com/en/code-security/dependabot
+
+version: 2
+updates:
+  # Python dependencies
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+    open-pull-requests-limit: 10
+    reviewers:
+      - "jagreehal"
+    labels:
+      - "dependencies"
+      - "python"
+    commit-message:
+      prefix: "deps"
+      include: "scope"
+    # Group all patch updates together
+    groups:
+      patch-updates:
+        patterns:
+          - "*"
+        update-types:
+          - "patch"
+    # Ignore specific dependencies if needed
+    ignore:
+      # Example: ignore major updates for specific packages
+      # - dependency-name: "opentelemetry-api"
+      #   update-types: ["version-update:semver-major"]
+
+  # GitHub Actions dependencies
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+    open-pull-requests-limit: 5
+    reviewers:
+      - "jagreehal"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    commit-message:
+      prefix: "ci"
+      include: "scope"

autotel-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: twine upload dist/*

autotel-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,49 @@
+name: Test
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+      fail-fast: false
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        run: pip install uv
+
+      - name: Install dependencies
+        run: uv pip install --system -e ".[dev]"
+
+      - name: Run linting
+        run: python -m ruff check src tests
+
+      - name: Run type checking
+        run: mypy src
+
+      - name: Run unit tests
+        run: pytest tests/unit -v --cov=src --cov-report=xml --cov-report=term-missing
+
+      - name: Upload coverage to Codecov
+        if: always()
+        continue-on-error: true
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          flags: unittests
+          name: codecov-${{ matrix.python-version }}
+          fail_ci_if_error: false
+          verbose: true

autotel-0.1.0/.gitignore

@@ -0,0 +1,51 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.hypothesis/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.log
+.env
+.env.local

autotel-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,66 @@
+# Pre-commit hooks for autotel
+# See https://pre-commit.com for more information
+
+repos:
+  # Ruff - Fast Python linter and formatter
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.4
+    hooks:
+      # Run the linter
+      - id: ruff
+        args: [--fix]
+      # Run the formatter
+      - id: ruff-format
+
+  # MyPy - Static type checker
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.13.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - types-all
+        args: [--config-file=pyproject.toml]
+        exclude: ^(tests/|examples/)
+
+  # General pre-commit hooks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      # File checks
+      - id: check-yaml
+      - id: check-toml
+      - id: check-json
+      - id: check-added-large-files
+        args: [--maxkb=1000]
+      - id: check-case-conflict
+      - id: check-merge-conflict
+
+      # Code quality
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+        args: [--fix=lf]
+
+      # Python specific
+      - id: check-docstring-first
+      - id: debug-statements
+      - id: name-tests-test
+        args: [--pytest-test-first]
+
+  # Security checks
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.8.1
+    hooks:
+      - id: bandit
+        args: [-c, pyproject.toml]
+        additional_dependencies: ["bandit[toml]"]
+        exclude: ^tests/
+
+# Configuration for pre-commit.ci (if using)
+ci:
+  autofix_commit_msg: |
+    [pre-commit.ci] auto fixes from pre-commit hooks
+
+    for more information, see https://pre-commit.ci
+  autoupdate_commit_msg: '[pre-commit.ci] pre-commit autoupdate'
+  skip: [mypy]  # Skip mypy on pre-commit.ci (can be slow)

autotel-0.1.0/.readthedocs.yaml

@@ -0,0 +1,35 @@
+# Read the Docs configuration file for autotel
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+# Build documentation in the "docs/" directory with Sphinx
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+  jobs:
+    post_create_environment:
+      # Install poetry or other dependencies if needed
+      - pip install -U pip setuptools wheel
+    post_install:
+      # Install the package with docs dependencies
+      - pip install -e .[dev]
+
+# Build documentation with Sphinx
+sphinx:
+  configuration: docs/conf.py
+  fail_on_warning: false
+
+# Optionally build your docs in additional formats
+formats:
+  - pdf
+  - epub
+
+# Python configuration
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - dev

autotel-0.1.0/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-11-26
+
+### Initial Release
+
+#### Added
+- One-line initialization with `init()` supporting standard OTEL environment variables
+- `@trace` decorator for sync and async functions
+- `TraceContext` for span operations with auto-detected `ctx` parameter
+- Convenience helpers: `set_attribute()`, `get_trace_id()`, `add_event()`, etc.
+- Semantic convention helpers: `@trace_llm`, `@trace_db`, `@trace_http`, `@trace_messaging`
+- Global `track()` function for product events with auto-enrichment
+- `Event` class for sending events to subscribers (PostHog, Slack, Webhook)
+- `Metric` class for OpenTelemetry metrics (counters, histograms)
+- Baggage support with `with_baggage()` and automatic span attributes
+- Production features: adaptive sampling, rate limiting, circuit breakers
+- PII redaction for email, phone, SSN, credit card, and API keys
+- Framework integrations: FastAPI, Django, Flask middleware
+- HTTP instrumentation with W3C Trace Context propagation
+- Database instrumentation helpers
+- MCP (Model Context Protocol) instrumentation with auto-patching
+- Logging integration (standard logging, structlog, loguru)
+- Testing utilities: `InMemorySpanExporter`, assertion helpers
+- Graceful shutdown with `shutdown()` and `shutdown_sync()`
+- Comprehensive documentation and migration guide
+- 189 passing tests with full coverage
+
+#### Developer Experience
+- Type hints throughout (mypy compliant)
+- Comprehensive examples for all features
+- Before/after comparison examples
+- Migration guide from manual OpenTelemetry
+- Clear error messages and validation
+
+[0.1.0]: https://github.com/jagreehal/autotel-python/releases/tag/v0.1.0

autotel-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,94 @@
+# Contributing to autotel-python
+
+Thank you for your interest in contributing to autotel-python! This document provides guidelines and instructions for contributing.
+
+## Development Setup
+
+1. **Clone the repository**
+   ```bash
+   git clone https://github.com/jagreehal/autotel-python.git
+   cd autotel-python
+   ```
+
+2. **Install dependencies**
+   ```bash
+   # Using uv (recommended)
+   uv pip install -e ".[dev]"
+   
+   # Or using pip
+   pip install -e ".[dev]"
+   ```
+
+3. **Run tests**
+   ```bash
+   pytest tests/ -v
+   ```
+
+## Development Workflow
+
+1. **Create a branch**
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+2. **Make your changes**
+   - Follow the existing code style
+   - Add tests for new features
+   - Update documentation as needed
+
+3. **Run quality checks**
+   ```bash
+   make quality  # Runs lint, type-check, and tests
+   ```
+
+4. **Commit your changes**
+   ```bash
+   git commit -m "feat: add your feature"
+   ```
+
+5. **Push and create a PR**
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+## Code Style
+
+- **Formatting**: Use `ruff format` (configured in `pyproject.toml`)
+- **Linting**: Use `ruff check` (configured in `pyproject.toml`)
+- **Type Hints**: Use full type hints (checked with `mypy`)
+- **Line Length**: 100 characters
+- **Docstrings**: Use Google-style docstrings
+
+## Testing
+
+- Write tests for all new features
+- Aim for >90% code coverage
+- Run tests with: `pytest tests/ -v --cov=src`
+
+## Documentation
+
+- Update README.md for user-facing changes
+- Update CHANGELOG.md for notable changes
+- Add docstrings to all public functions/classes
+
+## Commit Messages
+
+Follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+- `feat:` New feature
+- `fix:` Bug fix
+- `docs:` Documentation changes
+- `test:` Test additions/changes
+- `refactor:` Code refactoring
+- `chore:` Maintenance tasks
+
+## Pull Request Process
+
+1. Ensure all tests pass
+2. Update documentation
+3. Add entry to CHANGELOG.md
+4. Request review from maintainers
+
+## Questions?
+
+Open an issue or reach out to the maintainers!

autotel-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jag Reehal
+
+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.

autotel-0.1.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include MIGRATION.md
+include pyproject.toml
+recursive-include examples *.py
+recursive-include tests *.py
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude .DS_Store