pybase16384 0.3.8__cp313-cp313-macosx_11_0_arm64.whl

pybase16384-0.3.8.dist-info/METADATA

@@ -0,0 +1,215 @@
+Metadata-Version: 2.2
+Name: pybase16384
+Version: 0.3.8
+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: 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.8.dist-info/RECORD

@@ -0,0 +1,16 @@
+pybase16384/__init__.py,sha256=xDOQ59rGsfkEhlODtzpqltiJmvTOMYT0puEhW6w8DBo,4897
+pybase16384/backends/__init__.py,sha256=vdW_t1O2WNfdRmxDlEXRvTpyJj5ufKWAUsD2fbtku5g,55
+pybase16384/backends/cffi/build.py,sha256=NyTK_W4JKJbqtdAS0yZ0sxkQvLDE8npjOskWN1-YOqk,5824
+pybase16384/backends/cffi/__init__.py,sha256=oGen7JI3AMlvsCjM8xF4k6zBK2v_QqQ5UsrdMVtD_Zo,15970
+pybase16384/backends/cffi/_core.abi3.so,sha256=ZbZUBk4gkwQN60FswD9K8derkmHX4D-8jujknvxDbNo,90464
+pybase16384/backends/cython/_core.c,sha256=Co0qxbDmNKtX39tTxGMB2Sh5zYdExvPFvUeGVq3X5C8,1558557
+pybase16384/backends/cython/__init__.py,sha256=iqaf2DeavB1x_LnQi949Qqkrn00KAwG9xJMPVUdnIB8,738
+pybase16384/backends/cython/base16384.pxd,sha256=HFGuEe2rXBWYw1vx74uaI7YATtkRGpcUAjANMRxPRFA,5942
+pybase16384/backends/cython/_core.abi3.so,sha256=8FgWQDtKHbBf7D7q1fYWnd7R0GGLrVjcHNUe1nkFeaI,266784
+pybase16384/backends/cython/_core.pyx,sha256=OcY07Gk5n-9snqRCFrVTU-WhI8k1yiD6zcutRD5G1Dk,25159
+pybase16384/backends/cython/_core.pxi,sha256=2fXuRiumLqxO0bnmZVEz0lr_GX-grJGBfhGIVedfyt8,530
+pybase16384-0.3.8.dist-info/RECORD,,
+pybase16384-0.3.8.dist-info/LICENSE,sha256=ixuiBLtpoK3iv89l7ylKkg9rs2GzF9ukPH7ynZYzK5s,35148
+pybase16384-0.3.8.dist-info/WHEEL,sha256=zEwrEM3mH_qOUQ9uk3aZI5DMOaUao9_e1G94mKtHrTY,109
+pybase16384-0.3.8.dist-info/top_level.txt,sha256=kXpl7pWjnjpm74qJP0SJg3JhbiWuwKQApJgkJH0B5Mk,12
+pybase16384-0.3.8.dist-info/METADATA,sha256=HKwiEO0_m8J4u1QmjLLz1c2j2ymgAgh4eNZJ58t_frA,6836

pybase16384-0.3.8.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.8.0)
+Root-Is-Purelib: false
+Tag: cp313-cp313-macosx_11_0_arm64
+

pybase16384-0.3.8.dist-info/top_level.txt

@@ -0,0 +1 @@
+pybase16384