Skip to content

🧱🏗️ provide-foundation

A comprehensive Python foundation library for building robust applications with structured logging, CLI framework, configuration management, and essential building blocks.

🤖 AI-Generated Content

This documentation was generated with AI assistance and is still being audited. Some, or potentially a lot, of this information may be inaccurate. Learn more.

Overview

provide-foundation serves as the core infrastructure layer for the entire provide.io ecosystem. It provides essential cross-cutting concerns that all framework and tool packages depend on, including structured logging with OpenTelemetry integration, type-safe configuration management, and common utilities for building production-ready Python applications.

This package is designed to be lightweight yet comprehensive, offering the fundamental capabilities needed for telemetry, observability, and application configuration without imposing heavy dependencies or opinions on application architecture.

Key Capabilities

  • Structured Logging: Context-aware logging with automatic trace ID propagation
  • OpenTelemetry Integration: Distributed tracing and telemetry for observability
  • Configuration Management: Type-safe configuration with Pydantic and environment variable support
  • CLI Framework: Command-line interface utilities and application scaffolding
  • Validation Utilities: Common validation patterns and error handling
  • Platform Detection: Cross-platform compatibility helpers

Installation

# Basic installation
uv add provide-foundation

# With all optional dependencies
uv add provide-foundation[all]

Documentation

For detailed API documentation, usage examples, and guides, see the Foundation documentation.

Repository