nfcscript 0.0.1__py3-none-any.whl

nfcscript/assertions.py

@@ -0,0 +1,37 @@
+import inspect
+from typing import Any
+
+def _get_stack_trace() -> str:
+    """获取格式化的调用堆栈"""
+    # inspect.stack()[0] 是 _get_stack_trace
+    # inspect.stack()[1] 是 ASSERT_... 函数
+    # inspect.stack()[2:] 是实际的业务调用代码
+    stack = inspect.stack()[2:]
+    chain = []
+    for frame in stack:
+        # 简化路径，仅显示文件名
+        filename = frame.filename.split('\\')[-1].split('/')[-1]
+        chain.append(f"  at {filename}:{frame.lineno} in {frame.function}")
+    return "\n".join(chain)
+
+def ASSERT_LEN(data: Any, expected_len: int) -> None:
+    actual_len = len(data)
+    if actual_len != expected_len:
+        error_msg = (
+            f"\nAssertion Failed: Length mismatch\n"
+            f"  Expected: {expected_len}\n"
+            f"  Actual  : {actual_len}\n"
+            f"  Data    : {data}\n"
+            f"Stack Trace:\n{_get_stack_trace()}"
+        )
+        raise AssertionError(error_msg)
+
+def ASSERT_EQUAL(actual: Any, expected: Any) -> None:
+    if actual != expected:
+        error_msg = (
+            f"\nAssertion Failed: Value mismatch\n"
+            f"  Expected: {expected} ({type(expected).__name__})\n"
+            f"  Actual  : {actual} ({type(actual).__name__})\n"
+            f"Stack Trace:\n{_get_stack_trace()}"
+        )
+        raise AssertionError(error_msg)

nfcscript/bits.py

@@ -0,0 +1,26 @@
+def bits_update(val: int, mask: int, data: int) -> int:
+    """
+    更新寄存器中的特定位域 (Read-Modify-Write)
+    :param val:         当前寄存器的原始值
+    :param mask:        预移位的位掩码 (例如: 0x20)
+    :param data:        已移位对齐的新数值 (例如: 0x20, 即 1 << 5)
+    :return:            更新后的寄存器值
+    """
+    assert (data & ~mask) == 0, f"Data {hex(data)} contains bits outside mask {hex(mask)}"
+    return (val & ~mask) | (data & mask)
+
+def bits_set(val: int, mask: int) -> int:
+    """
+    将寄存器中的指定位强制置 1 (OR 操作)
+    
+    :param mask:        想要置 1 的位掩码
+    """
+    return val | mask
+
+def bits_reset(val: int, mask: int) -> int:
+    """
+    将寄存器中的指定位强制清 0 (AND-NOT 操作)
+    
+    :param mask:        想要清 0 的位掩码
+    """
+    return val & ~mask

nfcscript/main.py

@@ -0,0 +1,5 @@
+def main():
+    print("Hello from nfcscript!")
+
+if __name__ == "__main__":
+    main()

nfcscript-0.0.1.dist-info/METADATA

@@ -0,0 +1,12 @@
+Metadata-Version: 2.4
+Name: nfcscript
+Version: 0.0.1
+Summary: NFC test script
+Author: crthu
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: CarrotRFIDTester
+
+# nfcscript
+
+NFC test script.

nfcscript-0.0.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+nfcscript/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nfcscript/assertions.py,sha256=Cag79RUWvUH2KhWdPlK_NQlgdHC5_9wqmgP8etS_zHY,1347
+nfcscript/bits.py,sha256=1z7yFWEiRbqp-qDlROLs0y3L1VaB4AO-58pnITDVuS8,891
+nfcscript/main.py,sha256=ZRme3aUqH0Yn3jgMHI_yW_cYYYlZJEDC2peTzMkhTOY,86
+nfcscript-0.0.1.dist-info/METADATA,sha256=J6cG17YbzMG4W85oRZ1b9BEbptcU0liQ0EqrHE6sdp4,219
+nfcscript-0.0.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+nfcscript-0.0.1.dist-info/entry_points.txt,sha256=aHhVEPW92MkR83dZy3f-b8iJtSRFphfjEl4sdJQPqWk,50
+nfcscript-0.0.1.dist-info/top_level.txt,sha256=ZNgFsFkDHI3lcF-IL6_45fL4DUQgYPFUay-hyU5q3jI,10
+nfcscript-0.0.1.dist-info/RECORD,,

nfcscript-0.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

nfcscript-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+nfcscript = nfcscript.main:main

nfcscript-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+nfcscript