pybase16384 0.3.9__cp312-cp312-musllinux_1_2_aarch64.whl

pybase16384/backends/cython/base16384.pxd

@@ -0,0 +1,113 @@
+# cython: language_level=3
+# cython: cdivision=True
+from libc.stdint cimport int32_t
+from libc.stdio cimport FILE
+
+
+cdef extern from "base16384.h" nogil:
+    int BASE16384_ENCBUFSZ
+    int BASE16384_DECBUFSZ
+
+    int BASE16384_FLAG_NOHEADER
+    int BASE16384_FLAG_SUM_CHECK_ON_REMAIN
+    int BASE16384_FLAG_DO_SUM_CHECK_FORCELY
+
+    ctypedef enum base16384_err_t:
+        base16384_err_ok
+        base16384_err_get_file_size
+        base16384_err_fopen_output_file
+        base16384_err_fopen_input_file
+        base16384_err_write_file
+        base16384_err_open_input_file
+        base16384_err_map_input_file
+        base16384_err_read_file
+        base16384_err_invalid_file_name
+        base16384_err_invalid_commandline_parameter
+        base16384_err_invalid_decoding_checksum
+    # encode_len calc min buf size to fill encode result
+    int b14_encode_len "base16384_encode_len" (int dlen)
+# decode_len calc min buf size to fill decode result
+    int b14_decode_len "base16384_decode_len" (int dlen, int offset)
+
+    int b14_encode_safe "base16384_encode_safe" (const char * data, int dlen, char * buf)
+# encode data and write result into buf
+    int b14_encode "base16384_encode" (const char* data, int dlen, char* buf)
+
+    int b14_encode_unsafe "base16384_encode_unsafe" (const char * data, int dlen, char * buf)
+# decode data and write result into buf
+    int b14_decode_safe "base16384_decode_safe" (const char * data, int dlen, char * buf)
+
+    int b14_decode "base16384_decode" (const char* data, int dlen, char* buf)
+
+    int b14_decode_unsafe "base16384_decode_unsafe"(const char * data, int dlen, char * buf)
+
+    base16384_err_t b14_encode_file "base16384_encode_file" (const char * input, const char * output, char * encbuf, char * decbuf)
+    base16384_err_t b14_decode_file "base16384_decode_file" (const char * input, const char * output, char * encbuf, char * decbuf)
+
+    base16384_err_t b14_encode_fp "base16384_encode_fp" (FILE* input, FILE* output, char* encbuf, char* decbuf)
+
+    # base16384_encode_fd encodes input fd to output fd.
+    #    encbuf & decbuf must be no less than BASE16384_ENCBUFSZ & BASE16384_DECBUFSZ
+    base16384_err_t b14_encode_fd "base16384_encode_fd" (int input, int output, char* encbuf, char* decbuf)
+
+
+    # base16384_decode_fp decodes input file to output file.
+    #    encbuf & decbuf must be no less than BASE16384_ENCBUFSZ & BASE16384_DECBUFSZ
+    base16384_err_t b14_decode_fp "base16384_decode_fp"(FILE* input, FILE* output, char* encbuf, char* decbuf)
+
+    # base16384_decode_fd decodes input fd to output fd.
+    #    encbuf & decbuf must be no less than BASE16384_ENCBUFSZ & BASE16384_DECBUFSZ
+    base16384_err_t b14_decode_fd "base16384_decode_fd"(int input, int output, char* encbuf, char* decbuf)
+
+    # detailed
+        # base16384_encode_file_detailed encodes input file to output file.
+    #    use `-` to specify stdin/stdout
+    #    encbuf & decbuf must be no less than BASE16384_ENCBUFSZ & BASE16384_DECBUFSZ
+    base16384_err_t b14_encode_file_detailed "base16384_encode_file_detailed" (const char* input, const char* output, char* encbuf, char* decbuf, int flag)
+
+    # base16384_encode_fp_detailed encodes input file to output file.
+    #    encbuf & decbuf must be no less than BASE16384_ENCBUFSZ & BASE16384_DECBUFSZ
+    base16384_err_t b14_encode_fp_detailed "base16384_encode_fp_detailed" (FILE* input, FILE* output, char* encbuf, char* decbuf, int flag)
+
+    # base16384_encode_fd_detailed encodes input fd to output fd.
+    #    encbuf & decbuf must be no less than BASE16384_ENCBUFSZ & BASE16384_DECBUFSZ
+    base16384_err_t b14_encode_fd_detailed "base16384_encode_fd_detailed" (int input, int output, char* encbuf, char* decbuf, int flag)
+
+    # base16384_decode_file_detailed decodes input file to output file.
+    #    use `-` to specify stdin/stdout
+    #    encbuf & decbuf must be no less than BASE16384_ENCBUFSZ & BASE16384_DECBUFSZ
+    base16384_err_t b14_decode_file_detailed "base16384_decode_file_detailed" (const char* input, const char* output, char* encbuf, char* decbuf, int flag)
+
+    # base16384_decode_fp_detailed decodes input file to output file.
+    #    encbuf & decbuf must be no less than BASE16384_ENCBUFSZ & BASE16384_DECBUFSZ
+    base16384_err_t b14_decode_fp_detailed "base16384_decode_fp_detailed" (FILE* input, FILE* output, char* encbuf, char* decbuf, int flag)
+
+    # base16384_decode_fd_detailed decodes input fd to output fd.
+    #    encbuf & decbuf must be no less than BASE16384_ENCBUFSZ & BASE16384_DECBUFSZ
+    base16384_err_t b14_decode_fd_detailed "base16384_decode_fd_detailed" (int input, int output, char* encbuf, char* decbuf, int flag)
+    # stream
+    ctypedef ssize_t (*base16384_reader_t) (const void *client_data, void *buffer, size_t count) except -100
+    ctypedef ssize_t (*base16384_writer_t) (const void *client_data, const void *buffer, size_t count) except -100
+
+    ctypedef union base16384_io_function_t:
+        base16384_reader_t reader
+        base16384_writer_t writer
+
+    ctypedef struct base16384_stream_t:
+        base16384_io_function_t f
+        void* client_data
+
+    base16384_err_t b14_encode_stream "base16384_encode_stream"(base16384_stream_t* input, base16384_stream_t*  output, char* encbuf, char* decbuf)
+    base16384_err_t b14_encode_stream_detailed "base16384_encode_stream_detailed"(base16384_stream_t* input, base16384_stream_t*  output, char* encbuf, char* decbuf, int flag)
+    base16384_err_t b14_decode_stream "base16384_decode_stream"(base16384_stream_t* input, base16384_stream_t*  output, char* encbuf, char* decbuf)
+    base16384_err_t b14_decode_stream_detailed "base16384_decode_stream_detailed"(base16384_stream_t* input, base16384_stream_t*  output, char* encbuf, char* decbuf, int flag)
+
+cdef extern from * nogil:
+    """
+#ifdef CPUBIT32
+#define pybase16384_64bits() (0)
+#else
+#define pybase16384_64bits() (1)
+#endif
+    """
+    int32_t pybase16384_64bits()

pybase16384-0.3.9.dist-info/METADATA

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: pybase16384
+Version: 0.3.9
+Summary: fast base16384 encode and decode
+Home-page: https://github.com/synodriver/pybase16384
+Author: synodriver
+Author-email: diguohuangjiajinweijun@gmail.com
+License: GPLv3
+Keywords: encode,decode,base16384
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Topic :: Security :: Cryptography
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Cython
+Classifier: Programming Language :: Python
+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 :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cffi>=1.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+<h1 align="center"><i>✨ pybase16384 ✨ </i></h1>
+
+<h3 align="center">The python binding for <a href="https://github.com/fumiama/base16384">base16384</a> </h3>
+
+<h3 align="center"><i>一种神奇的编码 </i></h3>
+
+[![pypi](https://img.shields.io/pypi/v/pybase16384.svg)](https://pypi.org/project/pybase16384/)
+![python](https://img.shields.io/pypi/pyversions/pybase16384)
+![implementation](https://img.shields.io/pypi/implementation/pybase16384)
+![wheel](https://img.shields.io/pypi/wheel/pybase16384)
+![license](https://img.shields.io/github/license/synodriver/pybase16384.svg)
+![action](https://img.shields.io/github/workflow/status/synodriver/pybase16384/build%20wheel)
+
+
+### 使用
+
+- 编码/解码文本
+```python
+>>> import pybase16384 as pybs
+>>> pybs.encode_string('hello!!')
+'栙擆羼漡'
+>>> pybs.decode_string('栙擆羼漡')
+'hello!!'
+```
+
+- 编码文件
+
+```python
+from io import BytesIO
+
+import pybase16384 as pybs
+
+with open("input.pcm", "rb") as f:
+    data = f.read()
+for i in range(1):
+    pybs.encode_file(BytesIO(data), open("output2.pcm", 'wb'), True)
+```
+- 解码文件
+
+```python
+from io import BytesIO
+
+import pybase16384 as pybs
+
+with open("output2.pcm", "rb") as f:
+    data = f.read()
+for i in range(1):
+    pybs.decode_file(BytesIO(data), open("input2.pcm", 'wb'))
+```
+
+### 公开函数
+```python
+from typing import IO
+
+def encode_len(dlen: int) -> int: ...
+
+def decode_len(dlen: int, offset: int) -> int: ...
+
+ENCBUFSZ: int
+DECBUFSZ: int
+FLAG_NOHEADER: int
+FLAG_SUM_CHECK_ON_REMAIN: int
+FLAG_DO_SUM_CHECK_FORCELY: int
+
+def is_64bits() -> bool: ...
+
+def encode_file(input: IO, output: IO, write_head: bool = ..., buf_rate: int = ...): ...
+
+def encode_file_safe(input: IO, output: IO, write_head: bool = ..., buf_rate: int = ...): ...
+
+def decode_file(input: IO, output: IO, buf_rate: int = ...): ...
+
+def decode_file_safe(input: IO, output: IO, buf_rate: int = ...): ...
+
+def ensure_bytes(inp) -> bytes: ...
+
+def encode_local_file(inp, out) -> None: ...
+
+def decode_local_file(inp, out) -> None: ...
+
+def encode_fd(inp: int, out: int) -> None: ...
+
+def decode_fd(inp: int, out: int) -> None: ...
+
+def encode_local_file_detailed(inp, out, flag: int) -> None: ...
+
+def decode_local_file_detailed(inp, out, flag: int) -> None: ...
+
+def encode_fd_detailed(inp: int, out: int, flag: int) -> None: ...
+
+def decode_fd_detailed(inp: int, out: int, flag: int) -> None: ...
+
+def encode(data: bytes) -> bytes: ...
+
+def encode_safe(data: bytes) -> bytes: ...
+
+def decode(data: bytes) -> bytes: ...
+
+def decode_safe(data: bytes) -> bytes: ...
+
+def encode_from_string(data: str, write_head: bool = ...) -> bytes: ...
+
+def encode_from_string_safe(data: str, write_head: bool = ...) -> bytes: ...
+
+def encode_to_string(data: bytes) -> str: ...
+
+def encode_to_string_safe(data: bytes) -> str: ...
+
+def encode_string(data: str) -> str: ...
+
+def encode_string_safe(data: str) -> str: ...
+
+def decode_from_bytes(data: bytes) -> str: ...
+
+def decode_from_bytes_safe(data: bytes) -> str: ...
+
+def decode_from_string(data: str) -> bytes: ...
+
+def decode_from_string_safe(data: str) -> bytes: ...
+
+def decode_string(data: str) -> str: ...
+
+def decode_string_safe(data: str) -> str: ...
+
+def encode_stream_detailed(inp, out, flag: int): ...
+
+def decode_stream_detailed(inp, out, flag: int): ...
+```
+- write_head将显式指明编码出的文本格式(utf16be)，以便文本编辑器(如记事本)能够正确渲染，一般在写入文件时使用。
+
+- buf_rate指定读取文件的策略。当它为n时，则表示一次读取7n或者8n个字节。如果读到的字节长度小于预期，则说明长度不够，
+此时，n将减半，恢复文件指针，重新读取。如果当n=1时长度仍然不够，就地encode/decode处理之。
+
+- ```encode_len```和```decode_len```用于计算输出的长度
+
+### 内部函数
+
+- 他们直接来自底层的C库，高性能，但是一般不需要在外部使用（除非是增加性能）
+
+```python
+def _encode(data: BufferProtocol) -> bytes: ...
+
+def _encode_safe(data: BufferProtocol) -> bytes: ...
+
+def _decode(data: BufferProtocol) -> bytes: ...
+
+def _decode_safe(data: BufferProtocol) -> bytes: ...
+
+def _encode_into(data: BufferProtocol, dest: BufferProtocol) -> int: ...
+
+def _encode_into_safe(data: BufferProtocol, dest: BufferProtocol) -> int: ...
+
+def _decode_into(data: BufferProtocol, dest: BufferProtocol) -> int: ...
+
+def _decode_into_safe(data: BufferProtocol, dest: BufferProtocol) -> int: ...
+
+def is_64bits() -> bool: ...
+```
+- ```_decode```在解码```b'='```开头的数据时***不安全***：***解释器异常***
+- ```_encode_into```和```_decode_into```直接操作缓冲区对象的底层指针，0拷贝，当然也和上面一样的问题，他们是没有检查的
+
+### ✨  v0.3更新 ✨ 
+融合了 [CFFI](https://github.com/synodriver/pybase16384-cffi) 版本的成果，现在一个包可以同时在cpython和pypy上运行
+
+### 本机编译
+```
+python -m pip install setuptools wheel cython cffi
+git clone https://github.com/synodriver/pybase16384
+cd pybase16384
+git submodule update --init --recursive
+python setup.py bdist_wheel --use-cython --use-cffi
+```
+- 为了在windows上编译，需要加点料，把 [这个](https://gist.github.com/synodriver/8f1afae7b1a221754cb04ce417dc7e4d) 放进msvc的目录
+
+### 后端选择
+默认由py实现决定，在cpython上自动选择cython后端，在pypy上自动选择cffi后端，使用```B14_USE_CFFI```环境变量可以强制选择cffi

pybase16384-0.3.9.dist-info/RECORD

@@ -0,0 +1,16 @@
+pybase16384/__init__.py,sha256=QxB65P3NQT4W-RumT_W1eX6yDKJoV-Ms2ALHSMqmsaQ,4897
+pybase16384/backends/__init__.py,sha256=vdW_t1O2WNfdRmxDlEXRvTpyJj5ufKWAUsD2fbtku5g,55
+pybase16384/backends/cffi/__init__.py,sha256=oGen7JI3AMlvsCjM8xF4k6zBK2v_QqQ5UsrdMVtD_Zo,15970
+pybase16384/backends/cffi/_core.abi3.so,sha256=czl4_aohWox_VXRiNeH74Zwp9ZVUtDqXCHzvjeOKfEI,78048
+pybase16384/backends/cffi/build.py,sha256=NyTK_W4JKJbqtdAS0yZ0sxkQvLDE8npjOskWN1-YOqk,5824
+pybase16384/backends/cython/__init__.py,sha256=iqaf2DeavB1x_LnQi949Qqkrn00KAwG9xJMPVUdnIB8,738
+pybase16384/backends/cython/_core.abi3.so,sha256=x6r8Fw4CMLjgX8YyYFY_ATRQ6JCENWZm7vsxt1dp2hQ,302504
+pybase16384/backends/cython/_core.c,sha256=KJPN3jGEL9tr1JTkm_l01kOj5TGPmDI5WaX6Mfiswp8,1588652
+pybase16384/backends/cython/_core.pxi,sha256=2fXuRiumLqxO0bnmZVEz0lr_GX-grJGBfhGIVedfyt8,530
+pybase16384/backends/cython/_core.pyx,sha256=OcY07Gk5n-9snqRCFrVTU-WhI8k1yiD6zcutRD5G1Dk,25159
+pybase16384/backends/cython/base16384.pxd,sha256=HFGuEe2rXBWYw1vx74uaI7YATtkRGpcUAjANMRxPRFA,5942
+pybase16384-0.3.9.dist-info/METADATA,sha256=2seC1dt201UqEyInOShzHT9VeNiRoaX_9FBFIK20teI,6858
+pybase16384-0.3.9.dist-info/WHEEL,sha256=OhR_OrUHeSS9Wv6z5202HxeJVPkI7JBt4nUD2fey9No,113
+pybase16384-0.3.9.dist-info/top_level.txt,sha256=kXpl7pWjnjpm74qJP0SJg3JhbiWuwKQApJgkJH0B5Mk,12
+pybase16384-0.3.9.dist-info/RECORD,,
+pybase16384-0.3.9.dist-info/licenses/LICENSE,sha256=ixuiBLtpoK3iv89l7ylKkg9rs2GzF9ukPH7ynZYzK5s,35148

pybase16384-0.3.9.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp312-cp312-musllinux_1_2_aarch64
+