PyREUser3 0.3.0__tar.gz → 0.4.0__tar.gz

{pyreuser3-0.3.0 → pyreuser3-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyREUser3
-Version: 0.3.0
+Version: 0.4.0
 Summary: Pure Python tools for converting RE Engine .user.3 files to and from JSON.
 Author: Egg Targaryen
 License-Expression: MIT
@@ -49,7 +49,9 @@ pip install pyreuser3
 - CLI commands through `pyreuser3`.
 - A local `.user.3` export Web UI through `pyreuser3-web`.
 
-The published package intentionally does not include game resources, dumped game data, RE_RSZ templates, `il2cpp_dump.json`, `.msg.23` conversion tools, or repository-specific helper scripts. You need to provide data files that match the target game and version.
+The published package intentionally does not include game resources, dumped game data, RE_RSZ templates,
+`il2cpp_dump.json`, or repository-specific helper scripts. You need to provide data files that match the target game and
+version.
 
 ## Requirements
 

{pyreuser3-0.3.0 → pyreuser3-0.4.0}/PyREUser3.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyREUser3
-Version: 0.3.0
+Version: 0.4.0
 Summary: Pure Python tools for converting RE Engine .user.3 files to and from JSON.
 Author: Egg Targaryen
 License-Expression: MIT
@@ -49,7 +49,9 @@ pip install pyreuser3
 - CLI commands through `pyreuser3`.
 - A local `.user.3` export Web UI through `pyreuser3-web`.
 
-The published package intentionally does not include game resources, dumped game data, RE_RSZ templates, `il2cpp_dump.json`, `.msg.23` conversion tools, or repository-specific helper scripts. You need to provide data files that match the target game and version.
+The published package intentionally does not include game resources, dumped game data, RE_RSZ templates,
+`il2cpp_dump.json`, or repository-specific helper scripts. You need to provide data files that match the target game and
+version.
 
 ## Requirements
 

{pyreuser3-0.3.0 → pyreuser3-0.4.0}/PyREUser3.egg-info/SOURCES.txt

@@ -38,4 +38,6 @@ pyreuser3/web/page.py
 pyreuser3/web/picker.py
 pyreuser3/web/runners.py
 pyreuser3/web/server.py
-pyreuser3/web/settings.py
+pyreuser3/web/settings.py
+tests/test_enum_binary.py
+tests/test_export_enums.py

{pyreuser3-0.3.0 → pyreuser3-0.4.0}/README.md

@@ -33,7 +33,8 @@ from pyreuser3 import REUser3Converter
 - CLI commands through `pyreuser3`.
 - A local `.user.3` export Web UI through `pyreuser3-web`.
 
-This PyPI package intentionally does not include game resources, dumped game data, RE_RSZ templates, `il2cpp_dump.json`, `.msg.23` conversion tools, or repository-specific helper scripts.
+This PyPI package intentionally does not include game resources, dumped game data, RE_RSZ templates, `il2cpp_dump.json`,
+or repository-specific helper scripts.
 
 ## Requirements
 
@@ -72,7 +73,7 @@ Start the local `.user.3` export Web UI:
 pyreuser3-web --port 8765
 ```
 
-The Web UI only handles `.user.3` export. It does not pack files and does not provide `.msg.23` conversion.
+The Web UI only handles `.user.3` export. It does not pack files.
 
 ## Python API
 

{pyreuser3-0.3.0 → pyreuser3-0.4.0}/docs/PYPI.md

@@ -16,7 +16,9 @@ pip install pyreuser3
 - CLI commands through `pyreuser3`.
 - A local `.user.3` export Web UI through `pyreuser3-web`.
 
-The published package intentionally does not include game resources, dumped game data, RE_RSZ templates, `il2cpp_dump.json`, `.msg.23` conversion tools, or repository-specific helper scripts. You need to provide data files that match the target game and version.
+The published package intentionally does not include game resources, dumped game data, RE_RSZ templates,
+`il2cpp_dump.json`, or repository-specific helper scripts. You need to provide data files that match the target game and
+version.
 
 ## Requirements
 

{pyreuser3-0.3.0 → pyreuser3-0.4.0}/docs/README.zh-CN.md

@@ -35,7 +35,7 @@ PyREUser3 当前提供：
 - `pyreuser3` 命令行工具；
 - `pyreuser3-web` 本地 Web 导出界面。
 
-PyPI 包不会包含游戏资源、游戏 dump、RE_RSZ 模板、`il2cpp_dump.json`、`.msg.23` 转换工具或特定仓库脚本。调用方需要自己准备与目标游戏版本匹配的数据文件。
+PyPI 包不会包含游戏资源、游戏 dump、RE_RSZ 模板、`il2cpp_dump.json`、或特定仓库脚本。调用方需要自己准备与目标游戏版本匹配的数据文件。
 
 ## 环境要求
 
@@ -99,7 +99,7 @@ pyreuser3-web --port 8765
 http://127.0.0.1:8765/
 ```
 
-Web UI 只提供 `.user.3` 导出，不提供 JSON 封包，也不提供 `.msg.23` 转换。
+Web UI 只提供 `.user.3` 导出，不提供 JSON 封包。
 
 ## Python API
 

{pyreuser3-0.3.0 → pyreuser3-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "PyREUser3"
-version = "0.3.0"
+version = "0.4.0"
 description = "Pure Python tools for converting RE Engine .user.3 files to and from JSON."
 readme = "docs/PYPI.md"
 requires-python = ">=3.9"

{pyreuser3-0.3.0 → pyreuser3-0.4.0}/pyreuser3/api.py

@@ -402,17 +402,16 @@ class REUser3Converter:
         """
         if self.il2cpp_dump_path is None or not self.il2cpp_dump_path.is_file():
             raise FileNotFoundError("il2cpp_dump_path is required for parsing JSON")
-        with self.il2cpp_dump_path.open("r", encoding="utf-8") as f:
-            il2cpp_dump = json.load(f)
         # Batch export writes Enums_Internal.json for downstream tools; direct
         # parsing keeps the same lookup only in memory.
         # Keep the generated metadata attached to the exporter so field parsing can
         # format enum names consistently.
-        enums_internal = exporter.export_enums_internal(il2cpp_dump)
+        enums_internal, enum_context = exporter.export_il2cpp_metadata_from_path(
+            self.il2cpp_dump_path
+        )
         exporter.enum_lookup = exporter._build_enum_lookup_from_enums_internal(
             enums_internal
         )
-        enum_context = exporter.export_enum_context_internal(il2cpp_dump)
         exporter._apply_enum_context(enum_context)
         exporter._ensure_enum_lookup()
 

{pyreuser3-0.3.0 → pyreuser3-0.4.0}/pyreuser3/core.py

@@ -28,6 +28,41 @@ HEX32_RE = re.compile(r"^[0-9a-fA-F]{32}$")
 # packing stay reversible.
 ENUM_UNUSED_KEY = "value__"
 
+ENUM_UNDERLYING_TYPE_MAP = {
+    "byte": "U8",
+    "system.byte": "U8",
+    "u8": "U8",
+    "uint8": "U8",
+    "sbyte": "S8",
+    "system.sbyte": "S8",
+    "s8": "S8",
+    "int8": "S8",
+    "short": "S16",
+    "system.int16": "S16",
+    "int16": "S16",
+    "s16": "S16",
+    "ushort": "U16",
+    "system.uint16": "U16",
+    "uint16": "U16",
+    "u16": "U16",
+    "int": "S32",
+    "system.int32": "S32",
+    "int32": "S32",
+    "s32": "S32",
+    "uint": "U32",
+    "system.uint32": "U32",
+    "uint32": "U32",
+    "u32": "U32",
+    "long": "S64",
+    "system.int64": "S64",
+    "int64": "S64",
+    "s64": "S64",
+    "ulong": "U64",
+    "system.uint64": "U64",
+    "uint64": "U64",
+    "u64": "U64",
+}
+
 
 class ParseError(RuntimeError):
     """Signal expected binary-format problems separately from programming errors.
@@ -52,6 +87,38 @@ def align(value: int, alignment: int) -> int:
     return (value + (alignment - 1)) & ~(alignment - 1)
 
 
+def normalize_enum_storage_type(type_name: Any) -> str | None:
+    """Normalize an il2cpp enum underlying type name to an RSZ scalar storage code."""
+    if not isinstance(type_name, str):
+        return None
+    text = type_name.strip()
+    if not text:
+        return None
+    return ENUM_UNDERLYING_TYPE_MAP.get(text.lower())
+
+
+def enum_storage_type_from_size(size: int) -> str:
+    """Choose a conservative enum storage type from a schema-declared byte size."""
+    if size == 1:
+        return "U8"
+    if size == 2:
+        return "U16"
+    if size == 8:
+        return "S64"
+    return "S32"
+
+
+def enum_storage_size(storage_type: str) -> int:
+    """Return the byte width for a normalized enum storage type."""
+    if storage_type in {"S8", "U8"}:
+        return 1
+    if storage_type in {"S16", "U16"}:
+        return 2
+    if storage_type in {"S64", "U64"}:
+        return 8
+    return 4
+
+
 def format_guid_text_from_hex32(hex32: str) -> str:
     """Format compact hexadecimal GUID text with canonical separators.
 

pyreuser3-0.4.0/pyreuser3/export/__init__.py

@@ -0,0 +1,27 @@
+"""Expose the public exporter type for the export subpackage.
+
+Implementation details are split across mixins, but callers can import User3Exporter
+from this package directly.
+"""
+
+from __future__ import annotations
+
+from importlib import import_module
+from typing import Any
+
+__all__ = ["User3Exporter"]
+
+_EXPORT_MODULES = {
+    "User3Exporter": ".base",
+}
+
+
+def __getattr__(name: str) -> Any:
+    """Resolve lazily exported subpackage attributes on first access."""
+    module_name = _EXPORT_MODULES.get(name)
+    if module_name is None:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    module = import_module(module_name, __name__)
+    value = getattr(module, name)
+    globals()[name] = value
+    return value

{pyreuser3-0.3.0 → pyreuser3-0.4.0}/pyreuser3/export/base.py

@@ -88,7 +88,9 @@ class User3Exporter(
         self.serializable_to_fixed: dict[str, str] = {}
         self.generic_container_rules: dict[str, tuple[str, str]] = {}
         self.param_type_default_enum: dict[str, str] = {}
+        self.enum_underlying_types: dict[str, str] = {}
         self.enum_member_to_types: dict[str, list[str]] = {}
+        self._pending_enum_context: dict | None = None
 
     def run(self) -> dict[str, int]:
         """Run the batch exporter and return conversion counters.