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

provide/foundation/testing/file/special_fixtures.py

@@ -5,10 +5,10 @@ Fixtures for creating specialized files like binary files, read-only files,
 symbolic links, and executable files.
 """
 
+from collections.abc import Generator
+from pathlib import Path
 import stat
 import tempfile
-from pathlib import Path
-from collections.abc import Generator
 
 import pytest
 
@@ -19,16 +19,16 @@ from provide.foundation.file.safe import safe_delete
 def binary_file() -> Generator[Path, None, None]:
     """
     Create a temporary binary file for testing.
-    
+
     Yields:
         Path to a binary file containing sample binary data.
     """
-    with tempfile.NamedTemporaryFile(mode='wb', suffix='.bin', delete=False) as f:
+    with tempfile.NamedTemporaryFile(mode="wb", suffix=".bin", delete=False) as f:
         # Write some binary data
-        f.write(b'\x00\x01\x02\x03\x04\x05\x06\x07\x08\x09')
-        f.write(b'\xFF\xFE\xFD\xFC\xFB\xFA\xF9\xF8\xF7\xF6')
+        f.write(b"\x00\x01\x02\x03\x04\x05\x06\x07\x08\x09")
+        f.write(b"\xff\xfe\xfd\xfc\xfb\xfa\xf9\xf8\xf7\xf6")
         path = Path(f.name)
-    
+
     yield path
     safe_delete(path, missing_ok=True)
 
@@ -37,19 +37,19 @@ def binary_file() -> Generator[Path, None, None]:
 def readonly_file() -> Generator[Path, None, None]:
     """
     Create a read-only file for permission testing.
-    
+
     Yields:
         Path to a read-only file.
     """
-    with tempfile.NamedTemporaryFile(mode='w', suffix='.txt', delete=False) as f:
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".txt", delete=False) as f:
         f.write("Read-only content")
         path = Path(f.name)
-    
+
     # Make file read-only
     path.chmod(0o444)
-    
+
     yield path
-    
+
     # Restore write permission for cleanup
     path.chmod(0o644)
     safe_delete(path, missing_ok=True)
@@ -59,41 +59,38 @@ def readonly_file() -> Generator[Path, None, None]:
 def temp_symlink():
     """
     Create temporary symbolic links for testing.
-    
+
     Returns:
         Function that creates symbolic links.
     """
     created_links = []
-    
-    def _make_symlink(
-        target: Path | str,
-        link_name: Path | str = None
-    ) -> Path:
+
+    def _make_symlink(target: Path | str, link_name: Path | str = None) -> Path:
         """
         Create a temporary symbolic link.
-        
+
         Args:
             target: Target path for the symlink
             link_name: Optional link name (auto-generated if None)
-            
+
         Returns:
             Path to created symlink
         """
         target = Path(target)
-        
+
         if link_name is None:
             with tempfile.NamedTemporaryFile(delete=True) as f:
                 link_name = Path(f.name + "_link")
         else:
             link_name = Path(link_name)
-        
+
         link_name.symlink_to(target)
         created_links.append(link_name)
-        
+
         return link_name
-    
+
     yield _make_symlink
-    
+
     # Cleanup
     for link in created_links:
         safe_delete(link, missing_ok=True)
@@ -103,43 +100,38 @@ def temp_symlink():
 def temp_executable_file():
     """
     Create temporary executable files for testing.
-    
+
     Returns:
         Function that creates executable files.
     """
     created_files = []
-    
+
     def _make_executable(
-        content: str = "#!/bin/sh\necho 'test'\n",
-        suffix: str = ".sh"
+        content: str = "#!/bin/sh\necho 'test'\n", suffix: str = ".sh"
     ) -> Path:
         """
         Create a temporary executable file.
-        
+
         Args:
             content: Script content
             suffix: File suffix
-            
+
         Returns:
             Path to created executable file
         """
-        with tempfile.NamedTemporaryFile(
-            mode='w',
-            suffix=suffix,
-            delete=False
-        ) as f:
+        with tempfile.NamedTemporaryFile(mode="w", suffix=suffix, delete=False) as f:
             f.write(content)
             path = Path(f.name)
-        
+
         # Make executable
         current = path.stat().st_mode
         path.chmod(current | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
-        
+
         created_files.append(path)
         return path
-    
+
     yield _make_executable
-    
+
     # Cleanup
     for path in created_files:
         safe_delete(path, missing_ok=True)
@@ -148,6 +140,6 @@ def temp_executable_file():
 __all__ = [
     "binary_file",
     "readonly_file",
-    "temp_symlink",
     "temp_executable_file",
-]
+    "temp_symlink",
+]

provide/foundation/testing/logger.py

@@ -8,10 +8,11 @@ Provides utilities for resetting logger state, managing configurations,
 and ensuring test isolation for the Foundation logging system.
 """
 
-import structlog
-import pytest
 from unittest.mock import Mock
 
+import pytest
+import structlog
+
 from provide.foundation.logger.core import (
     _LAZY_SETUP_STATE,
     logger as foundation_logger,
@@ -23,10 +24,10 @@ from provide.foundation.streams.file import reset_streams
 def mock_logger():
     """
     Comprehensive mock logger for testing.
-    
+
     Provides compatibility with both stdlib logging and structlog interfaces,
     including method call tracking and common logger attributes.
-    
+
     Returns:
         Mock logger with debug, info, warning, error methods and structlog compatibility.
     """
@@ -39,31 +40,31 @@ def mock_logger():
     logger.exception = Mock()
     logger.critical = Mock()
     logger.fatal = Mock()  # Alias for critical
-    
+
     # Add common logger attributes
     logger.name = "mock_logger"
     logger.level = 10  # DEBUG level
     logger.handlers = []
     logger.disabled = False
-    
+
     # Add structlog compatibility methods
     logger.bind = Mock(return_value=logger)
     logger.unbind = Mock(return_value=logger)
     logger.new = Mock(return_value=logger)
     logger.msg = Mock()  # Alternative to info
-    
+
     # Add trace method for Foundation's extended logging
     logger.trace = Mock()
-    
+
     return logger
 
 
 def mock_logger_factory():
     """
     Factory function to create mock loggers outside of pytest context.
-    
+
     Useful for unit tests that need a mock logger but aren't using pytest fixtures.
-    
+
     Returns:
         Mock logger with the same interface as the pytest fixture.
     """
@@ -76,18 +77,18 @@ def mock_logger_factory():
     logger.exception = Mock()
     logger.critical = Mock()
     logger.fatal = Mock()
-    
+
     logger.name = "mock_logger"
     logger.level = 10
     logger.handlers = []
     logger.disabled = False
-    
+
     logger.bind = Mock(return_value=logger)
     logger.unbind = Mock(return_value=logger)
     logger.new = Mock(return_value=logger)
     logger.msg = Mock()
     logger.trace = Mock()
-    
+
     return logger
 
 
@@ -101,7 +102,7 @@ def _reset_opentelemetry_providers() -> None:
     try:
         # Reset tracing provider more thoroughly
         import opentelemetry.trace as otel_trace
-        
+
         # Reset the Once flag to allow re-initialization
         if hasattr(otel_trace, "_TRACER_PROVIDER_SET_ONCE"):
             once_obj = otel_trace._TRACER_PROVIDER_SET_ONCE
@@ -110,11 +111,12 @@ def _reset_opentelemetry_providers() -> None:
             if hasattr(once_obj, "_lock"):
                 with once_obj._lock:
                     once_obj._done = False
-        
+
         # Reset to NoOpTracerProvider
         from opentelemetry.trace import NoOpTracerProvider
+
         otel_trace.set_tracer_provider(NoOpTracerProvider())
-        
+
     except ImportError:
         # OpenTelemetry tracing not available
         pass
@@ -126,7 +128,7 @@ def _reset_opentelemetry_providers() -> None:
         # Reset metrics provider more thoroughly
         import opentelemetry.metrics as otel_metrics
         import opentelemetry.metrics._internal as otel_metrics_internal
-        
+
         # Reset the Once flag to allow re-initialization
         if hasattr(otel_metrics_internal, "_METER_PROVIDER_SET_ONCE"):
             once_obj = otel_metrics_internal._METER_PROVIDER_SET_ONCE
@@ -135,11 +137,12 @@ def _reset_opentelemetry_providers() -> None:
             if hasattr(once_obj, "_lock"):
                 with once_obj._lock:
                     once_obj._done = False
-        
+
         # Reset to NoOpMeterProvider
         from opentelemetry.metrics import NoOpMeterProvider
+
         otel_metrics.set_meter_provider(NoOpMeterProvider())
-        
+
     except ImportError:
         # OpenTelemetry metrics not available
         pass
@@ -187,17 +190,19 @@ def reset_foundation_setup_for_testing() -> None:
     """
     # Full reset but with improved OpenTelemetry handling
     reset_foundation_state()
-    
+
     # Clear and re-initialize the hub for test isolation
     try:
         from provide.foundation.hub.manager import clear_hub
+
         clear_hub()
     except ImportError:
         pass
-    
+
     # Re-register HTTP transport for tests that need it
     try:
         from provide.foundation.transport.http import _register_http_transport
+
         _register_http_transport()
     except ImportError:
         # Transport module not available
@@ -205,8 +210,8 @@ def reset_foundation_setup_for_testing() -> None:
 
 
 __all__ = [
-    "reset_foundation_setup_for_testing",
-    "reset_foundation_state",
     "mock_logger",
     "mock_logger_factory",
+    "reset_foundation_setup_for_testing",
+    "reset_foundation_state",
 ]

provide/foundation/testing/mocking/__init__.py

@@ -6,41 +6,41 @@ boilerplate and ensure consistent mocking across all tests.
 """
 
 from provide.foundation.testing.mocking.fixtures import (
-    Mock,
-    MagicMock,
+    ANY,
     AsyncMock,
+    MagicMock,
+    Mock,
     PropertyMock,
-    patch,
+    assert_mock_calls,
+    async_mock_factory,
+    auto_patch,
     call,
-    ANY,
-    mock_factory,
     magic_mock_factory,
-    async_mock_factory,
-    property_mock_factory,
+    mock_factory,
+    mock_open_fixture,
+    patch,
     patch_fixture,
     patch_multiple_fixture,
-    auto_patch,
-    mock_open_fixture,
+    property_mock_factory,
     spy_fixture,
-    assert_mock_calls,
 )
 
 __all__ = [
-    "Mock",
-    "MagicMock",
+    "ANY",
     "AsyncMock",
+    "MagicMock",
+    "Mock",
     "PropertyMock",
-    "patch",
+    "assert_mock_calls",
+    "async_mock_factory",
+    "auto_patch",
     "call",
-    "ANY",
-    "mock_factory",
     "magic_mock_factory",
-    "async_mock_factory",
-    "property_mock_factory",
+    "mock_factory",
+    "mock_open_fixture",
+    "patch",
     "patch_fixture",
     "patch_multiple_fixture",
-    "auto_patch",
-    "mock_open_fixture",
+    "property_mock_factory",
     "spy_fixture",
-    "assert_mock_calls",
-]
+]