kisstdlib 0.0.6__tar.gz → 0.0.8__tar.gz

{kisstdlib-0.0.6 → kisstdlib-0.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kisstdlib
-Version: 0.0.6
+Version: 0.0.8
 Summary: Keep It Simple STandarD LIBraries set for Python
 Author-email: Jan Malakhovski <oxij@oxij.org>
 Project-URL: Homepage, https://oxij.org/software/kisstdlib/
@@ -12,7 +12,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: License :: OSI Approved :: Python Software Foundation License
 Classifier: License :: OSI Approved :: BSD License
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Requires-Dist: sortedcontainers==2.4.*

kisstdlib-0.0.8/kisstdlib/compression.py

@@ -0,0 +1,56 @@
+# Copyright (c) 2024-2025 Jan Malakhovski <oxij@oxij.org>
+#
+# This file is a part of `kisstdlib` project.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""Simple compression and decompression."""
+
+import gzip as _gzip
+import io as _io
+import typing as _t
+
+
+def gzip_maybe(data: bytes) -> bytes:
+    """Given some bytes, return their GZipped version if they compress, return the original otherwise."""
+    buf = _io.BytesIO()
+    with _gzip.GzipFile(fileobj=buf, filename="", mtime=0, mode="wb", compresslevel=9) as gz:
+        gz.write(data)
+    compressed_data = buf.getvalue()
+
+    if len(compressed_data) < len(data):
+        return compressed_data
+    return data
+
+
+def ungzip_maybe(data: bytes) -> bytes:
+    """UnGZip a `bytes` object if it appears to be GZipped."""
+    if data[:2] != b"\037\213":
+        return data
+
+    with _gzip.GzipFile(fileobj=_io.BytesIO(data), mode="rb") as ungz:
+        return ungz.read()
+
+
+def ungzip_fileobj_maybe(fobj: _io.BufferedReader) -> _io.BufferedReader:
+    """UnGZip a file-like object if it appears to be GZipped."""
+    head = fobj.peek(2)[:2]
+    if head == b"\037\213":
+        fobj = _t.cast(_io.BufferedReader, _gzip.GzipFile(fileobj=fobj, mode="rb"))
+    return fobj