exonware-xwsystem 0.0.1.409__py3-none-any.whl → 0.0.1.411__py3-none-any.whl

exonware/xwsystem/io/archive/archivers.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: 30-Oct-2025
 
 Archive codecs - In-memory archive processors.
@@ -26,7 +26,7 @@ import zipfile
 import tarfile
 import io
 from pathlib import Path
-from typing import Any, Dict, Optional, List, Union
+from typing import Any, Optional, Union
 
 from ..archive.base import AArchiver
 from ..contracts import IArchiver, EncodeOptions, DecodeOptions
@@ -117,7 +117,7 @@ class ZipArchiver(AArchiver):
             
             with zipfile.ZipFile(zip_buffer, 'w', compression=compression) as zf:
                 if isinstance(value, dict):
-                    # Dict: keys are filenames, values are contents
+                    # dict: keys are filenames, values are contents
                     for filename, content in value.items():
                         if isinstance(content, str):
                             zf.writestr(filename, content)

exonware/xwsystem/io/archive/base.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: 30-Oct-2025
 
 Base classes and registries for archive system.
@@ -19,7 +19,7 @@ Priority 5 (Extensibility): Easy to add 7z, RAR, etc.
 """
 
 from abc import ABC, abstractmethod
-from typing import Dict, Optional, Type, List, Union, Any
+from typing import Optional, Union, Any
 from pathlib import Path
 
 from ..contracts import IArchiveFormat, ICompressor, IArchiveMetadata, IArchiver, IArchiveFile, EncodeOptions, DecodeOptions
@@ -50,12 +50,12 @@ class AArchiveFormat(IArchiveFormat, ABC):
     
     @property
     @abstractmethod
-    def file_extensions(self) -> List[str]:
+    def file_extensions(self) -> list[str]:
         """Supported file extensions."""
         pass
     
     @property
-    def mime_types(self) -> List[str]:
+    def mime_types(self) -> list[str]:
         """Supported MIME types."""
         return []  # Default: no MIME types
 
@@ -71,7 +71,7 @@ class ACompressor(ICompressor, ABC):
     
     @property
     @abstractmethod
-    def file_extensions(self) -> List[str]:
+    def file_extensions(self) -> list[str]:
         """Supported file extensions."""
         pass
 
@@ -210,7 +210,7 @@ class AArchiveFile(AFile, IArchiveFile, ABC):
         pass
     
     @abstractmethod
-    def add_files(self, files: List[Path], **options) -> None:
+    def add_files(self, files: list[Path], **options) -> None:
         """
         Add files to archive - must implement in subclass.
         
@@ -219,7 +219,7 @@ class AArchiveFile(AFile, IArchiveFile, ABC):
         pass
     
     @abstractmethod
-    def extract_to(self, dest: Path, **options) -> List[Path]:
+    def extract_to(self, dest: Path, **options) -> list[Path]:
         """
         Extract archive to destination - must implement in subclass.
         
@@ -228,7 +228,7 @@ class AArchiveFile(AFile, IArchiveFile, ABC):
         pass
     
     @abstractmethod
-    def list_contents(self) -> List[str]:
+    def list_contents(self) -> list[str]:
         """List files in archive - must implement in subclass."""
         pass
 
@@ -252,11 +252,11 @@ class ArchiveFormatRegistry:
     
     def __init__(self):
         """Initialize registry."""
-        self._formats: Dict[str, Type[IArchiveFormat]] = {}
-        self._instances: Dict[str, IArchiveFormat] = {}
-        self._extension_map: Dict[str, str] = {}  # .zip → "zip"
+        self._formats: dict[str, type[IArchiveFormat]] = {}
+        self._instances: dict[str, IArchiveFormat] = {}
+        self._extension_map: dict[str, str] = {}  # .zip → "zip"
     
-    def register(self, format_class: Type[IArchiveFormat]) -> None:
+    def register(self, format_class: type[IArchiveFormat]) -> None:
         """
         Register an archive format.
         
@@ -312,7 +312,7 @@ class ArchiveFormatRegistry:
         
         return None
     
-    def list_formats(self) -> List[str]:
+    def list_formats(self) -> list[str]:
         """List all registered format IDs."""
         return list(self._formats.keys())
 
@@ -326,10 +326,10 @@ class CompressionRegistry:
     
     def __init__(self):
         """Initialize registry."""
-        self._algorithms: Dict[str, Type[ICompressor]] = {}
-        self._instances: Dict[str, ICompressor] = {}
+        self._algorithms: dict[str, type[ICompressor]] = {}
+        self._instances: dict[str, ICompressor] = {}
     
-    def register(self, compressor_class: Type[ICompressor]) -> None:
+    def register(self, compressor_class: type[ICompressor]) -> None:
         """Register a compression algorithm."""
         instance = compressor_class()
         algo_id = instance.algorithm_id
@@ -348,7 +348,7 @@ class CompressionRegistry:
                 return compressor
         return None
     
-    def list_algorithms(self) -> List[str]:
+    def list_algorithms(self) -> list[str]:
         """List all registered algorithm IDs."""
         return list(self._algorithms.keys())
 

exonware/xwsystem/io/archive/codec_integration.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: November 1, 2025
 
 Archive-Codec Integration - Register archivers with CodecRegistry.

exonware/xwsystem/io/archive/compression.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: 30-Oct-2025
 
 Compression operations for gzip, bz2, and lzma.

exonware/xwsystem/io/archive/formats/__init__.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: November 1, 2025
 
 Archive format implementations - COMPREHENSIVE 2025 SUPPORT.

exonware/xwsystem/io/archive/formats/brotli_format.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: November 1, 2025
 
 Brotli (.br) compression format - RANK #6 WEB COMPRESSION.
@@ -20,13 +20,16 @@ Priority 5 (Extensibility): Lazy installation of brotli
 
 import tarfile
 from pathlib import Path
-from typing import List, Optional
+from typing import Optional
 
 from ...contracts import IArchiveFormat
 from ...errors import ArchiveError
 
-# Lazy import for brotli - the lazy hook will automatically handle ImportError
-import brotli
+# Lazy import for brotli - optional dependency
+try:
+    import brotli
+except ImportError:
+    brotli = None  # type: ignore
 
 
 class BrotliArchiver(IArchiveFormat):
@@ -58,16 +61,16 @@ class BrotliArchiver(IArchiveFormat):
         return "br"
     
     @property
-    def file_extensions(self) -> List[str]:
+    def file_extensions(self) -> list[str]:
         """Supported extensions."""
         return [".br", ".tar.br", ".tbr"]
     
     @property
-    def mime_types(self) -> List[str]:
+    def mime_types(self) -> list[str]:
         """MIME types."""
         return ["application/x-brotli"]
     
-    def create(self, files: List[Path], output: Path, **opts) -> None:
+    def create(self, files: list[Path], output: Path, **opts) -> None:
         """
         Create Brotli-compressed tar archive.
         
@@ -101,7 +104,7 @@ class BrotliArchiver(IArchiveFormat):
         except Exception as e:
             raise ArchiveError(f"Failed to create brotli archive: {e}")
     
-    def extract(self, archive: Path, output_dir: Path, members: Optional[List[str]] = None, **opts) -> List[Path]:
+    def extract(self, archive: Path, output_dir: Path, members: Optional[list[str]] = None, **opts) -> list[Path]:
         """Extract Brotli archive."""
         output_dir.mkdir(parents=True, exist_ok=True)
         
@@ -128,7 +131,7 @@ class BrotliArchiver(IArchiveFormat):
         except Exception as e:
             raise ArchiveError(f"Failed to extract brotli archive: {e}")
     
-    def list_contents(self, archive: Path) -> List[str]:
+    def list_contents(self, archive: Path) -> list[str]:
         """List Brotli archive contents."""
         try:
             compressed = archive.read_bytes()

exonware/xwsystem/io/archive/formats/lz4_format.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: November 1, 2025
 
 LZ4 compression format - RANK #7 FASTEST COMPRESSION.
@@ -20,13 +20,16 @@ Priority 5 (Extensibility): Lazy installation of lz4
 
 import tarfile
 from pathlib import Path
-from typing import List, Optional
+from typing import Optional
 
 from ...contracts import IArchiveFormat
 from ...errors import ArchiveError
 
-# Lazy import for lz4 - the lazy hook will automatically handle ImportError
-import lz4.frame as lz4
+# Lazy import for lz4 - optional dependency
+try:
+    import lz4.frame as lz4
+except ImportError:
+    lz4 = None  # type: ignore
 
 
 class Lz4Archiver(IArchiveFormat):
@@ -58,16 +61,16 @@ class Lz4Archiver(IArchiveFormat):
         return "lz4"
     
     @property
-    def file_extensions(self) -> List[str]:
+    def file_extensions(self) -> list[str]:
         """Supported extensions."""
         return [".lz4", ".tar.lz4", ".tlz4"]
     
     @property
-    def mime_types(self) -> List[str]:
+    def mime_types(self) -> list[str]:
         """MIME types."""
         return ["application/x-lz4"]
     
-    def create(self, files: List[Path], output: Path, **opts) -> None:
+    def create(self, files: list[Path], output: Path, **opts) -> None:
         """
         Create LZ4-compressed tar archive.
         
@@ -100,7 +103,7 @@ class Lz4Archiver(IArchiveFormat):
         except Exception as e:
             raise ArchiveError(f"Failed to create lz4 archive: {e}")
     
-    def extract(self, archive: Path, output_dir: Path, members: Optional[List[str]] = None, **opts) -> List[Path]:
+    def extract(self, archive: Path, output_dir: Path, members: Optional[list[str]] = None, **opts) -> list[Path]:
         """Extract LZ4 archive."""
         output_dir.mkdir(parents=True, exist_ok=True)
         
@@ -127,7 +130,7 @@ class Lz4Archiver(IArchiveFormat):
         except Exception as e:
             raise ArchiveError(f"Failed to extract lz4 archive: {e}")
     
-    def list_contents(self, archive: Path) -> List[str]:
+    def list_contents(self, archive: Path) -> list[str]:
         """List LZ4 archive contents."""
         try:
             compressed = archive.read_bytes()

exonware/xwsystem/io/archive/formats/rar.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: November 1, 2025
 
 RAR5 archive format implementation - RANK #3 PROPRIETARY COMPRESSION.
@@ -19,13 +19,16 @@ Priority 5 (Extensibility): Optional rarfile dependency
 """
 
 from pathlib import Path
-from typing import List, Optional
+from typing import Optional
 
 from ...contracts import IArchiveFormat
 from ...errors import ArchiveError
 
-# Lazy import for rarfile - the lazy hook will automatically handle ImportError
-import rarfile
+# Lazy import for rarfile - optional dependency
+try:
+    import rarfile
+except ImportError:
+    rarfile = None  # type: ignore
 
 
 class RarArchiver(IArchiveFormat):
@@ -58,16 +61,16 @@ class RarArchiver(IArchiveFormat):
         return "rar"
     
     @property
-    def file_extensions(self) -> List[str]:
+    def file_extensions(self) -> list[str]:
         """Supported extensions."""
         return [".rar", ".r00", ".r01"]
     
     @property
-    def mime_types(self) -> List[str]:
+    def mime_types(self) -> list[str]:
         """MIME types."""
         return ["application/vnd.rar", "application/x-rar-compressed"]
     
-    def create(self, files: List[Path], output: Path, **opts) -> None:
+    def create(self, files: list[Path], output: Path, **opts) -> None:
         """
         RAR creation not supported (proprietary).
         
@@ -78,7 +81,7 @@ class RarArchiver(IArchiveFormat):
             "Use SevenZipArchiver or ZstandardArchiver instead for creation."
         )
     
-    def extract(self, archive: Path, output_dir: Path, members: Optional[List[str]] = None, **opts) -> List[Path]:
+    def extract(self, archive: Path, output_dir: Path, members: Optional[list[str]] = None, **opts) -> list[Path]:
         """
         Extract RAR archive.
         
@@ -106,7 +109,7 @@ class RarArchiver(IArchiveFormat):
         except Exception as e:
             raise ArchiveError(f"Failed to extract RAR archive: {e}")
     
-    def list_contents(self, archive: Path) -> List[str]:
+    def list_contents(self, archive: Path) -> list[str]:
         """List RAR contents."""
         if rarfile is None:
             raise ArchiveError("rarfile not installed. Install with: pip install rarfile")

exonware/xwsystem/io/archive/formats/sevenzip.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: November 1, 2025
 
 7z archive format implementation - RANK #1 BEST COMPRESSION.
@@ -19,13 +19,16 @@ Priority 5 (Extensibility): Lazy installation of py7zr
 """
 
 from pathlib import Path
-from typing import List, Optional
+from typing import Optional
 
 from ...contracts import IArchiveFormat
 from ...errors import ArchiveError
 
-# Lazy import for py7zr - the lazy hook will automatically handle ImportError
-import py7zr
+# Lazy import for py7zr - optional dependency
+try:
+    import py7zr
+except ImportError:
+    py7zr = None  # type: ignore
 
 
 class SevenZipArchiver(IArchiveFormat):
@@ -57,16 +60,16 @@ class SevenZipArchiver(IArchiveFormat):
         return "7z"
     
     @property
-    def file_extensions(self) -> List[str]:
+    def file_extensions(self) -> list[str]:
         """Supported extensions."""
         return [".7z"]
     
     @property
-    def mime_types(self) -> List[str]:
+    def mime_types(self) -> list[str]:
         """MIME types."""
         return ["application/x-7z-compressed"]
     
-    def create(self, files: List[Path], output: Path, **opts) -> None:
+    def create(self, files: list[Path], output: Path, **opts) -> None:
         """
         Create 7z archive with optional encryption.
         
@@ -92,7 +95,7 @@ class SevenZipArchiver(IArchiveFormat):
         except Exception as e:
             raise ArchiveError(f"Failed to create 7z archive: {e}")
     
-    def extract(self, archive: Path, output_dir: Path, members: Optional[List[str]] = None, **opts) -> List[Path]:
+    def extract(self, archive: Path, output_dir: Path, members: Optional[list[str]] = None, **opts) -> list[Path]:
         """
         Extract 7z archive.
         
@@ -114,7 +117,7 @@ class SevenZipArchiver(IArchiveFormat):
         except Exception as e:
             raise ArchiveError(f"Failed to extract 7z archive: {e}")
     
-    def list_contents(self, archive: Path) -> List[str]:
+    def list_contents(self, archive: Path) -> list[str]:
         """List 7z contents."""
         try:
             with py7zr.SevenZipFile(archive, 'r') as zf:

exonware/xwsystem/io/archive/formats/squashfs_format.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: November 1, 2025
 
 SquashFS filesystem format - RANK #10 EMBEDDED SYSTEMS.
@@ -19,7 +19,7 @@ Priority 5 (Extensibility): Binary tool integration
 """
 
 from pathlib import Path
-from typing import List, Optional
+from typing import Optional
 import subprocess
 import shutil
 
@@ -56,12 +56,12 @@ class SquashfsArchiver(IArchiveFormat):
         return "squashfs"
     
     @property
-    def file_extensions(self) -> List[str]:
+    def file_extensions(self) -> list[str]:
         """Supported extensions."""
         return [".squashfs", ".sfs", ".sqfs"]
     
     @property
-    def mime_types(self) -> List[str]:
+    def mime_types(self) -> list[str]:
         """MIME types."""
         return ["application/x-squashfs"]
     
@@ -80,7 +80,7 @@ class SquashfsArchiver(IArchiveFormat):
         
         return Path(mksquashfs), Path(unsquashfs)
     
-    def create(self, files: List[Path], output: Path, **opts) -> None:
+    def create(self, files: list[Path], output: Path, **opts) -> None:
         """
         Create SquashFS filesystem.
         
@@ -111,7 +111,7 @@ class SquashfsArchiver(IArchiveFormat):
         except Exception as e:
             raise ArchiveError(f"Failed to create squashfs: {e}")
     
-    def extract(self, archive: Path, output_dir: Path, members: Optional[List[str]] = None, **opts) -> List[Path]:
+    def extract(self, archive: Path, output_dir: Path, members: Optional[list[str]] = None, **opts) -> list[Path]:
         """Extract SquashFS filesystem."""
         output_dir.mkdir(parents=True, exist_ok=True)
         _, unsquashfs = self._check_tools()
@@ -132,7 +132,7 @@ class SquashfsArchiver(IArchiveFormat):
         except Exception as e:
             raise ArchiveError(f"Failed to extract squashfs: {e}")
     
-    def list_contents(self, archive: Path) -> List[str]:
+    def list_contents(self, archive: Path) -> list[str]:
         """List SquashFS contents."""
         _, unsquashfs = self._check_tools()
         

exonware/xwsystem/io/archive/formats/tar.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: 30-Oct-2025
 
 TAR archive format implementation.
@@ -18,7 +18,7 @@ Priority 5 (Extensibility): Registered via registry
 
 import tarfile
 from pathlib import Path
-from typing import List, Optional
+from typing import Optional
 
 from ...contracts import IArchiveFormat
 
@@ -32,12 +32,12 @@ class TarArchiver(IArchiveFormat):
         return "tar"
     
     @property
-    def file_extensions(self) -> List[str]:
+    def file_extensions(self) -> list[str]:
         """Supported extensions."""
         return [".tar", ".tar.gz", ".tgz", ".tar.bz2", ".tbz2", ".tar.xz", ".txz"]
     
     @property
-    def mime_types(self) -> List[str]:
+    def mime_types(self) -> list[str]:
         """MIME types."""
         return [
             "application/x-tar",
@@ -61,7 +61,7 @@ class TarArchiver(IArchiveFormat):
         else:
             return 'r:*'  # Auto-detect compression on read
     
-    def create(self, files: List[Path], output: Path, **opts) -> None:
+    def create(self, files: list[Path], output: Path, **opts) -> None:
         """Create TAR archive."""
         output.parent.mkdir(parents=True, exist_ok=True)
         
@@ -72,10 +72,10 @@ class TarArchiver(IArchiveFormat):
                 arcname = opts.get('arcname', file_path.name)
                 tf.add(file_path, arcname=arcname)
     
-    def extract(self, archive: Path, output_dir: Path, members: Optional[List[str]] = None, **opts) -> List[Path]:
+    def extract(self, archive: Path, output_dir: Path, members: Optional[list[str]] = None, **opts) -> list[Path]:
         """Extract TAR archive."""
         output_dir.mkdir(parents=True, exist_ok=True)
-        extracted: List[Path] = []
+        extracted: list[Path] = []
         
         with tarfile.open(archive, 'r:*') as tf:
             if members:
@@ -88,7 +88,7 @@ class TarArchiver(IArchiveFormat):
         
         return extracted
     
-    def list_contents(self, archive: Path) -> List[str]:
+    def list_contents(self, archive: Path) -> list[str]:
         """List TAR contents."""
         with tarfile.open(archive, 'r:*') as tf:
             return [member.name for member in tf.getmembers()]

exonware/xwsystem/io/archive/formats/wim_format.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: November 1, 2025
 
 WIM (Windows Imaging) format - RANK #9 SYSTEM IMAGES.
@@ -19,13 +19,16 @@ Priority 5 (Extensibility): Lazy installation of wimlib
 """
 
 from pathlib import Path
-from typing import List, Optional
+from typing import Optional
 
 from ...contracts import IArchiveFormat
 from ...errors import ArchiveError
 
-# Lazy import for wimlib - the lazy hook will automatically handle ImportError
-import wimlib
+# Lazy import for wimlib - optional dependency
+try:
+    import wimlib
+except ImportError:
+    wimlib = None  # type: ignore
 
 
 class WimArchiver(IArchiveFormat):
@@ -55,16 +58,16 @@ class WimArchiver(IArchiveFormat):
         return "wim"
     
     @property
-    def file_extensions(self) -> List[str]:
+    def file_extensions(self) -> list[str]:
         """Supported extensions."""
         return [".wim", ".swm", ".esd"]
     
     @property
-    def mime_types(self) -> List[str]:
+    def mime_types(self) -> list[str]:
         """MIME types."""
         return ["application/x-ms-wim"]
     
-    def create(self, files: List[Path], output: Path, **opts) -> None:
+    def create(self, files: list[Path], output: Path, **opts) -> None:
         """
         Create WIM image.
         
@@ -92,7 +95,7 @@ class WimArchiver(IArchiveFormat):
         except Exception as e:
             raise ArchiveError(f"Failed to create WIM image: {e}")
     
-    def extract(self, archive: Path, output_dir: Path, members: Optional[List[str]] = None, **opts) -> List[Path]:
+    def extract(self, archive: Path, output_dir: Path, members: Optional[list[str]] = None, **opts) -> list[Path]:
         """Extract WIM image."""
         output_dir.mkdir(parents=True, exist_ok=True)
         
@@ -107,7 +110,7 @@ class WimArchiver(IArchiveFormat):
         except Exception as e:
             raise ArchiveError(f"Failed to extract WIM image: {e}")
     
-    def list_contents(self, archive: Path) -> List[str]:
+    def list_contents(self, archive: Path) -> list[str]:
         """List WIM contents."""
         try:
             wim = wimlib.WIM(str(archive), 'r')