provide-foundation 0.0.0.dev0__tar.gz → 0.0.0.dev2__tar.gz

{provide_foundation-0.0.0.dev0 → provide_foundation-0.0.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: provide-foundation
-Version: 0.0.0.dev0
+Version: 0.0.0.dev2
 Summary: Foundation Telemetry: An opinionated, developer-friendly telemetry wrapper for Python.
 Author-email: Tim Perkins <code@tim.life>
 Maintainer-email: "provide.io" <code@provide.io>
@@ -29,13 +29,15 @@ Provides-Extra: cli
 Requires-Dist: click>=8.1.7; extra == "cli"
 Provides-Extra: crypto
 Requires-Dist: cryptography>=45.0.7; extra == "crypto"
+Provides-Extra: transport
+Requires-Dist: httpx>=0.27.0; extra == "transport"
 Provides-Extra: opentelemetry
 Requires-Dist: opentelemetry-api>=1.22.0; extra == "opentelemetry"
 Requires-Dist: opentelemetry-sdk>=1.22.0; extra == "opentelemetry"
 Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.22.0; extra == "opentelemetry"
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.22.0; extra == "opentelemetry"
 Provides-Extra: all
-Requires-Dist: provide-foundation[cli,crypto,opentelemetry]; extra == "all"
+Requires-Dist: provide-foundation[cli,crypto,opentelemetry,transport]; extra == "all"
 Dynamic: license-file
 
 # provide.foundation
@@ -439,31 +441,6 @@ Complete working examples are available in the [examples/](examples/) directory:
 
 ---
 
-## Performance
-
-- **Logging**: 14,000+ messages/second with emoji processing and structured logging
-- **Configuration**: Lazy loading with multi-source caching for optimal performance  
-- **File Operations**: Atomic writes with format detection prevent corruption
-- **Process Management**: Efficient streaming with async support and backpressure handling
-- **Cryptography**: Hardware-accelerated operations with secure algorithm defaults
-- **Platform Detection**: Cached system information for minimal overhead
-
----
-
-## Contributing
-
-We welcome contributions! Please see:
-- [DEVELOPMENT.md](DEVELOPMENT.md) - Development setup and guidelines
-- [GitHub Issues](https://github.com/provide-io/provide-foundation/issues) - Bug reports and feature requests
-
----
-
-## License
-
-MIT License - see [LICENSE](LICENSE) file for details.
-
----
-
 <p align="center">
-  Built by <a href="https://provide.io">Provide</a>
+  Built by <a href="https://provide.io">provide.io</a>
 </p>

{provide_foundation-0.0.0.dev0 → provide_foundation-0.0.0.dev2}/README.md

@@ -399,31 +399,6 @@ Complete working examples are available in the [examples/](examples/) directory:
 
 ---
 
-## Performance
-
-- **Logging**: 14,000+ messages/second with emoji processing and structured logging
-- **Configuration**: Lazy loading with multi-source caching for optimal performance  
-- **File Operations**: Atomic writes with format detection prevent corruption
-- **Process Management**: Efficient streaming with async support and backpressure handling
-- **Cryptography**: Hardware-accelerated operations with secure algorithm defaults
-- **Platform Detection**: Cached system information for minimal overhead
-
----
-
-## Contributing
-
-We welcome contributions! Please see:
-- [DEVELOPMENT.md](DEVELOPMENT.md) - Development setup and guidelines
-- [GitHub Issues](https://github.com/provide-io/provide-foundation/issues) - Bug reports and feature requests
-
----
-
-## License
-
-MIT License - see [LICENSE](LICENSE) file for details.
-
----
-
 <p align="center">
-  Built by <a href="https://provide.io">Provide</a>
-</p>
+  Built by <a href="https://provide.io">provide.io</a>
+</p>

provide_foundation-0.0.0.dev2/VERSION

@@ -0,0 +1 @@
+0.0.0.dev2

{provide_foundation-0.0.0.dev0 → provide_foundation-0.0.0.dev2}/pyproject.toml

@@ -52,6 +52,9 @@ cli = [
 crypto = [
     "cryptography>=45.0.7",
 ]
+transport = [
+    "httpx>=0.27.0",
+]
 opentelemetry = [
     "opentelemetry-api>=1.22.0",
     "opentelemetry-sdk>=1.22.0",
@@ -59,7 +62,7 @@ opentelemetry = [
     "opentelemetry-exporter-otlp-proto-http>=1.22.0",
 ]
 all = [
-    "provide-foundation[cli,crypto,opentelemetry]",
+    "provide-foundation[cli,crypto,transport,opentelemetry]",
 ]
 
 [project.scripts]
@@ -68,13 +71,17 @@ foundation = "provide.foundation.cli.main:cli [cli]"
 [dependency-groups]
 dev = [
     "bandit>=1.8.3",
+    "cryptography>=45.0.7",
+    "h2>=4.3.0",
     "hypothesis>=6.131.28",
     "mypy>=1.8.0",
     "psutil>=7.0.0",
-    "pyrefly>=0.16.2", "pytest>=7.4.0",
+    "pyrefly>=0.16.2",
+    "pytest>=7.4.0",
     "pytest-asyncio>=0.21.0",
     "pytest-benchmark>=4.0.0",
     "pytest-cov>=4.1.0",
+    "pytest-httpx>=0.35.0",
     "pytest-mock>=3.15.0",
     "pytest-xdist>=3.3.0",
     "pyyaml>=6.0.2",
@@ -94,6 +101,9 @@ docs = [
     "mkdocs-section-index>=0.3.0",
     "mike>=2.0.0",
 ]
+protobuf = [
+    "protobuf>=6.32.0",
+]
 
 ################################################################################
 # Pytest Configuration
@@ -105,6 +115,7 @@ log_cli_level = "DEBUG"
 
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "function"
+asyncio_default_test_loop_scope = "function"
 
 testpaths = ["tests"]
 pythonpath = ["src", "."]
@@ -112,7 +123,21 @@ python_files = ["test_*.py", "*_test.py"]
 python_classes = ["Test*", "*Tests"]
 python_functions = ["test_*", "*_test"]
 markers = [
-    "serial: run tests serially to avoid conflicts on global state",
+    "serial: run tests serially to avoid event loop conflicts",
+    "async_unsafe: async tests that must run serially",
+    "unit: fast unit tests",
+    "integration: integration tests requiring setup",
+    "slow: tests taking >1s",
+    "fast: tests taking <100ms",
+    # Module markers
+    "archive: archive module tests",
+    "process: process/subprocess tests",
+    "network: network/transport tests",
+    "config: configuration tests",
+    "logger: logging tests",
+    # Skip conditions
+    "requires_docker: skip if docker not available",
+    "requires_network: skip if offline",
 ]
 filterwarnings = [
     "ignore::DeprecationWarning",
@@ -127,7 +152,8 @@ norecursedirs = [
     "htmlcov", "docs/_build",
     ".hypothesis", # Added to address the warning
 ]
-addopts = "-ra -q --color=yes --benchmark-columns=min,max,mean,stddev,median,iqr,ops --benchmark-sort=mean"
+# Changed from -ra to -rFE to suppress skipped test output
+addopts = "-rFE -q --color=yes --benchmark-columns=min,max,mean,stddev,median,iqr,ops --benchmark-sort=mean --dist loadscope"
 
 ################################################################################
 # Ruff Linter and Formatter Configuration

{provide_foundation-0.0.0.dev0 → provide_foundation-0.0.0.dev2}/src/provide/foundation/__init__.py

@@ -9,12 +9,12 @@ Primary public interface for the library, re-exporting common components.
 # Export config module for easy access
 # New foundation components
 # Make the errors module available for detailed imports
-from provide.foundation import config, errors, platform, process
+from provide.foundation import config, errors, platform, process, resilience
 from provide.foundation._version import __version__
 
 # Console I/O functions (always available - handles click dependency internally)
 from provide.foundation.console import perr, pin, pout
-from provide.foundation.context import Context
+from provide.foundation.context import CLIContext, Context
 
 # Error handling exports - only the essentials
 from provide.foundation.errors import (
@@ -27,6 +27,19 @@ from provide.foundation.errors import (
     with_error_handling,
 )
 
+# Resilience exports
+from provide.foundation.resilience import (
+    retry,
+    circuit_breaker,
+    fallback,
+    RetryPolicy,
+    RetryExecutor,
+    BackoffStrategy,
+    CircuitBreaker,
+    CircuitState,
+    FallbackChain,
+)
+
 # Hub and Registry exports (public API)
 from provide.foundation.hub.components import ComponentCategory, get_component_registry
 from provide.foundation.hub.manager import Hub, clear_hub, get_hub
@@ -39,17 +52,12 @@ from provide.foundation.logger import (
     setup_logging,  # Setup function (backward compatibility)
 )
 
-# Emoji exports
-from provide.foundation.logger.emoji.matrix import (
-    PRIMARY_EMOJI,
-    SECONDARY_EMOJI,
-    TERTIARY_EMOJI,
-    show_emoji_matrix,
-)
-from provide.foundation.logger.emoji.types import (
-    EmojiSet,
-    EmojiSetConfig,
-    FieldToEmojiMapping,
+# Event set exports
+from provide.foundation.eventsets.display import show_event_matrix
+from provide.foundation.eventsets.types import (
+    EventMapping,
+    EventSet,
+    FieldMapping,
 )
 from provide.foundation.setup import (
     setup_telemetry,
@@ -93,15 +101,16 @@ def __getattr__(name: str):
 
 
 __all__ = [
-    # Core Emoji Dictionaries (available for direct use or reference)
-    "PRIMARY_EMOJI",
-    "SECONDARY_EMOJI",
-    "TERTIARY_EMOJI",
+    # Event enrichment utilities
+    "show_event_matrix",
     "ConsoleFormatterStr",
     # New foundation modules
-    "Context",
-    # Emoji Mapping classes
-    "EmojiSet",
+    "CLIContext",
+    "Context",  # Backward compatibility
+    # Event set types
+    "EventMapping",
+    "EventSet",
+    "FieldMapping",
     # Error handling essentials
     "FoundationError",
     # Type aliases
@@ -115,8 +124,6 @@ __all__ = [
     "get_component_registry",
     "get_hub",
     "clear_hub",
-    "FieldToEmojiMapping",
-    "EmojiSetConfig",
     # Configuration classes
     "TelemetryConfig",
     # Version
@@ -136,12 +143,23 @@ __all__ = [
     "pout",
     "platform",
     "process",
+    # Resilience patterns
+    "retry",
+    "circuit_breaker", 
+    "fallback",
+    "RetryPolicy",
+    "RetryExecutor",
+    "BackoffStrategy",
+    "CircuitBreaker",
+    "CircuitState", 
+    "FallbackChain",
+    # Backward compatibility (deprecated)
     "retry_on_error",
+    "resilience",  # The resilience module for detailed imports
     "setup_logging",  # Backward compatibility
     "setup_logger",  # Consistent naming
     "setup_telemetry",
     # Utilities
-    "show_emoji_matrix",
     "shutdown_foundation_telemetry",
     "timed_block",
     # Rate limiting utilities

provide_foundation-0.0.0.dev2/src/provide/foundation/archive/__init__.py

@@ -0,0 +1,23 @@
+"""Archive operations for provide-foundation.
+
+This module provides clean, composable archive operations without complex abstractions.
+Tools for creating, extracting, and manipulating archives in various formats.
+"""
+
+from provide.foundation.archive.base import ArchiveError, BaseArchive
+from provide.foundation.archive.bzip2 import Bzip2Compressor
+from provide.foundation.archive.gzip import GzipCompressor
+from provide.foundation.archive.operations import ArchiveOperations, OperationChain
+from provide.foundation.archive.tar import TarArchive
+from provide.foundation.archive.zip import ZipArchive
+
+__all__ = [
+    "ArchiveError",
+    "ArchiveOperations",
+    "BaseArchive",
+    "Bzip2Compressor",
+    "GzipCompressor",
+    "OperationChain",
+    "TarArchive",
+    "ZipArchive",
+]

provide_foundation-0.0.0.dev2/src/provide/foundation/archive/base.py

@@ -0,0 +1,70 @@
+"""Base classes and interfaces for archive operations."""
+
+from abc import ABC, abstractmethod
+from pathlib import Path
+
+from provide.foundation.errors import FoundationError
+
+
+class ArchiveError(FoundationError):
+    """Base exception for archive-related errors."""
+    pass
+
+
+class BaseArchive(ABC):
+    """
+    Abstract base class for all archive implementations.
+    
+    This defines the common interface that all archive implementations
+    must follow, ensuring consistency across different archive formats.
+    """
+    
+    @abstractmethod
+    def create(self, source: Path, output: Path) -> Path:
+        """
+        Create an archive from source path.
+        
+        Args:
+            source: Source file or directory to archive
+            output: Output archive file path
+            
+        Returns:
+            Path to the created archive file
+            
+        Raises:
+            ArchiveError: If archive creation fails
+        """
+        pass
+    
+    @abstractmethod
+    def extract(self, archive: Path, output: Path) -> Path:
+        """
+        Extract an archive to output path.
+        
+        Args:
+            archive: Archive file to extract
+            output: Output directory for extracted contents
+            
+        Returns:
+            Path to the extraction directory
+            
+        Raises:
+            ArchiveError: If extraction fails
+        """
+        pass
+    
+    @abstractmethod
+    def validate(self, archive: Path) -> bool:
+        """
+        Validate that an archive is properly formed.
+        
+        Args:
+            archive: Archive file to validate
+            
+        Returns:
+            True if archive is valid, False otherwise
+            
+        Raises:
+            ArchiveError: If validation cannot be performed
+        """
+        pass

provide_foundation-0.0.0.dev2/src/provide/foundation/archive/bzip2.py

@@ -0,0 +1,157 @@
+"""BZIP2 compression implementation."""
+
+import bz2
+import shutil
+from pathlib import Path
+from typing import BinaryIO
+
+from attrs import define, field
+
+from provide.foundation.archive.base import ArchiveError
+from provide.foundation.file import ensure_parent_dir
+from provide.foundation.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+@define(slots=True)
+class Bzip2Compressor:
+    """
+    BZIP2 compression implementation.
+    
+    Provides BZIP2 compression and decompression for single files.
+    Does not handle bundling - use with TarArchive for .tar.bz2 files.
+    """
+    
+    level: int = field(default=9)  # Compression level 1-9 (1=fast, 9=best)
+    
+    @level.validator
+    def _validate_level(self, attribute, value):
+        if not 1 <= value <= 9:
+            raise ValueError(f"Compression level must be 1-9, got {value}")
+    
+    def compress(self, input_stream: BinaryIO, output_stream: BinaryIO) -> None:
+        """
+        Compress data from input stream to output stream.
+        
+        Args:
+            input_stream: Input binary stream
+            output_stream: Output binary stream
+            
+        Raises:
+            ArchiveError: If compression fails
+        """
+        try:
+            with bz2.BZ2File(output_stream, 'wb', compresslevel=self.level) as bz:
+                shutil.copyfileobj(input_stream, bz)
+            logger.debug(f"Compressed data with BZIP2 level {self.level}")
+        except Exception as e:
+            raise ArchiveError(f"Failed to compress with BZIP2: {e}") from e
+    
+    def decompress(self, input_stream: BinaryIO, output_stream: BinaryIO) -> None:
+        """
+        Decompress data from input stream to output stream.
+        
+        Args:
+            input_stream: Input binary stream (bzip2 compressed)
+            output_stream: Output binary stream
+            
+        Raises:
+            ArchiveError: If decompression fails
+        """
+        try:
+            with bz2.BZ2File(input_stream, 'rb') as bz:
+                shutil.copyfileobj(bz, output_stream)
+            logger.debug("Decompressed BZIP2 data")
+        except Exception as e:
+            raise ArchiveError(f"Failed to decompress BZIP2: {e}") from e
+    
+    def compress_file(self, input_path: Path, output_path: Path) -> Path:
+        """
+        Compress a file.
+        
+        Args:
+            input_path: Input file path
+            output_path: Output file path (should end with .bz2)
+            
+        Returns:
+            Path to compressed file
+            
+        Raises:
+            ArchiveError: If compression fails
+        """
+        try:
+            ensure_parent_dir(output_path)
+            
+            with open(input_path, 'rb') as f_in:
+                with bz2.open(output_path, 'wb', compresslevel=self.level) as f_out:
+                    shutil.copyfileobj(f_in, f_out)
+            
+            logger.debug(f"Compressed {input_path} to {output_path}")
+            return output_path
+            
+        except Exception as e:
+            raise ArchiveError(f"Failed to compress file: {e}") from e
+    
+    def decompress_file(self, input_path: Path, output_path: Path) -> Path:
+        """
+        Decompress a file.
+        
+        Args:
+            input_path: Input file path (bzip2 compressed)
+            output_path: Output file path
+            
+        Returns:
+            Path to decompressed file
+            
+        Raises:
+            ArchiveError: If decompression fails
+        """
+        try:
+            ensure_parent_dir(output_path)
+            
+            with bz2.open(input_path, 'rb') as f_in:
+                with open(output_path, 'wb') as f_out:
+                    shutil.copyfileobj(f_in, f_out)
+            
+            logger.debug(f"Decompressed {input_path} to {output_path}")
+            return output_path
+            
+        except Exception as e:
+            raise ArchiveError(f"Failed to decompress file: {e}") from e
+    
+    def compress_bytes(self, data: bytes) -> bytes:
+        """
+        Compress bytes data.
+        
+        Args:
+            data: Input bytes
+            
+        Returns:
+            Compressed bytes
+            
+        Raises:
+            ArchiveError: If compression fails
+        """
+        try:
+            return bz2.compress(data, compresslevel=self.level)
+        except Exception as e:
+            raise ArchiveError(f"Failed to compress bytes: {e}") from e
+    
+    def decompress_bytes(self, data: bytes) -> bytes:
+        """
+        Decompress bytes data.
+        
+        Args:
+            data: Compressed bytes
+            
+        Returns:
+            Decompressed bytes
+            
+        Raises:
+            ArchiveError: If decompression fails
+        """
+        try:
+            return bz2.decompress(data)
+        except Exception as e:
+            raise ArchiveError(f"Failed to decompress bytes: {e}") from e