provide-foundation 0.0.0.dev1__py3-none-any.whl → 0.0.0.dev2__py3-none-any.whl

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
@@ -92,7 +105,8 @@ __all__ = [
     "show_event_matrix",
     "ConsoleFormatterStr",
     # New foundation modules
-    "Context",
+    "CLIContext",
+    "Context",  # Backward compatibility
     # Event set types
     "EventMapping",
     "EventSet",
@@ -129,7 +143,19 @@ __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",

provide/foundation/archive/operations.py

@@ -2,7 +2,7 @@
 
 import tempfile
 from pathlib import Path
-from typing import Callable, Optional
+from typing import Callable
 
 from attrs import define, field
 
@@ -12,6 +12,7 @@ from provide.foundation.archive.gzip import GzipCompressor
 from provide.foundation.archive.bzip2 import Bzip2Compressor
 from provide.foundation.archive.zip import ZipArchive
 from provide.foundation.file import ensure_parent_dir
+from provide.foundation.file.safe import safe_delete
 from provide.foundation.logger import get_logger
 
 logger = get_logger(__name__)
@@ -68,12 +69,9 @@ class OperationChain:
         except Exception as e:
             raise ArchiveError(f"Operation chain failed: {e}") from e
         finally:
-            # Clean up temp files
+            # Clean up temp files using Foundation's safe file operations
             for temp in temp_files:
-                try:
-                    temp.unlink()
-                except Exception:
-                    pass
+                safe_delete(temp, missing_ok=True)
     
     def reverse(self, source: Path, output: Path) -> Path:
         """

provide/foundation/cli/__init__.py

@@ -17,12 +17,12 @@ from provide.foundation.cli.decorators import (
 )
 from provide.foundation.cli.testing import (
     CliTestCase,
-    MockContext,
     create_test_cli,
     isolated_cli_runner,
-    mock_logger,
     temp_config_file,
 )
+from provide.foundation.testing.cli import MockContext
+from provide.foundation.testing.logger import mock_logger
 from provide.foundation.cli.utils import (
     CliTestRunner,
     assert_cli_error,

provide/foundation/cli/commands/deps.py

@@ -8,7 +8,9 @@ except ImportError:
     click = None
     _HAS_CLICK = False
 
-from provide.foundation.utils.deps import check_optional_deps
+from provide.foundation.utils.deps import check_optional_deps, has_dependency
+from provide.foundation.console.output import pout
+from provide.foundation.process import exit_success, exit_error
 
 
 def _require_click():
@@ -23,21 +25,25 @@ def _require_click():
 def _deps_command_impl(quiet: bool, check: str | None) -> None:
     """Implementation of deps command logic."""
     if check:
-        from provide.foundation.utils.deps import has_dependency
-
         available = has_dependency(check)
         if not quiet:
             status = "✅" if available else "❌"
-            print(f"{status} {check}: {'Available' if available else 'Missing'}")
+            pout(f"{status} {check}: {'Available' if available else 'Missing'}")
             if not available:
-                print(f"Install with: pip install 'provide-foundation[{check}]'")
-        exit(0 if available else 1)
+                pout(f"Install with: pip install 'provide-foundation[{check}]'")
+        if available:
+            exit_success()
+        else:
+            exit_error("Dependency check failed")
     else:
         # Check all dependencies
         deps = check_optional_deps(quiet=quiet, return_status=True)
         available_count = sum(1 for dep in deps if dep.available)
         total_count = len(deps)
-        exit(0 if available_count == total_count else 1)
+        if available_count == total_count:
+            exit_success()
+        else:
+            exit_error(f"Missing {total_count - available_count} dependencies")
 
 
 if _HAS_CLICK:

provide/foundation/cli/commands/logs/__init__.py

@@ -28,7 +28,7 @@ if _HAS_CLICK:
 
         # Try to get OpenObserve client if available
         try:
-            from provide.foundation.observability.openobserve import OpenObserveClient
+            from provide.foundation.integrations.openobserve import OpenObserveClient
 
             ctx.obj["client"] = OpenObserveClient.from_config()
         except Exception as e:

provide/foundation/cli/commands/logs/query.py

@@ -89,7 +89,7 @@ if _HAS_CLICK:
             # Custom SQL query
             foundation logs query --sql "SELECT * FROM default WHERE duration_ms > 1000"
         """
-        from provide.foundation.observability.openobserve import (
+        from provide.foundation.integrations.openobserve import (
             format_output,
             search_logs,
         )

provide/foundation/cli/commands/logs/send.py

@@ -83,7 +83,7 @@ if _HAS_CLICK:
             # Send with JSON attributes
             foundation logs send -m "Error occurred" -j '{"error_code": 500, "path": "/api/users"}'
         """
-        from provide.foundation.observability.openobserve.otlp import send_log
+        from provide.foundation.integrations.openobserve.otlp import send_log
 
         # Get message from stdin if not provided
         if not message:

provide/foundation/cli/commands/logs/tail.py

@@ -69,7 +69,7 @@ if _HAS_CLICK:
             # Tail with JSON output
             foundation logs tail --format json
         """
-        from provide.foundation.observability.openobserve import (
+        from provide.foundation.integrations.openobserve import (
             format_output,
             tail_logs,
         )

provide/foundation/cli/decorators.py

@@ -11,7 +11,8 @@ try:
 except ImportError:
     click = None
 
-from provide.foundation.context import Context
+from provide.foundation.context import CLIContext
+from provide.foundation.process import exit_error, exit_interrupted
 
 F = TypeVar("F", bound=Callable[..., Any])
 
@@ -162,7 +163,7 @@ def error_handler(f: F) -> F:
         except KeyboardInterrupt:
             if not json_output:
                 click.secho("\nInterrupted by user", fg="yellow", err=True)
-            sys.exit(130)  # Standard exit code for SIGINT
+            exit_interrupted()
         except Exception as e:
             if debug:
                 # In debug mode, show full traceback
@@ -179,16 +180,16 @@ def error_handler(f: F) -> F:
             else:
                 click.secho(f"Error: {e}", fg="red", err=True)
 
-            sys.exit(1)
+            exit_error(f"Command failed: {str(e)}")
 
     return wrapper
 
 
 def pass_context(f: F) -> F:
     """
-    Decorator to pass the foundation Context to a command.
+    Decorator to pass the foundation CLIContext to a command.
 
-    Creates or retrieves a Context from Click's context object
+    Creates or retrieves a CLIContext from Click's context object
     and passes it as the first argument to the decorated function.
     """
 
@@ -197,15 +198,15 @@ def pass_context(f: F) -> F:
     def wrapper(ctx: click.Context, *args, **kwargs):
         # Get or create foundation context
         if not hasattr(ctx, "obj") or ctx.obj is None:
-            ctx.obj = Context()
-        elif not isinstance(ctx.obj, Context):
+            ctx.obj = CLIContext()
+        elif not isinstance(ctx.obj, CLIContext):
             # If obj exists but isn't a Context, wrap it
             if isinstance(ctx.obj, dict):
-                ctx.obj = Context.from_dict(ctx.obj)
+                ctx.obj = CLIContext.from_dict(ctx.obj)
             else:
-                # Store existing obj and create new Context
+                # Store existing obj and create new CLIContext
                 old_obj = ctx.obj
-                ctx.obj = Context()
+                ctx.obj = CLIContext()
                 ctx.obj._cli_data = old_obj
 
         # Update context from command options

provide/foundation/cli/main.py

@@ -46,7 +46,7 @@ if _HAS_CLICK:
 
     # Register OpenObserve commands if available
     try:
-        from provide.foundation.observability.openobserve.commands import (
+        from provide.foundation.integrations.openobserve.commands import (
             openobserve_group,
         )
 

provide/foundation/cli/testing.py

@@ -11,31 +11,12 @@ from unittest.mock import MagicMock
 import click
 from click.testing import CliRunner
 
-from provide.foundation.context import Context
+from provide.foundation.context import CLIContext
 from provide.foundation.logger import get_logger
 
 log = get_logger(__name__)
 
 
-class MockContext(Context):
-    """Mock context for testing that tracks method calls."""
-
-    def __init__(self, **kwargs) -> None:
-        """Initialize mock context with tracking."""
-        super().__init__(**kwargs)
-        self.calls = []
-        self.saved_configs = []
-        self.loaded_configs = []
-
-    def save_config(self, path: str | Path) -> None:
-        """Track save_config calls."""
-        self.saved_configs.append(path)
-        super().save_config(path)
-
-    def load_config(self, path: str | Path) -> None:
-        """Track load_config calls."""
-        self.loaded_configs.append(path)
-        super().load_config(path)
 
 
 @contextmanager
@@ -150,7 +131,7 @@ def create_test_cli(
     @click.pass_context
     def cli(ctx, **kwargs) -> None:
         """Test CLI for testing."""
-        ctx.obj = Context(**{k: v for k, v in kwargs.items() if v is not None})
+        ctx.obj = CLIContext(**{k: v for k, v in kwargs.items() if v is not None})
 
     if commands:
         for cmd in commands:
@@ -159,20 +140,6 @@ def create_test_cli(
     return cli
 
 
-def mock_logger():
-    """
-    Create a mock logger for testing.
-
-    Returns:
-        MagicMock with common logger methods
-    """
-    mock = MagicMock()
-    mock.debug = MagicMock()
-    mock.info = MagicMock()
-    mock.warning = MagicMock()
-    mock.error = MagicMock()
-    mock.critical = MagicMock()
-    return mock
 
 
 class CliTestCase:

provide/foundation/cli/utils.py

@@ -6,7 +6,8 @@ from typing import Any
 import click
 from click.testing import CliRunner, Result
 
-from provide.foundation.context import Context
+from provide.foundation.console.output import pout, perr
+from provide.foundation.context import CLIContext
 from provide.foundation.logger import (
     LoggingConfig,
     TelemetryConfig,
@@ -25,7 +26,10 @@ def echo_json(data: Any, err: bool = False) -> None:
         data: Data to output as JSON
         err: Whether to output to stderr
     """
-    click.echo(json.dumps(data, indent=2, default=str), err=err)
+    if err:
+        perr(data)
+    else:
+        pout(data)
 
 
 def echo_error(message: str, json_output: bool = False) -> None:
@@ -37,9 +41,9 @@ def echo_error(message: str, json_output: bool = False) -> None:
         json_output: Whether to output as JSON
     """
     if json_output:
-        echo_json({"error": message}, err=True)
+        perr(message, json_key="error")
     else:
-        click.secho(f"✗ {message}", fg="red", err=True)
+        perr(f"✗ {message}", color="red")
 
 
 def echo_success(message: str, json_output: bool = False) -> None:
@@ -51,9 +55,9 @@ def echo_success(message: str, json_output: bool = False) -> None:
         json_output: Whether to output as JSON
     """
     if json_output:
-        echo_json({"success": message})
+        pout(message, json_key="success")
     else:
-        click.secho(f"✓ {message}", fg="green")
+        pout(f"✓ {message}", color="green")
 
 
 def echo_warning(message: str, json_output: bool = False) -> None:
@@ -65,9 +69,9 @@ def echo_warning(message: str, json_output: bool = False) -> None:
         json_output: Whether to output as JSON
     """
     if json_output:
-        echo_json({"warning": message}, err=True)
+        perr(message, json_key="warning")
     else:
-        click.secho(f"⚠ {message}", fg="yellow", err=True)
+        perr(f"⚠ {message}", color="yellow")
 
 
 def echo_info(message: str, json_output: bool = False) -> None:
@@ -79,23 +83,23 @@ def echo_info(message: str, json_output: bool = False) -> None:
         json_output: Whether to output as JSON
     """
     if json_output:
-        echo_json({"info": message})
+        pout(message, json_key="info")
     else:
-        click.echo(f"ℹ {message}")
+        pout(f"ℹ {message}")
 
 
 def setup_cli_logging(
-    ctx: Context,
+    ctx: CLIContext,
 ) -> None:
     """
-    Setup logging for CLI applications using a Context object.
+    Setup logging for CLI applications using a CLIContext object.
 
     This function is the designated way to configure logging within a CLI
     application built with foundation. It uses the provided context object
     to construct a full TelemetryConfig and initializes the system.
 
     Args:
-        ctx: The foundation Context, populated by CLI decorators.
+        ctx: The foundation CLIContext, populated by CLI decorators.
     """
     console_formatter = "json" if ctx.json_output else ctx.log_format
 
@@ -116,9 +120,9 @@ def setup_cli_logging(
     setup_telemetry(config=telemetry_config)
 
 
-def create_cli_context(**kwargs) -> Context:
+def create_cli_context(**kwargs) -> CLIContext:
     """
-    Create a Context for CLI usage.
+    Create a CLIContext for CLI usage.
 
     Loads from environment, then overlays any provided kwargs.
 
@@ -126,9 +130,9 @@ def create_cli_context(**kwargs) -> Context:
         **kwargs: Override values for the context
 
     Returns:
-        Configured Context instance
+        Configured CLIContext instance
     """
-    ctx = Context.from_env()
+    ctx = CLIContext.from_env()
     for key, value in kwargs.items():
         if value is not None and hasattr(ctx, key):
             setattr(ctx, key, value)

provide/foundation/config/__init__.py

@@ -45,10 +45,27 @@ from provide.foundation.config.types import (
     ConfigSource,
     ConfigValue,
 )
-from provide.foundation.config.validators import (
-    validate_choice,
+from provide.foundation.config.converters import (
+    parse_bool_extended,
+    parse_comma_list,
+    parse_console_formatter,
+    parse_float_with_validation,
+    parse_headers,
+    parse_json_dict,
+    parse_json_list,
+    parse_log_level,
+    parse_module_levels,
+    parse_rate_limits,
+    parse_sample_rate,
+    validate_log_level,
     validate_non_negative,
+    validate_overflow_policy,
+    validate_port,
     validate_positive,
+    validate_sample_rate,
+)
+from provide.foundation.config.validators import (
+    validate_choice,
     validate_range,
 )
 from provide.foundation.errors.config import (
@@ -96,11 +113,27 @@ __all__ = [
     "parse_dict",
     "parse_list",
     "set_config",
+    # Converters
+    "parse_bool_extended",
+    "parse_comma_list",
+    "parse_console_formatter",
+    "parse_float_with_validation",
+    "parse_headers",
+    "parse_json_dict",
+    "parse_json_list",
+    "parse_log_level",
+    "parse_module_levels",
+    "parse_rate_limits",
+    "parse_sample_rate",
     # Validators
     "validate_choice",
     "validate_config",
+    "validate_log_level",
     "validate_non_negative",
+    "validate_overflow_policy",
+    "validate_port",
     "validate_positive",
     "validate_range",
+    "validate_sample_rate",
     "validate_schema",
 ]