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

provide/foundation/cli/testing.py

@@ -6,38 +6,16 @@ import os
 from pathlib import Path
 import tempfile
 from typing import Any
-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
 def isolated_cli_runner(
     env: dict[str, str] | None = None,
@@ -150,7 +128,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,22 +137,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:
     """Base class for CLI test cases with common utilities."""
 

provide/foundation/cli/utils.py

@@ -1,12 +1,12 @@
 """Common CLI utilities for output, logging, and testing."""
 
-import json
 from typing import Any
 
 import click
 from click.testing import CliRunner, Result
 
-from provide.foundation.context import Context
+from provide.foundation.console.output import perr, pout
+from provide.foundation.context import CLIContext
 from provide.foundation.logger import (
     LoggingConfig,
     TelemetryConfig,
@@ -25,7 +25,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 +40,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 +54,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 +68,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 +82,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 +119,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 +129,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

@@ -9,6 +9,25 @@ from provide.foundation.config.base import (
     BaseConfig,
     field,
 )
+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.env import (
     RuntimeConfig,
     env_field,
@@ -47,8 +66,6 @@ from provide.foundation.config.types import (
 )
 from provide.foundation.config.validators import (
     validate_choice,
-    validate_non_negative,
-    validate_positive,
     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",
 ]

provide/foundation/config/base.py

@@ -87,7 +87,7 @@ class BaseConfig:
     _source_map: dict[str, ConfigSource] = attrs_field(init=False, factory=lambda: {})
     _original_values: dict[str, Any] = attrs_field(init=False, factory=lambda: {})
 
-    def __attrs_post_init__(self):
+    def __attrs_post_init__(self) -> None:
         """Post-initialization hook for subclasses."""
         # The _source_map and _original_values are now handled by attrs with factory
         # Note: validate() is now async, so we can't call it here
@@ -175,7 +175,7 @@ class BaseConfig:
             Configuration instance
         """
         # Filter data to only include fields defined in the class, excluding private fields
-        field_names = {f.name for f in fields(cls) if not f.name.startswith('_')}
+        field_names = {f.name for f in fields(cls) if not f.name.startswith("_")}
         filtered_data = {k: v for k, v in data.items() if k in field_names}
 
         # Create instance