PyREUser3 0.1.0__tar.gz

pyreuser3-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Egg Targaryen 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyreuser3-0.1.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+include LICENSE
+recursive-include docs *.md
+recursive-include pyreuser3 *.py
+global-exclude __pycache__ *.py[cod] *.pyo
+prune build
+prune dist

pyreuser3-0.1.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: PyREUser3
+Version: 0.1.0
+Summary: Pure Python tools for converting RE Engine .user.3 files to and from JSON.
+Author: Egg Targaryen
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/dzxrly/PyREUser3
+Project-URL: Repository, https://github.com/dzxrly/PyREUser3
+Project-URL: Issues, https://github.com/dzxrly/PyREUser3/issues
+Keywords: RE Engine,user.3,JSON,modding,RSZ
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: File Formats
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# PyREUser3
+
+English | [简体中文](./docs/README.zh-CN.md)
+
+PyREUser3 is a pure Python package for converting RE Engine `.user.3` database files to JSON and packing compatible JSON back to `.user.3`.
+
+Install it with:
+
+```bash
+pip install pyreuser3
+```
+
+Import it with the same normalized package name:
+
+```python
+from pyreuser3 import REUser3Converter
+```
+
+## What Is Included
+
+- `.user.3 -> JSON` export.
+- `JSON -> .user.3` packing.
+- A reusable Python API through `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.
+
+## Requirements
+
+- Python 3.9 or newer.
+- A RE_RSZ schema JSON file for the target game/version.
+- An `il2cpp_dump.json` file when exporting readable enum labels.
+- One or more unpacked `.user.3` files.
+
+## Command Line
+
+Export `.user.3` files to JSON:
+
+```bash
+pyreuser3 export \
+  -i <input-user3-file-or-directory> \
+  -s <RE_RSZ-schema.json> \
+  -o <json-output-directory> \
+  -p <il2cpp_dump.json>
+```
+
+Pack JSON back to `.user.3`:
+
+```bash
+pyreuser3 pack \
+  -j <input-json-file-or-directory> \
+  -s <RE_RSZ-schema.json> \
+  -o <user3-output-directory> \
+  -p <il2cpp_dump.json>
+```
+
+The `-p/--il2cpp-dump-path` option is required for export and optional for pack. Passing it during pack is recommended when enum names need to be resolved back to numeric values.
+
+Start the local `.user.3` export Web UI:
+
+```bash
+pyreuser3-web --port 8765
+```
+
+The Web UI only handles `.user.3` export. It does not pack files and does not provide `.msg.23` conversion.
+
+## Python API
+
+```python
+from pyreuser3 import REUser3Converter
+
+converter = REUser3Converter(
+    schema_path="D:/schema/rsz_game.json",
+    il2cpp_dump_path="D:/game/il2cpp_dump.json",
+)
+
+converter.export_file(
+    "input/OtomonData.user.3",
+    "json/OtomonData.user.3.json",
+)
+
+converter.pack_file(
+    "json/OtomonData.user.3.json",
+    "mod/OtomonData.user.3",
+)
+```
+
+For stable patch-and-repack workflows, use `patch_file()` or `parse_pack_file()`:
+
+```python
+from pyreuser3 import REUser3Converter
+
+converter = REUser3Converter(
+    schema_path="D:/schema/rsz_game.json",
+    il2cpp_dump_path="D:/game/il2cpp_dump.json",
+)
+
+def patch(data, source_path):
+    # Modify the full instance-table JSON in place.
+    return None
+
+converter.patch_file(
+    "input/example.user.3",
+    "output/example.user.3",
+    patch,
+)
+```
+
+## Build From Source
+
+```bash
+python -m pip install -U build twine
+python -m build
+python -m twine check dist/*
+```
+
+Upload to TestPyPI first:
+
+```bash
+python -m twine upload -r testpypi dist/*
+```
+
+Then upload the same checked distribution files to PyPI:
+
+```bash
+python -m twine upload dist/*
+```
+
+## License
+
+MIT License.

pyreuser3-0.1.0/PyREUser3.egg-info/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: PyREUser3
+Version: 0.1.0
+Summary: Pure Python tools for converting RE Engine .user.3 files to and from JSON.
+Author: Egg Targaryen
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/dzxrly/PyREUser3
+Project-URL: Repository, https://github.com/dzxrly/PyREUser3
+Project-URL: Issues, https://github.com/dzxrly/PyREUser3/issues
+Keywords: RE Engine,user.3,JSON,modding,RSZ
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: File Formats
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# PyREUser3
+
+English | [简体中文](./docs/README.zh-CN.md)
+
+PyREUser3 is a pure Python package for converting RE Engine `.user.3` database files to JSON and packing compatible JSON back to `.user.3`.
+
+Install it with:
+
+```bash
+pip install pyreuser3
+```
+
+Import it with the same normalized package name:
+
+```python
+from pyreuser3 import REUser3Converter
+```
+
+## What Is Included
+
+- `.user.3 -> JSON` export.
+- `JSON -> .user.3` packing.
+- A reusable Python API through `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.
+
+## Requirements
+
+- Python 3.9 or newer.
+- A RE_RSZ schema JSON file for the target game/version.
+- An `il2cpp_dump.json` file when exporting readable enum labels.
+- One or more unpacked `.user.3` files.
+
+## Command Line
+
+Export `.user.3` files to JSON:
+
+```bash
+pyreuser3 export \
+  -i <input-user3-file-or-directory> \
+  -s <RE_RSZ-schema.json> \
+  -o <json-output-directory> \
+  -p <il2cpp_dump.json>
+```
+
+Pack JSON back to `.user.3`:
+
+```bash
+pyreuser3 pack \
+  -j <input-json-file-or-directory> \
+  -s <RE_RSZ-schema.json> \
+  -o <user3-output-directory> \
+  -p <il2cpp_dump.json>
+```
+
+The `-p/--il2cpp-dump-path` option is required for export and optional for pack. Passing it during pack is recommended when enum names need to be resolved back to numeric values.
+
+Start the local `.user.3` export Web UI:
+
+```bash
+pyreuser3-web --port 8765
+```
+
+The Web UI only handles `.user.3` export. It does not pack files and does not provide `.msg.23` conversion.
+
+## Python API
+
+```python
+from pyreuser3 import REUser3Converter
+
+converter = REUser3Converter(
+    schema_path="D:/schema/rsz_game.json",
+    il2cpp_dump_path="D:/game/il2cpp_dump.json",
+)
+
+converter.export_file(
+    "input/OtomonData.user.3",
+    "json/OtomonData.user.3.json",
+)
+
+converter.pack_file(
+    "json/OtomonData.user.3.json",
+    "mod/OtomonData.user.3",
+)
+```
+
+For stable patch-and-repack workflows, use `patch_file()` or `parse_pack_file()`:
+
+```python
+from pyreuser3 import REUser3Converter
+
+converter = REUser3Converter(
+    schema_path="D:/schema/rsz_game.json",
+    il2cpp_dump_path="D:/game/il2cpp_dump.json",
+)
+
+def patch(data, source_path):
+    # Modify the full instance-table JSON in place.
+    return None
+
+converter.patch_file(
+    "input/example.user.3",
+    "output/example.user.3",
+    patch,
+)
+```
+
+## Build From Source
+
+```bash
+python -m pip install -U build twine
+python -m build
+python -m twine check dist/*
+```
+
+Upload to TestPyPI first:
+
+```bash
+python -m twine upload -r testpypi dist/*
+```
+
+Then upload the same checked distribution files to PyPI:
+
+```bash
+python -m twine upload dist/*
+```
+
+## License
+
+MIT License.

pyreuser3-0.1.0/PyREUser3.egg-info/SOURCES.txt

@@ -0,0 +1,40 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+PyREUser3.egg-info/PKG-INFO
+PyREUser3.egg-info/SOURCES.txt
+PyREUser3.egg-info/dependency_links.txt
+PyREUser3.egg-info/entry_points.txt
+PyREUser3.egg-info/requires.txt
+PyREUser3.egg-info/top_level.txt
+docs/README.zh-CN.md
+pyreuser3/__init__.py
+pyreuser3/__main__.py
+pyreuser3/api.py
+pyreuser3/cli.py
+pyreuser3/core.py
+pyreuser3/rich_ui.py
+pyreuser3/schema.py
+pyreuser3/export/__init__.py
+pyreuser3/export/base.py
+pyreuser3/export/enums.py
+pyreuser3/export/fields.py
+pyreuser3/export/metadata.py
+pyreuser3/export/postprocess.py
+pyreuser3/export/tree.py
+pyreuser3/export/user3.py
+pyreuser3/pack/__init__.py
+pyreuser3/pack/base.py
+pyreuser3/pack/models.py
+pyreuser3/pack/plan.py
+pyreuser3/pack/writer.py
+pyreuser3/web/__init__.py
+pyreuser3/web/__main__.py
+pyreuser3/web/handler.py
+pyreuser3/web/jobs.py
+pyreuser3/web/page.py
+pyreuser3/web/picker.py
+pyreuser3/web/runners.py
+pyreuser3/web/server.py
+pyreuser3/web/settings.py

pyreuser3-0.1.0/PyREUser3.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyreuser3-0.1.0/PyREUser3.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pyreuser3 = pyreuser3.cli:main
+pyreuser3-web = pyreuser3.web.server:main

pyreuser3-0.1.0/PyREUser3.egg-info/requires.txt

@@ -0,0 +1,5 @@
+rich>=13.0
+
+[dev]
+build>=1.2
+twine>=5.0

pyreuser3-0.1.0/PyREUser3.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyreuser3

pyreuser3-0.1.0/README.md

@@ -0,0 +1,132 @@
+# PyREUser3
+
+English | [简体中文](./docs/README.zh-CN.md)
+
+PyREUser3 is a pure Python package for converting RE Engine `.user.3` database files to JSON and packing compatible JSON back to `.user.3`.
+
+Install it with:
+
+```bash
+pip install pyreuser3
+```
+
+Import it with the same normalized package name:
+
+```python
+from pyreuser3 import REUser3Converter
+```
+
+## What Is Included
+
+- `.user.3 -> JSON` export.
+- `JSON -> .user.3` packing.
+- A reusable Python API through `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.
+
+## Requirements
+
+- Python 3.9 or newer.
+- A RE_RSZ schema JSON file for the target game/version.
+- An `il2cpp_dump.json` file when exporting readable enum labels.
+- One or more unpacked `.user.3` files.
+
+## Command Line
+
+Export `.user.3` files to JSON:
+
+```bash
+pyreuser3 export \
+  -i <input-user3-file-or-directory> \
+  -s <RE_RSZ-schema.json> \
+  -o <json-output-directory> \
+  -p <il2cpp_dump.json>
+```
+
+Pack JSON back to `.user.3`:
+
+```bash
+pyreuser3 pack \
+  -j <input-json-file-or-directory> \
+  -s <RE_RSZ-schema.json> \
+  -o <user3-output-directory> \
+  -p <il2cpp_dump.json>
+```
+
+The `-p/--il2cpp-dump-path` option is required for export and optional for pack. Passing it during pack is recommended when enum names need to be resolved back to numeric values.
+
+Start the local `.user.3` export Web UI:
+
+```bash
+pyreuser3-web --port 8765
+```
+
+The Web UI only handles `.user.3` export. It does not pack files and does not provide `.msg.23` conversion.
+
+## Python API
+
+```python
+from pyreuser3 import REUser3Converter
+
+converter = REUser3Converter(
+    schema_path="D:/schema/rsz_game.json",
+    il2cpp_dump_path="D:/game/il2cpp_dump.json",
+)
+
+converter.export_file(
+    "input/OtomonData.user.3",
+    "json/OtomonData.user.3.json",
+)
+
+converter.pack_file(
+    "json/OtomonData.user.3.json",
+    "mod/OtomonData.user.3",
+)
+```
+
+For stable patch-and-repack workflows, use `patch_file()` or `parse_pack_file()`:
+
+```python
+from pyreuser3 import REUser3Converter
+
+converter = REUser3Converter(
+    schema_path="D:/schema/rsz_game.json",
+    il2cpp_dump_path="D:/game/il2cpp_dump.json",
+)
+
+def patch(data, source_path):
+    # Modify the full instance-table JSON in place.
+    return None
+
+converter.patch_file(
+    "input/example.user.3",
+    "output/example.user.3",
+    patch,
+)
+```
+
+## Build From Source
+
+```bash
+python -m pip install -U build twine
+python -m build
+python -m twine check dist/*
+```
+
+Upload to TestPyPI first:
+
+```bash
+python -m twine upload -r testpypi dist/*
+```
+
+Then upload the same checked distribution files to PyPI:
+
+```bash
+python -m twine upload dist/*
+```
+
+## License
+
+MIT License.