obstruct 0.4.0__tar.gz → 0.5.1__tar.gz

{obstruct-0.4.0 → obstruct-0.5.1}/.idea/workspace.xml

@@ -4,12 +4,8 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="b482b6b4-48ce-4be1-bf3c-a72ec254fa35" name="更改" comment="fix: 更新版本号至 0.2.15，修复延迟加载不会应用到类属性的问题">
-      <change afterPath="$PROJECT_DIR$/BENCHMARK_TEST.md" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/obstruct/__version__.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/obstruct/__version__.py" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/obstruct/aot/base.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/obstruct/aot/base.py" afterDir="false" />
+    <list default="true" id="b482b6b4-48ce-4be1-bf3c-a72ec254fa35" name="更改" comment="Update README.md">
       <change beforePath="$PROJECT_DIR$/src/obstruct/aot/unpack.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/obstruct/aot/unpack.py" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/test/test_speed.py" beforeDir="false" afterPath="$PROJECT_DIR$/test/test_speed.py" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -290,7 +286,47 @@
       <option name="project" value="LOCAL" />
       <updated>1786971691114</updated>
     </task>
-    <option name="localTasksCounter" value="20" />
+    <task id="LOCAL-00020" summary="feat: 添加可选的 post_unpack 钩子&#10;（注意：此功能会导致解包相关功能速度降低，请按需使用）&#10;&#10;+ 更新版本号至 0.4.0">
+      <option name="closed" value="true" />
+      <created>1787038015671</created>
+      <option name="number" value="00020" />
+      <option name="presentableId" value="LOCAL-00020" />
+      <option name="project" value="LOCAL" />
+      <updated>1787038015671</updated>
+    </task>
+    <task id="LOCAL-00021" summary="chore: 更新测速脚本，添加新增的测试结果">
+      <option name="closed" value="true" />
+      <created>1787038095094</created>
+      <option name="number" value="00021" />
+      <option name="presentableId" value="LOCAL-00021" />
+      <option name="project" value="LOCAL" />
+      <updated>1787038095094</updated>
+    </task>
+    <task id="LOCAL-00022" summary="feat: 移除了自动生成 slots 的功能，其责任转移给 dataclass&#10;&#10;+ 更新版本号：0.5.0">
+      <option name="closed" value="true" />
+      <created>1787038912981</created>
+      <option name="number" value="00022" />
+      <option name="presentableId" value="LOCAL-00022" />
+      <option name="project" value="LOCAL" />
+      <updated>1787038912981</updated>
+    </task>
+    <task id="LOCAL-00023" summary="feat: 移除了自动生成 slots 的功能，其责任转移给 dataclass&#10;&#10;+ 更新版本号：0.5.0&#10;+ 更新测试脚本中的逻辑，启用 dataclass 的 slots 功能">
+      <option name="closed" value="true" />
+      <created>1787038979727</created>
+      <option name="number" value="00023" />
+      <option name="presentableId" value="LOCAL-00023" />
+      <option name="project" value="LOCAL" />
+      <updated>1787038979727</updated>
+    </task>
+    <task id="LOCAL-00024" summary="Update README.md">
+      <option name="closed" value="true" />
+      <created>1787039079710</created>
+      <option name="number" value="00024" />
+      <option name="presentableId" value="LOCAL-00024" />
+      <option name="project" value="LOCAL" />
+      <updated>1787039079710</updated>
+    </task>
+    <option name="localTasksCounter" value="25" />
     <servers />
   </component>
   <component name="TypeScriptGeneratedFilesManager">
@@ -326,6 +362,11 @@
     <MESSAGE value="fix: 更新版本号至 0.2.13，修复类变量识别错误的问题" />
     <MESSAGE value="fix: 更新版本号至 0.2.14，修复 __cendian__ 类变量识别错误的问题" />
     <MESSAGE value="fix: 更新版本号至 0.2.15，修复延迟加载不会应用到类属性的问题" />
-    <option name="LAST_COMMIT_MESSAGE" value="fix: 更新版本号至 0.2.15，修复延迟加载不会应用到类属性的问题" />
+    <MESSAGE value="feat: 添加可选的 post_unpack 钩子&#10;（注意：此功能会导致解包相关功能速度降低，请按需使用）&#10;&#10;+ 更新版本号至 0.4.0" />
+    <MESSAGE value="chore: 更新测速脚本，添加新增的测试结果" />
+    <MESSAGE value="feat: 移除了自动生成 slots 的功能，其责任转移给 dataclass&#10;&#10;+ 更新版本号：0.5.0" />
+    <MESSAGE value="feat: 移除了自动生成 slots 的功能，其责任转移给 dataclass&#10;&#10;+ 更新版本号：0.5.0&#10;+ 更新测试脚本中的逻辑，启用 dataclass 的 slots 功能" />
+    <MESSAGE value="Update README.md" />
+    <option name="LAST_COMMIT_MESSAGE" value="Update README.md" />
   </component>
 </project>

{obstruct-0.4.0 → obstruct-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: obstruct
-Version: 0.4.0
+Version: 0.5.1
 Author-email: LittleNightSong <LittleNightSongYO@outlook.com>
 Classifier: Development Status :: 3 - Alpha
 Classifier: Programming Language :: Python
@@ -50,6 +50,8 @@ _一个简单、纯粹、极速的二进制解析库_
 - 打包：269.639ns 一次操作
 - 解包：582.185ns 一次操作
 
+> 新的测试报告请参见 [BENCHMARK_TEST](BENCHMARK_TEST.md)
+
 ## 安装
 
 ```commandline
@@ -88,8 +90,8 @@ if __name__ == '__main__':
 
 ```
 
-> [!WARNING]
-> 不要在 dataclass 装饰器中使用 `slots=True`，`Struct` 元类已为类型添加了 `__slots__`
+> [!TIP]
+> 建议 dataclass 装饰器中使用 `slots=True` 以加速属性访问和内存效率
 
 在上述示例中，你可能发现 `data != restored`，这是浮点数的精度限制导致的。 因此，我们不建议使用浮点数类型，浮点数在二进制传输中也不常见。
 

{obstruct-0.4.0 → obstruct-0.5.1}/README.md

@@ -36,6 +36,8 @@ _一个简单、纯粹、极速的二进制解析库_
 - 打包：269.639ns 一次操作
 - 解包：582.185ns 一次操作
 
+> 新的测试报告请参见 [BENCHMARK_TEST](BENCHMARK_TEST.md)
+
 ## 安装
 
 ```commandline
@@ -74,8 +76,8 @@ if __name__ == '__main__':
 
 ```
 
-> [!WARNING]
-> 不要在 dataclass 装饰器中使用 `slots=True`，`Struct` 元类已为类型添加了 `__slots__`
+> [!TIP]
+> 建议 dataclass 装饰器中使用 `slots=True` 以加速属性访问和内存效率
 
 在上述示例中，你可能发现 `data != restored`，这是浮点数的精度限制导致的。 因此，我们不建议使用浮点数类型，浮点数在二进制传输中也不常见。
 

obstruct-0.5.1/src/obstruct/__version__.py

@@ -0,0 +1 @@
+version = "0.5.1"

{obstruct-0.4.0 → obstruct-0.5.1}/src/obstruct/aot/unpack.py

@@ -183,12 +183,12 @@ def create_unpack_methods(cls: type[Struct]):
         for n, *_ in array_fields:
             iter_update_inner.add_code(f'{n}.clear()')
 
-        print(unpack.generate_code())
-        print(update.generate_code())
-        print(unpack_from.generate_code())
-        print(update_from.generate_code())
-        print(iter_unpack.generate_code())
-        print(iter_update.generate_code())
+        # print(unpack.generate_code())
+        # print(update.generate_code())
+        # print(unpack_from.generate_code())
+        # print(update_from.generate_code())
+        # print(iter_unpack.generate_code())
+        # print(iter_update.generate_code())
 
         globals = {
             v: k for k, v in inner_classes.items()  # 翻转字典

{obstruct-0.4.0 → obstruct-0.5.1}/src/obstruct/struct_type.py

@@ -31,29 +31,6 @@ class StructMeta(type):
         '__cfields__',
     }
 
-    def __new__(cls, name, bases, attrs, *, endian='little'):
-        slots = set(attrs.get('__slots__', ()))
-
-        annotations = attrs.get('__annotations__')
-
-        if annotations is None:
-            import annotationlib
-            annotate = annotationlib.get_annotate_from_class_namespace(attrs)
-            assert annotate is not None
-
-            annotations = annotationlib.call_annotate_function(
-                annotate,
-                format=annotationlib.Format.STRING
-            )
-
-        slots |= {k for k in annotations.keys()}
-        slots -= cls.__struct_methods__
-
-        attrs['__slots__'] = slots
-        attrs['__cendian__'] = endian
-
-        return super().__new__(cls, name, bases, attrs)
-
     def __compile_struct__(cls):
         from obstruct.methods import to_format_string
         fields = [
@@ -108,6 +85,9 @@ class Struct(metaclass=StructMeta):
     __cstruct__: ClassVar[struct.Struct]
     __cendian__: ClassVar[str]
 
+    def __init_subclass__(cls, *, endian='little') -> None:
+        cls.__cendian__ = endian
+
     if typing.TYPE_CHECKING:
         def pack(self) -> bytes:
             ...

{obstruct-0.4.0 → obstruct-0.5.1}/test/test_speed.py

@@ -10,7 +10,7 @@ def run_iterator(iterator):
     [i for i in iterator]
 
 
-@dataclasses.dataclass()
+@dataclasses.dataclass(slots=True)
 class MyStruct(obs.Struct):
     a: int
     b: int
@@ -30,7 +30,7 @@ class MyStruct(obs.Struct):
         is_post_unpack_called = True
 
 
-@dataclasses.dataclass()
+@dataclasses.dataclass(slots=True)
 class AnotherStruct(obs.Struct):
     x: MyStruct
     y: Annotated[array[int], 100]

obstruct-0.4.0/src/obstruct/__version__.py

@@ -1 +0,0 @@
-version = "0.4.0"