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

provide/foundation/testing/file/content_fixtures.py

@@ -7,9 +7,9 @@ CSV, JSON, and other structured data.
 
 import csv
 import json
+from pathlib import Path
 import random
 import tempfile
-from pathlib import Path
 
 import pytest
 
@@ -20,31 +20,31 @@ from provide.foundation.file.safe import safe_delete
 def temp_file():
     """
     Create a temporary file factory with optional content.
-    
+
     Returns:
         A function that creates temporary files with specified content and suffix.
     """
     created_files = []
-    
+
     def _make_temp_file(content: str = "test content", suffix: str = ".txt") -> Path:
         """
         Create a temporary file.
-        
+
         Args:
             content: Content to write to the file
             suffix: File suffix/extension
-            
+
         Returns:
             Path to the created temporary 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)
         created_files.append(path)
         return path
-    
+
     yield _make_temp_file
-    
+
     # Cleanup all created files
     for path in created_files:
         safe_delete(path, missing_ok=True)
@@ -54,23 +54,23 @@ def temp_file():
 def temp_named_file():
     """
     Create a named temporary file factory.
-    
+
     Returns:
         Function that creates named temporary files.
     """
     created_files = []
-    
+
     def _make_named_file(
         content: bytes | str = None,
         suffix: str = "",
         prefix: str = "tmp",
         dir: Path | str = None,
-        mode: str = 'w+b',
-        delete: bool = False
+        mode: str = "w+b",
+        delete: bool = False,
     ) -> Path:
         """
         Create a named temporary file.
-        
+
         Args:
             content: Optional content to write
             suffix: File suffix
@@ -78,41 +78,37 @@ def temp_named_file():
             dir: Directory for the file
             mode: File mode
             delete: Whether to delete on close
-            
+
         Returns:
             Path to the created file
         """
         if isinstance(dir, Path):
             dir = str(dir)
-        
+
         f = tempfile.NamedTemporaryFile(
-            mode=mode,
-            suffix=suffix,
-            prefix=prefix,
-            dir=dir,
-            delete=delete
+            mode=mode, suffix=suffix, prefix=prefix, dir=dir, delete=delete
         )
-        
+
         if content is not None:
             if isinstance(content, str):
-                if 'b' in mode:
+                if "b" in mode:
                     f.write(content.encode())
                 else:
                     f.write(content)
             else:
                 f.write(content)
             f.flush()
-        
+
         path = Path(f.name)
         f.close()
-        
+
         if not delete:
             created_files.append(path)
-        
+
         return path
-    
+
     yield _make_named_file
-    
+
     # Cleanup
     for path in created_files:
         safe_delete(path, missing_ok=True)
@@ -122,42 +118,40 @@ def temp_named_file():
 def temp_file_with_content():
     """
     Create temporary files with specific content.
-    
+
     Returns:
         Function that creates files with content.
     """
     created_files = []
-    
+
     def _make_file(
-        content: str | bytes,
-        suffix: str = ".txt",
-        encoding: str = "utf-8"
+        content: str | bytes, suffix: str = ".txt", encoding: str = "utf-8"
     ) -> Path:
         """
         Create a temporary file with content.
-        
+
         Args:
             content: Content to write
             suffix: File suffix
             encoding: Text encoding (for str content)
-            
+
         Returns:
             Path to created file
         """
         with tempfile.NamedTemporaryFile(
-            mode='wb' if isinstance(content, bytes) else 'w',
+            mode="wb" if isinstance(content, bytes) else "w",
             suffix=suffix,
             delete=False,
-            encoding=None if isinstance(content, bytes) else encoding
+            encoding=None if isinstance(content, bytes) else encoding,
         ) as f:
             f.write(content)
             path = Path(f.name)
-        
+
         created_files.append(path)
         return path
-    
+
     yield _make_file
-    
+
     # Cleanup
     for path in created_files:
         safe_delete(path, missing_ok=True)
@@ -167,25 +161,23 @@ def temp_file_with_content():
 def temp_binary_file():
     """
     Create temporary binary files.
-    
+
     Returns:
         Function that creates binary files.
     """
     created_files = []
-    
+
     def _make_binary(
-        size: int = 1024,
-        pattern: bytes = None,
-        suffix: str = ".bin"
+        size: int = 1024, pattern: bytes = None, suffix: str = ".bin"
     ) -> Path:
         """
         Create a temporary binary file.
-        
+
         Args:
             size: File size in bytes
             pattern: Optional byte pattern to repeat
             suffix: File suffix
-            
+
         Returns:
             Path to created binary file
         """
@@ -196,20 +188,16 @@ def temp_binary_file():
             # Repeat pattern to reach size
             repetitions = size // len(pattern) + 1
             content = (pattern * repetitions)[:size]
-        
-        with tempfile.NamedTemporaryFile(
-            mode='wb',
-            suffix=suffix,
-            delete=False
-        ) as f:
+
+        with tempfile.NamedTemporaryFile(mode="wb", suffix=suffix, delete=False) as f:
             f.write(content)
             path = Path(f.name)
-        
+
         created_files.append(path)
         return path
-    
+
     yield _make_binary
-    
+
     # Cleanup
     for path in created_files:
         safe_delete(path, missing_ok=True)
@@ -219,44 +207,37 @@ def temp_binary_file():
 def temp_csv_file():
     """
     Create temporary CSV files for testing.
-    
+
     Returns:
         Function that creates CSV files.
     """
     created_files = []
-    
-    def _make_csv(
-        headers: list[str],
-        rows: list[list],
-        suffix: str = ".csv"
-    ) -> Path:
+
+    def _make_csv(headers: list[str], rows: list[list], suffix: str = ".csv") -> Path:
         """
         Create a temporary CSV file.
-        
+
         Args:
             headers: Column headers
             rows: Data rows
             suffix: File suffix
-            
+
         Returns:
             Path to created CSV file
         """
         with tempfile.NamedTemporaryFile(
-            mode='w',
-            suffix=suffix,
-            delete=False,
-            newline=''
+            mode="w", suffix=suffix, delete=False, newline=""
         ) as f:
             writer = csv.writer(f)
             writer.writerow(headers)
             writer.writerows(rows)
             path = Path(f.name)
-        
+
         created_files.append(path)
         return path
-    
+
     yield _make_csv
-    
+
     # Cleanup
     for path in created_files:
         safe_delete(path, missing_ok=True)
@@ -266,51 +247,43 @@ def temp_csv_file():
 def temp_json_file():
     """
     Create temporary JSON files for testing.
-    
+
     Returns:
         Function that creates JSON files.
     """
     created_files = []
-    
-    def _make_json(
-        data: dict | list,
-        suffix: str = ".json",
-        indent: int = 2
-    ) -> Path:
+
+    def _make_json(data: dict | list, suffix: str = ".json", indent: int = 2) -> Path:
         """
         Create a temporary JSON file.
-        
+
         Args:
             data: JSON data to write
             suffix: File suffix
             indent: JSON indentation
-            
+
         Returns:
             Path to created JSON file
         """
-        with tempfile.NamedTemporaryFile(
-            mode='w',
-            suffix=suffix,
-            delete=False
-        ) as f:
+        with tempfile.NamedTemporaryFile(mode="w", suffix=suffix, delete=False) as f:
             json.dump(data, f, indent=indent)
             path = Path(f.name)
-        
+
         created_files.append(path)
         return path
-    
+
     yield _make_json
-    
+
     # Cleanup
     for path in created_files:
         safe_delete(path, missing_ok=True)
 
 
 __all__ = [
-    "temp_file",
-    "temp_named_file",
-    "temp_file_with_content",
     "temp_binary_file",
     "temp_csv_file",
+    "temp_file",
+    "temp_file_with_content",
     "temp_json_file",
-]
+    "temp_named_file",
+]

provide/foundation/testing/file/directory_fixtures.py

@@ -1,13 +1,13 @@
 """
 Directory-specific test fixtures.
 
-Fixtures for creating temporary directories, nested structures, 
+Fixtures for creating temporary directories, nested structures,
 and standard test directory layouts.
 """
 
-import tempfile
-from pathlib import Path
 from collections.abc import Generator
+from pathlib import Path
+import tempfile
 
 import pytest
 
@@ -16,7 +16,7 @@ import pytest
 def temp_directory() -> Generator[Path, None, None]:
     """
     Create a temporary directory that's cleaned up after test.
-    
+
     Yields:
         Path to the temporary directory.
     """
@@ -28,14 +28,14 @@ def temp_directory() -> Generator[Path, None, None]:
 def test_files_structure() -> Generator[tuple[Path, Path], None, None]:
     """
     Create standard test file structure with files and subdirectories.
-    
+
     Creates:
         - source/
             - file1.txt (contains "Content 1")
             - file2.txt (contains "Content 2")
             - subdir/
                 - file3.txt (contains "Content 3")
-    
+
     Yields:
         Tuple of (temp_path, source_path)
     """
@@ -43,16 +43,16 @@ def test_files_structure() -> Generator[tuple[Path, Path], None, None]:
         path = Path(temp_dir)
         source = path / "source"
         source.mkdir()
-        
+
         # Create test files
         (source / "file1.txt").write_text("Content 1")
         (source / "file2.txt").write_text("Content 2")
-        
+
         # Create subdirectory with files
         subdir = source / "subdir"
         subdir.mkdir()
         (subdir / "file3.txt").write_text("Content 3")
-        
+
         yield path, source
 
 
@@ -60,7 +60,7 @@ def test_files_structure() -> Generator[tuple[Path, Path], None, None]:
 def nested_directory_structure() -> Generator[Path, None, None]:
     """
     Create a deeply nested directory structure for testing.
-    
+
     Creates:
         - level1/
             - level2/
@@ -68,22 +68,22 @@ def nested_directory_structure() -> Generator[Path, None, None]:
                     - deep_file.txt
             - file_l2.txt
         - file_l1.txt
-    
+
     Yields:
         Path to the root of the structure.
     """
     with tempfile.TemporaryDirectory() as temp_dir:
         root = Path(temp_dir)
-        
+
         # Create nested structure
         deep_dir = root / "level1" / "level2" / "level3"
         deep_dir.mkdir(parents=True)
-        
+
         # Add files at different levels
         (root / "file_l1.txt").write_text("Level 1 file")
         (root / "level1" / "file_l2.txt").write_text("Level 2 file")
         (deep_dir / "deep_file.txt").write_text("Deep file")
-        
+
         yield root
 
 
@@ -91,7 +91,7 @@ def nested_directory_structure() -> Generator[Path, None, None]:
 def empty_directory() -> Generator[Path, None, None]:
     """
     Create an empty temporary directory.
-    
+
     Yields:
         Path to an empty directory.
     """
@@ -100,8 +100,8 @@ def empty_directory() -> Generator[Path, None, None]:
 
 
 __all__ = [
-    "temp_directory",
-    "test_files_structure", 
-    "nested_directory_structure",
     "empty_directory",
-]
+    "nested_directory_structure",
+    "temp_directory",
+    "test_files_structure",
+]

provide/foundation/testing/file/fixtures.py

@@ -7,34 +7,31 @@ and standard test file structures used across the provide-io ecosystem.
 """
 
 # Re-export all fixtures from specialized modules
+from provide.foundation.testing.file.content_fixtures import (
+    temp_binary_file,
+    temp_csv_file,
+    temp_file,
+    temp_file_with_content,
+    temp_json_file,
+    temp_named_file,
+)
 from provide.foundation.testing.file.directory_fixtures import (
+    empty_directory,
+    nested_directory_structure,
     temp_directory,
     test_files_structure,
-    nested_directory_structure, 
-    empty_directory,
 )
-
 from provide.foundation.testing.file.special_fixtures import (
     binary_file,
     readonly_file,
-    temp_symlink,
     temp_executable_file,
+    temp_symlink,
 )
 
-from provide.foundation.testing.file.content_fixtures import (
-    temp_file,
-    temp_named_file,
-    temp_file_with_content,
-    temp_binary_file,
-    temp_csv_file,
-    temp_json_file,
-)
-
-
 __all__ = [
     # Directory fixtures
     "temp_directory",
-    "test_files_structure", 
+    "test_files_structure",
     "nested_directory_structure",
     "empty_directory",
     # Special file fixtures
@@ -45,8 +42,8 @@ __all__ = [
     # Content-based fixtures
     "temp_file",
     "temp_named_file",
-    "temp_file_with_content", 
+    "temp_file_with_content",
     "temp_binary_file",
     "temp_csv_file",
     "temp_json_file",
-]
+]