zstd 1.5.6.1__tar.gz → 1.5.6.2__tar.gz

{zstd-1.5.6.1 → zstd-1.5.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: zstd
-Version: 1.5.6.1
+Version: 1.5.6.2
 Summary: ZSTD Bindings for Python
 Home-page: https://github.com/sergey-dryabzhinsky/python-zstd
 Author: Sergey Dryabzhinsky, Anton Stuk
@@ -24,13 +24,25 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 License-File: LICENSE
-
-=============
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: maintainer
+Dynamic: maintainer-email
+Dynamic: summary
+
+7=============
 python-zstd
 =============
 
-.. |releaseW| image:: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml/badge.svg?branch=v1.5.6.0
+.. |releaseW| image:: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml/badge.svg?branch=v1.5.6.2
     :target: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml
 
 .. |masterW| image:: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml/badge.svg
@@ -116,10 +128,30 @@ To build with python-zstd legacy format support (pre 1.1.2) - pass ``--pyzstd-le
 
    >>> $ python setup.py build_ext --pyzstd-legacy clean
 
-If you want to build with existing distribution of libzstd just add ``--external`` option.
 But beware! Legacy formats support state is unknown in this case.
 And if your version not equal with python-zstd - tests may not pass.
 
+If you're scared of threads you may pass option `--libzstd-no-threads`:
+
+   >>> $ python setup.py build_ext --libzstd-no-threads clean
+
+When using a PEP 517 builder you can use ``ZSTD_THREADS`` environment variable instead:
+
+   >>> $ ZSTD_THREADS=0 python -m build -w
+
+If you're meet some cpu instruction errorrs you may try to disable built-in optimizations and pass option `--libzstd-no-use-asm`:
+
+   >>> $ python setup.py build_ext --libzstd-no-use-asm clean
+
+Or add more speed with option `--libzstd-use-asm-bmi2` to use instructions for new AMD CPU.
+When using a PEP 517 builder you can use ``ZSTD_ASM`` environment variable instead:
+And ``ZST_ASM_BMI2=1`` too for bmi2 use.
+
+   >>> $ ZSTD_ASM=0 python -m build -w
+
+
+If you want to build with existing distribution of libzstd just add ``--external`` option
+
    >>> $ python setup.py build_ext --external clean
 
 When using a PEP 517 builder you can use ``ZSTD_EXTERNAL`` environment variable instead:
@@ -156,7 +188,10 @@ ZSTD_compress (data[, level, threads]): string|bytes
   * **level**: int - compression level, ultra-fast levels from -100 (ultra) to -1 (fast) available since zstd-1.3.4, and from 1 (fast) to 22 (slowest), 0 or unset - means default (3). Default - 3.
   * **threads**: int - how many threads to use, from 0 to 200, 0 or unset - auto-tune by cpu cores count. Default - 0. Since: 1.4.4.1
 
-  Aliases: *compress(...)*, *dumps(...)*
+  Aliases:
+       - *compress(...)*, 
+       - *dumps(...)*, 
+       - *encode(...)* since: 1.5.6.2
 
   Exception if:
   - level bigger than max level
@@ -164,7 +199,7 @@ ZSTD_compress (data[, level, threads]): string|bytes
   Max number of threads:
   - 32bit system: 64
   - 64bit system: 256
-  If provided bigger number - silemtly set maximum number (since 1.5.4.1)
+  If provided bigger number - silently set maximber (since 1.5.4.1)
 
   Since: 0.1
 
@@ -177,10 +212,28 @@ ZSTD_uncompress (data): string|bytes
 
   * **data**: string|bytes - input compressed data block, length limited by 2Gb by Python API
 
-  Aliases: *decompress(...)*, *uncompress(...)*, *loads(...)*
+  Aliases: 
+     - *decompress(...)*, 
+     - *uncompress(...)*,  
+     - *loads(...)*, 
+     - *decode(...)* since: 1.5.6.2
 
   Since: 0.1
 
+ZSTD_check (data): string|bytes
+  Function, checks if input is zstd compressed data block, return s1if yes, 0 if no, or raises Error.
+
+  Support compressed data with multiple/concatenated frames (blocks) .
+
+  Params:
+
+  * **data**: string|bytes - input compressed data block, length limited by 2Gb by Python API
+
+  Aliases:
+     - *check(...)*,
+
+  Since: 1.5.6.2
+
 version (): string|bytes
   Returns this module doted version string.
 
@@ -214,6 +267,16 @@ ZSTD_external (): int
 
   Since: 1.5.0.2
 
+ZSTD_with_threads (): int
+  Returns 0 of 1 if bundled ZSTD library build with threads support.
+
+  Since: 1.5.6.2
+
+ZSTD_with_asm (): int
+  Returns 0 of 1 if bundled ZSTD library build with asm optimization s.
+
+  Since: 1.5.6.2
+
 
 Removed
 _______

zstd-1.5.6.1/src/zstd.egg-info/PKG-INFO → zstd-1.5.6.2/README.rst

@@ -1,36 +1,8 @@
-Metadata-Version: 2.1
-Name: zstd
-Version: 1.5.6.1
-Summary: ZSTD Bindings for Python
-Home-page: https://github.com/sergey-dryabzhinsky/python-zstd
-Author: Sergey Dryabzhinsky, Anton Stuk
-Author-email: sergey.dryabzhinsky@gmail.com
-Maintainer: Sergey Dryabzhinsky
-Maintainer-email: sergey.dryabzhinsky@gmail.com
-License: BSD
-Keywords: zstd,zstandard,compression
-Classifier: License :: OSI Approved :: BSD License
-Classifier: Intended Audience :: Developers
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Operating System :: POSIX
-Classifier: Programming Language :: C
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 2.7
-Classifier: Programming Language :: Python :: 3.4
-Classifier: Programming Language :: Python :: 3.5
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-License-File: LICENSE
-
-=============
+7=============
 python-zstd
 =============
 
-.. |releaseW| image:: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml/badge.svg?branch=v1.5.6.0
+.. |releaseW| image:: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml/badge.svg?branch=v1.5.6.2
     :target: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml
 
 .. |masterW| image:: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml/badge.svg
@@ -116,10 +88,30 @@ To build with python-zstd legacy format support (pre 1.1.2) - pass ``--pyzstd-le
 
    >>> $ python setup.py build_ext --pyzstd-legacy clean
 
-If you want to build with existing distribution of libzstd just add ``--external`` option.
 But beware! Legacy formats support state is unknown in this case.
 And if your version not equal with python-zstd - tests may not pass.
 
+If you're scared of threads you may pass option `--libzstd-no-threads`:
+
+   >>> $ python setup.py build_ext --libzstd-no-threads clean
+
+When using a PEP 517 builder you can use ``ZSTD_THREADS`` environment variable instead:
+
+   >>> $ ZSTD_THREADS=0 python -m build -w
+
+If you're meet some cpu instruction errorrs you may try to disable built-in optimizations and pass option `--libzstd-no-use-asm`:
+
+   >>> $ python setup.py build_ext --libzstd-no-use-asm clean
+
+Or add more speed with option `--libzstd-use-asm-bmi2` to use instructions for new AMD CPU.
+When using a PEP 517 builder you can use ``ZSTD_ASM`` environment variable instead:
+And ``ZST_ASM_BMI2=1`` too for bmi2 use.
+
+   >>> $ ZSTD_ASM=0 python -m build -w
+
+
+If you want to build with existing distribution of libzstd just add ``--external`` option
+
    >>> $ python setup.py build_ext --external clean
 
 When using a PEP 517 builder you can use ``ZSTD_EXTERNAL`` environment variable instead:
@@ -156,7 +148,10 @@ ZSTD_compress (data[, level, threads]): string|bytes
   * **level**: int - compression level, ultra-fast levels from -100 (ultra) to -1 (fast) available since zstd-1.3.4, and from 1 (fast) to 22 (slowest), 0 or unset - means default (3). Default - 3.
   * **threads**: int - how many threads to use, from 0 to 200, 0 or unset - auto-tune by cpu cores count. Default - 0. Since: 1.4.4.1
 
-  Aliases: *compress(...)*, *dumps(...)*
+  Aliases:
+       - *compress(...)*, 
+       - *dumps(...)*, 
+       - *encode(...)* since: 1.5.6.2
 
   Exception if:
   - level bigger than max level
@@ -164,7 +159,7 @@ ZSTD_compress (data[, level, threads]): string|bytes
   Max number of threads:
   - 32bit system: 64
   - 64bit system: 256
-  If provided bigger number - silemtly set maximum number (since 1.5.4.1)
+  If provided bigger number - silently set maximber (since 1.5.4.1)
 
   Since: 0.1
 
@@ -177,10 +172,28 @@ ZSTD_uncompress (data): string|bytes
 
   * **data**: string|bytes - input compressed data block, length limited by 2Gb by Python API
 
-  Aliases: *decompress(...)*, *uncompress(...)*, *loads(...)*
+  Aliases: 
+     - *decompress(...)*, 
+     - *uncompress(...)*,  
+     - *loads(...)*, 
+     - *decode(...)* since: 1.5.6.2
 
   Since: 0.1
 
+ZSTD_check (data): string|bytes
+  Function, checks if input is zstd compressed data block, return s1if yes, 0 if no, or raises Error.
+
+  Support compressed data with multiple/concatenated frames (blocks) .
+
+  Params:
+
+  * **data**: string|bytes - input compressed data block, length limited by 2Gb by Python API
+
+  Aliases:
+     - *check(...)*,
+
+  Since: 1.5.6.2
+
 version (): string|bytes
   Returns this module doted version string.
 
@@ -214,6 +227,16 @@ ZSTD_external (): int
 
   Since: 1.5.0.2
 
+ZSTD_with_threads (): int
+  Returns 0 of 1 if bundled ZSTD library build with threads support.
+
+  Since: 1.5.6.2
+
+ZSTD_with_asm (): int
+  Returns 0 of 1 if bundled ZSTD library build with asm optimization s.
+
+  Since: 1.5.6.2
+
 
 Removed
 _______

{zstd-1.5.6.1 → zstd-1.5.6.2}/setup.py

@@ -14,7 +14,7 @@ VERSION_STR = ".".join([str(x) for x in VERSION])
 # Package version
 PKG_VERSION = VERSION
 # Minor versions
-PKG_VERSION += ("1",)
+PKG_VERSION += ("2",)
 PKG_VERSION_STR = ".".join([str(x) for x in PKG_VERSION])
 
 ###
@@ -27,6 +27,35 @@ if "--legacy" in sys.argv:
     SUP_LEGACY=True
     sys.argv.remove("--legacy")
 
+SUP_ASM="ZSTD_ASM" in os.environ or True 
+#a asm on by default
+if "--libzstd-no-use-asm" in sys.argv:
+    # Support assembler builtin optimization in lizstd
+    SUP_ASM=False
+    sys.argv.remove("--libzstd-no-use-asm")
+DISABLE_ASM=1
+if SUP_ASM:
+     DISABLE_ASM=0
+
+SUP_THREADS="ZSTD_THREADS" in os.environ or True
+# threads on by default
+if "--libzstd-no-threads" in sys.argv:
+    # Disable support multithreading in lizstd
+    SUP_THREADS=False
+    sys.argv.remove("--libzstd-no-threads")
+ENABLE_THREADS=0
+if SUP_THREADS:
+     ENABLE_THREADS=1
+
+SUP_ASM_BMI2="ZSTD_ASM_BMI2" in os.environ
+if "--libzstd-use-asm-bmi2" in sys.argv:
+    # Support assembler builtin optimization in lizstd for new AMD CPU
+    SUP_ASM_BMI2=True 
+    sys.argv.remove("--libzstd-use-asm-bmi2")
+ENABLE_ASM_BMI2=0
+if SUP_ASM_BMI2:
+     ENABLE_ASM_BMI2=1
+
 SUP_TRACE="ZSTD_TRACE" in os.environ
 if "--debug-trace" in sys.argv:
     # Support tracing for debug
@@ -68,21 +97,21 @@ if SUP_EXTERNAL:
 # DZSTD_DISABLE_ASM=1 - disable ASM inlines, pypi/pip can't build them
 #
 COPT = {
-    'msvc':     [ '/Ox', '/DVERSION=%s' % PKG_VERSION_STR, '/DDYNAMIC_BMI2=0', '/DZSTD_DISABLE_ASM=1' ],
-    'mingw32':  [ '-O2', '-DVERSION=%s' % PKG_VERSION_STR, '-DDYNAMIC_BMI2=0', '-DZSTD_DISABLE_ASM=1' ],
-    'unix':     [ '-O2', '-DVERSION=%s' % PKG_VERSION_STR, '-DDYNAMIC_BMI2=0', '-DZSTD_DISABLE_ASM=1' ],
-    'clang':    [ '-O2', '-DVERSION=%s' % PKG_VERSION_STR, '-DDYNAMIC_BMI2=0', '-DZSTD_DISABLE_ASM=1' ],
-    'gcc':      [ '-O2', '-DVERSION=%s' % PKG_VERSION_STR, '-DDYNAMIC_BMI2=0', '-DZSTD_DISABLE_ASM=1' ]
+    'msvc':     [ '/Ox', '/DVERSION=%s' % PKG_VERSION_STR, '/DDYNAMIC_BMI2=%d' % ENABLE_ASM_BMI2, '/DZSTD_DISABLE_ASM=%d' % DISABLE_ASM ],
+    'mingw32':  [ '-O2', '-DVERSION=%s' % PKG_VERSION_STR, '-DDYNAMIC_BMI2=%d' % ENABLE_ASM_BMI2, '-DZSTD_DISABLE_ASM=%d' % DISABLE_ASM ],
+    'unix':     [ '-O2', '-DVERSION=%s' % PKG_VERSION_STR, '-DDYNAMIC_BMI2=%d' % ENABLE_ASM_BMI2, '-DZSTD_DISABLE_ASM=%d' % DISABLE_ASM ],
+    'clang':    [ '-O2', '-DVERSION=%s' % PKG_VERSION_STR, '-DDYNAMIC_BMI2=%d' % ENABLE_ASM_BMI2, '-DZSTD_DISABLE_ASM=%d' % DISABLE_ASM ],
+    'gcc':      [ '-O2', '-DVERSION=%s' % PKG_VERSION_STR, '-DDYNAMIC_BMI2=%d' % ENABLE_ASM_BMI2, '-DZSTD_DISABLE_ASM=%d' % DISABLE_ASM ]
 }
 
 if not SUP_EXTERNAL:
     for comp in COPT:
         if comp == 'msvc':
-            COPT[comp].extend([ '/DZSTD_MULTITHREAD=1',
+            COPT[comp].extend([ '/DZSTD_MULTITHREAD=%d' % ENABLE_THREADS,
                 '/Izstd\\lib', '/Izstd\\lib\\common', '/Izstd\\lib\\compress', '/Izstd\\lib\\decompress',
             ])
         else:
-            COPT[comp].extend([ '-DZSTD_MULTITHREAD=1',
+            COPT[comp].extend([ '-DZSTD_MULTITHREAD=%d' % ENABLE_THREADS,
                 '-Izstd/lib', '-Izstd/lib/common', '-Izstd/lib/compress', '-Izstd/lib/decompress',
             ])
 else:
@@ -218,5 +247,7 @@ setup(
         'Programming Language :: Python :: 3.9',
         'Programming Language :: Python :: 3.10',
         'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
+        'Programming Language :: Python :: 3.13',
     ]
 )

{zstd-1.5.6.1 → zstd-1.5.6.2}/src/python-zstd.c

@@ -196,6 +196,8 @@ static PyObject *py_zstd_uncompress(PyObject* self, PyObject *args)
             PyErr_Format(ZstdError, "Decompression error: length mismatch -> decomp %lu != %lu [header]", (uint64_t)cSize, dest_size);
             error = 1;
         }
+    } else {
+         error = 1;
     }
 
     if (error) {
@@ -210,6 +212,53 @@ static PyObject *py_zstd_uncompress(PyObject* self, PyObject *args)
     return result;
 }
 
+/**
+ * New more interoperable function
+ * Uses origin zstd header, nothing more
+ * Simple version: check if data block has zstd compressed data inside
+ */
+static PyObject *py_zstd_check(PyObject* self, PyObject *args)
+{
+    //PyObject    *result;
+    const char  *source, *src;
+    Py_ssize_t  source_size, ss, seek_frame;
+    uint64_t    dest_size, frame_size;
+    //char        error = 0;
+    //size_t      cSize;
+
+#if PY_MAJOR_VERSION >= 3
+    if (!PyArg_ParseTuple(args, "y#", &source, &source_size))
+        return NULL;
+#else
+    if (!PyArg_ParseTuple(args, "s#", &source, &source_size))
+        return NULL;
+#endif
+
+    dest_size = (uint64_t) ZSTD_getFrameContentSize(source, source_size);
+    if (dest_size == ZSTD_CONTENTSIZE_UNKNOWN || dest_size == ZSTD_CONTENTSIZE_ERROR) {
+        //PyErr_Format(ZstdError, "Input data invalid or missing content size in frame header.");
+        return Py_BuildValue("i", 0);
+    }
+
+	// Find real dest_size across multiple frames
+	ss = source_size;
+	seek_frame = ss - 1;
+	src = source;
+	while (seek_frame < ss) {
+		seek_frame = ZSTD_findFrameCompressedSize(src, ss);
+		if (ZSTD_isError(seek_frame)) break;
+		src += seek_frame;
+		ss -= seek_frame;
+		if (ss <=0) break;
+		frame_size = (uint64_t) ZSTD_getFrameContentSize(src, ss);
+		if (ZSTD_isError(frame_size)) break;
+		dest_size += frame_size;
+	}
+    if (dest_size>=source_size)
+        Py_BuildValue("i", 0);
+    return Py_BuildValue("i", 1);
+}
+
 /**
  * Returns this module version as string
  */
@@ -251,6 +300,25 @@ static PyObject *py_zstd_library_external(PyObject* self, PyObject *args)
 }
 
 
+/**
+ * Returns 0 or 1 if ZSTD library build with threads
+ */
+static PyObject *py_zstd_with_threads(PyObject* self, PyObject *args)
+{
+    return Py_BuildValue("i", ZSTD_MULTITHREAD);
+}
+
+
+/**
+ * Returns 0 or 1 if ZSTD library build with threads
+ */
+static PyObject *py_zstd_with_asm(PyObject* self, PyObject *args)
+{
+    return Py_BuildValue("i", ! ZSTD_DISABLE_ASM);
+}
+
+
+
 /**
  * Returns ZSTD determined threads count, int
  */
@@ -273,8 +341,12 @@ static PyObject *py_zstd_max_threads_count(PyObject* self, PyObject *args)
 static PyMethodDef ZstdMethods[] = {
     {"ZSTD_compress",  py_zstd_compress_mt, METH_VARARGS, COMPRESS_DOCSTRING},
     {"ZSTD_uncompress",  py_zstd_uncompress, METH_VARARGS, UNCOMPRESS_DOCSTRING},
+    {"ZSTD_check",  py_zstd_check, METH_VARARGS, CHECK_DOCSTRING},
+    {"check",  py_zstd_check, METH_VARARGS, CHECK_DOCSTRING},
     {"compress",  py_zstd_compress_mt, METH_VARARGS, COMPRESS_DOCSTRING},
     {"uncompress",  py_zstd_uncompress, METH_VARARGS, UNCOMPRESS_DOCSTRING},
+    {"encode",  py_zstd_compress_mt, METH_VARARGS, COMPRESS_DOCSTRING},
+    {"decode",  py_zstd_uncompress, METH_VARARGS, UNCOMPRESS_DOCSTRING},
     {"decompress",  py_zstd_uncompress, METH_VARARGS, UNCOMPRESS_DOCSTRING},
     {"dumps",  py_zstd_compress_mt, METH_VARARGS, COMPRESS_DOCSTRING},
     {"loads",  py_zstd_uncompress, METH_VARARGS, UNCOMPRESS_DOCSTRING},
@@ -284,6 +356,8 @@ static PyMethodDef ZstdMethods[] = {
     {"ZSTD_threads_count",  py_zstd_threads_count, METH_NOARGS, ZSTD_THREADS_COUNT_DOCSTRING},
     {"ZSTD_max_threads_count",  py_zstd_max_threads_count, METH_NOARGS, ZSTD_MAX_THREADS_COUNT_DOCSTRING},
     {"ZSTD_external",  py_zstd_library_external, METH_NOARGS, ZSTD_EXTERNAL_DOCSTRING},
+    {"ZSTD_with_threads",  py_zstd_with_threads, METH_NOARGS, ZSTD_WITH_THREADS_DOCSTRING},
+    {"ZSTD_with_asm",  py_zstd_with_asm, METH_NOARGS, ZSTD_WITH_ASM_DOCSTRING},
     {NULL, NULL, 0, NULL}
 };
 

{zstd-1.5.6.1 → zstd-1.5.6.2}/src/python-zstd.h

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015-2020 Sergey Dryabzhinsky
+ * Copyright (c) 2015-2025 Sergey Dryabzhinsky
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -80,10 +80,13 @@ static PyObject *ZstdError;
 
 static PyObject *py_zstd_compress_mt(PyObject* self, PyObject *args);
 static PyObject *py_zstd_uncompress(PyObject* self, PyObject *args);
+static PyObject *py_zstd_check(PyObject* self, PyObject *args);
 static PyObject *py_zstd_module_version(PyObject* self, PyObject *args);
 static PyObject *py_zstd_library_version(PyObject* self, PyObject *args);
 static PyObject *py_zstd_library_version_int(PyObject* self, PyObject *args);
 static PyObject *py_zstd_library_external(PyObject* self, PyObject *args);
+static PyObject *py_zstd_with_threads(PyObject* self, PyObject *args);
+static PyObject *py_zstd_with_asm(PyObject* self, PyObject *args);
 
 #if PY_MAJOR_VERSION < 3
 PyMODINIT_FUNC initzstd(void);
@@ -104,10 +107,14 @@ Raises a zstd.Error exception if any error occurs."
 
 #define UNCOMPRESS_DOCSTRING    "decompress("PY_BYTESTR_TYPE"): string -- Returns uncompressed string.\n\nRaises a zstd.Error exception if any error occurs."
 
+#define CHECK_DOCSTRING    "check("PY_BYTESTR_TYPE"): string -- Returns 0 or 1.\n\nRaises a zstd.Error exception if any error occurs."
+
 #define VERSION_DOCSTRING       "version(): string -- Returns this module version as string."
 #define ZSTD_VERSION_DOCSTRING  "ZSTD_version(): string -- Returns ZSTD library version as string."
 #define ZSTD_INT_VERSION_DOCSTRING  "ZSTD_version_number(): int -- Returns ZSTD library version as integer.\n Format of the number is: major * 100*100 + minor * 100 + release."
 #define ZSTD_EXTERNAL_DOCSTRING  "ZSTD_external(): int -- Returns 0 or 1 if ZSTD library build as external."
+#define ZSTD_WITH_THREADS_DOCSTRING  "ZSTD_with_threads(): int -- Returns 0 or 1 if ZSTD library build with threads support."
+#define ZSTD_WITH_ASM_DOCSTRING  "ZSTD_with_asm(): int -- Returns 0 or 1 if ZSTD library build with assembler support."
 #define ZSTD_THREADS_COUNT_DOCSTRING  "ZSTD_threads_count(): int -- Returns ZSTD determined CPU cores count in integer."
 #define ZSTD_MAX_THREADS_COUNT_DOCSTRING  "ZSTD_max_threads_count(): int -- Returns ZSTD library determined maximum working threads count in integer."
 

zstd-1.5.6.1/README.rst → zstd-1.5.6.2/src/zstd.egg-info/PKG-INFO

@@ -1,8 +1,48 @@
-=============
+Metadata-Version: 2.2
+Name: zstd
+Version: 1.5.6.2
+Summary: ZSTD Bindings for Python
+Home-page: https://github.com/sergey-dryabzhinsky/python-zstd
+Author: Sergey Dryabzhinsky, Anton Stuk
+Author-email: sergey.dryabzhinsky@gmail.com
+Maintainer: Sergey Dryabzhinsky
+Maintainer-email: sergey.dryabzhinsky@gmail.com
+License: BSD
+Keywords: zstd,zstandard,compression
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Intended Audience :: Developers
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: maintainer
+Dynamic: maintainer-email
+Dynamic: summary
+
+7=============
 python-zstd
 =============
 
-.. |releaseW| image:: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml/badge.svg?branch=v1.5.6.0
+.. |releaseW| image:: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml/badge.svg?branch=v1.5.6.2
     :target: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml
 
 .. |masterW| image:: https://github.com/sergey-dryabzhinsky/python-zstd/actions/workflows/build-wheels.yml/badge.svg
@@ -88,10 +128,30 @@ To build with python-zstd legacy format support (pre 1.1.2) - pass ``--pyzstd-le
 
    >>> $ python setup.py build_ext --pyzstd-legacy clean
 
-If you want to build with existing distribution of libzstd just add ``--external`` option.
 But beware! Legacy formats support state is unknown in this case.
 And if your version not equal with python-zstd - tests may not pass.
 
+If you're scared of threads you may pass option `--libzstd-no-threads`:
+
+   >>> $ python setup.py build_ext --libzstd-no-threads clean
+
+When using a PEP 517 builder you can use ``ZSTD_THREADS`` environment variable instead:
+
+   >>> $ ZSTD_THREADS=0 python -m build -w
+
+If you're meet some cpu instruction errorrs you may try to disable built-in optimizations and pass option `--libzstd-no-use-asm`:
+
+   >>> $ python setup.py build_ext --libzstd-no-use-asm clean
+
+Or add more speed with option `--libzstd-use-asm-bmi2` to use instructions for new AMD CPU.
+When using a PEP 517 builder you can use ``ZSTD_ASM`` environment variable instead:
+And ``ZST_ASM_BMI2=1`` too for bmi2 use.
+
+   >>> $ ZSTD_ASM=0 python -m build -w
+
+
+If you want to build with existing distribution of libzstd just add ``--external`` option
+
    >>> $ python setup.py build_ext --external clean
 
 When using a PEP 517 builder you can use ``ZSTD_EXTERNAL`` environment variable instead:
@@ -128,7 +188,10 @@ ZSTD_compress (data[, level, threads]): string|bytes
   * **level**: int - compression level, ultra-fast levels from -100 (ultra) to -1 (fast) available since zstd-1.3.4, and from 1 (fast) to 22 (slowest), 0 or unset - means default (3). Default - 3.
   * **threads**: int - how many threads to use, from 0 to 200, 0 or unset - auto-tune by cpu cores count. Default - 0. Since: 1.4.4.1
 
-  Aliases: *compress(...)*, *dumps(...)*
+  Aliases:
+       - *compress(...)*, 
+       - *dumps(...)*, 
+       - *encode(...)* since: 1.5.6.2
 
   Exception if:
   - level bigger than max level
@@ -136,7 +199,7 @@ ZSTD_compress (data[, level, threads]): string|bytes
   Max number of threads:
   - 32bit system: 64
   - 64bit system: 256
-  If provided bigger number - silemtly set maximum number (since 1.5.4.1)
+  If provided bigger number - silently set maximber (since 1.5.4.1)
 
   Since: 0.1
 
@@ -149,10 +212,28 @@ ZSTD_uncompress (data): string|bytes
 
   * **data**: string|bytes - input compressed data block, length limited by 2Gb by Python API
 
-  Aliases: *decompress(...)*, *uncompress(...)*, *loads(...)*
+  Aliases: 
+     - *decompress(...)*, 
+     - *uncompress(...)*,  
+     - *loads(...)*, 
+     - *decode(...)* since: 1.5.6.2
 
   Since: 0.1
 
+ZSTD_check (data): string|bytes
+  Function, checks if input is zstd compressed data block, return s1if yes, 0 if no, or raises Error.
+
+  Support compressed data with multiple/concatenated frames (blocks) .
+
+  Params:
+
+  * **data**: string|bytes - input compressed data block, length limited by 2Gb by Python API
+
+  Aliases:
+     - *check(...)*,
+
+  Since: 1.5.6.2
+
 version (): string|bytes
   Returns this module doted version string.
 
@@ -186,6 +267,16 @@ ZSTD_external (): int
 
   Since: 1.5.0.2
 
+ZSTD_with_threads (): int
+  Returns 0 of 1 if bundled ZSTD library build with threads support.
+
+  Since: 1.5.6.2
+
+ZSTD_with_asm (): int
+  Returns 0 of 1 if bundled ZSTD library build with asm optimization s.
+
+  Since: 1.5.6.2
+
 
 Removed
 _______

{zstd-1.5.6.1 → zstd-1.5.6.2}/src/zstd.egg-info/SOURCES.txt

@@ -14,6 +14,8 @@ src/zstd.egg-info/top_level.txt
 tests/__init__.py
 tests/base.py
 tests/test_compress.py
+tests/test_decompress.py
+tests/test_speed.py
 tests/test_version.py
 zstd/lib/zstd.h
 zstd/lib/zstd_errors.h

{zstd-1.5.6.1 → zstd-1.5.6.2}/tests/base.py

@@ -43,7 +43,7 @@ class BaseTestZSTD(unittest.TestCase):
     VERSION = "1.5.6"
     VERSION_INT = 10506
     VERSION_INT_MIN = 1 * 100*100 + 0 * 1*100 + 0
-    PKG_VERSION = "1.5.6.1"
+    PKG_VERSION = "1.5.6.2"
 
     def helper_version(self):
         self.assertEqual(self.PKG_VERSION, zstd.version())

zstd-1.5.6.2/tests/test_decompress.py

@@ -0,0 +1,24 @@
+# Tests
+
+import sys
+from tests.base import BaseTestZSTD, zstd, tDATA, log
+
+class TestZstdDecompress(BaseTestZSTD):
+
+    def test_decompression_null(self):
+        if sys.hexversion < 0x03000000:
+            DATA = ''
+        else:
+            DATA =b''
+        self.assertRaises(zstd.Error, zstd.uncompress, zstd.compress(DATA)+b' ')
+
+    def test_check_compressed(self):
+        cdata = zstd.compress(tDATA)
+        log.info("zstd compressed data check:%r" % zstd.check(cdata))
+        self.assertEqual(1, zstd.check(cdata))
+
+    def test_check_uncompressed(self):
+        cdata = b''
+        log.info("zstd uncompressed data check:%r" % zstd.check(cdata))
+        self.assertEqual(0, zstd.check(cdata))
+        

zstd-1.5.6.2/tests/test_speed.py

@@ -0,0 +1,52 @@
+# Tests
+
+from tests.base import BaseTestZSTD,tDATA,log,zstd
+from time import time
+
+class TestZstdSpeed(BaseTestZSTD):
+
+    def test_00_system_info(self):
+        log.info("Bundled libzstd uses assembler? : %r" % zstd.ZSTD_with_asm())
+        log.info("Bundled libzstd uses threads? :%r" % zstd.ZSTD_with_threads())
+
+    def test_compression_speed(self):
+        log.info("\nWait 60 seconds...")
+        sec = 60
+        sum = 0
+        l=len(tDATA)
+        tbegin = time()
+        while time()-tbegin<sec:
+            cdata = zstd.compress(tDATA)
+            sum+=l
+
+        log.info("Compression speed average =%6f Mb/sec" % (1.0*sum/1024/1024/sec,))
+
+    def test_decompression_speed(self):
+        log.info("\nWait 60 seconds...")
+        sec = 60
+        sum = 0
+        cdata = zstd.compress(tDATA)
+        l=len(cdata)
+        tbegin = time()
+        while time()-tbegin<sec:
+            data = zstd.decompress(cdata)
+            sum+=l
+
+        log.info("Decompression speed average =%6f Mb/sec" % (1.0*sum/1024/1024/sec,))
+
+    def test_check_speed(self):
+        log.info("\nWait 60 seconds...")
+        sec = 60
+        sum = 0
+        cdata = zstd.compress(tDATA)
+        l=len(cdata)
+        tbegin = time()
+        while time()-tbegin<sec:
+            data = zstd.check(cdata)
+            sum+=l
+
+        log.info("Check speed average =%6f Mb/sec" % (1.0*sum/1024/1024/sec,))
+    
+if __name__ == '__main__':
+    unittest.main()
+