exonware-xwsystem 0.1.0.1__py3-none-any.whl → 0.1.0.4__py3-none-any.whl

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

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.4
 Generation Date: November 1, 2025
 
 Zstandard (.zst) compression format - RANK #2 MODERN STANDARD.
@@ -18,6 +18,7 @@ Priority 4 (Performance): Best speed/ratio balance
 Priority 5 (Extensibility): Lazy installation of zstandard
 """
 
+import sys
 import tarfile
 from pathlib import Path
 from typing import Optional
@@ -25,10 +26,17 @@ from typing import Optional
 from ...contracts import IArchiveFormat
 from ...errors import ArchiveError
 
-# Lazy import for zstandard - optional dependency
+# Optional dependency: zstandard
+import importlib.util
 try:
-    import zstandard
-except ImportError:
+    _zstandard_spec = importlib.util.find_spec('zstandard')
+    if _zstandard_spec is not None and _zstandard_spec.loader is not None:
+        import zstandard
+    else:
+        zstandard = None  # type: ignore
+except (ValueError, AttributeError, ImportError):
+    # Handle case where find_spec raises ValueError (e.g., module.__spec__ is None)
+    # or other import-related errors
     zstandard = None  # type: ignore
 
 
@@ -113,12 +121,18 @@ class ZstandardArchiver(IArchiveFormat):
             with archive.open('rb') as f:
                 with dctx.stream_reader(f) as decompressor:
                     with tarfile.open(fileobj=decompressor, mode='r|') as tar:
+                        # Use data filter for Python 3.12+ compatibility (prevents deprecation warning)
+                        # For older Python versions, filter parameter is not available
+                        extract_kwargs = {}
+                        if sys.version_info >= (3, 12):
+                            extract_kwargs['filter'] = 'data'
+                        
                         if members:
                             for member in members:
-                                tar.extract(member, output_dir)
+                                tar.extract(member, output_dir, **extract_kwargs)
                                 extracted.append(output_dir / member)
                         else:
-                            tar.extractall(output_dir)
+                            tar.extractall(output_dir, **extract_kwargs)
                             extracted = [output_dir / m.name for m in tar.getmembers()]
             
             return extracted
@@ -140,4 +154,3 @@ class ZstandardArchiver(IArchiveFormat):
     def add_file(self, archive: Path, file: Path, arcname: Optional[str] = None) -> None:
         """Not supported for streaming format - recreate archive instead."""
         raise ArchiveError("Zstandard streaming format doesn't support append mode. Recreate the archive.")
-