retrotool-asar 1.91__tar.gz

retrotool_asar-1.91/MANIFEST.in

@@ -0,0 +1,9 @@
+recursive-include vendor *
+prune vendor/**/.git
+prune vendor/.git
+global-exclude .github
+global-exclude *.pyc
+global-exclude __pycache__
+include README.md
+include pyproject.toml
+include setup.py

retrotool_asar-1.91/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: retrotool-asar
+Version: 1.91
+Summary: Bundled asar (RPGHacker) 65816 patcher binary for retrotool
+Author-email: Daniel Burgess <daniel@herotechsys.com>
+License: MIT AND LGPL-3.0-or-later
+Keywords: asar,65816,snes,sfc,patcher,assembler
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Assemblers
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# retrotool-asar
+
+Bundled [asar](https://github.com/RPGHacker/asar) (RPGHacker) standalone
+65816 patcher CLI for retrotool. Installing this wheel makes `asar`
+available to `retrotool.asm.patcher` without a system asar on PATH.
+
+## Usage
+
+```python
+from retrotool_asar import asar_binary, run_asar
+
+run_asar(["patch.asm", "rom.sfc"])
+```
+
+`retrotool.asm.patcher.apply_patch` prefers the bundled binary when this
+package is installed, else falls back to `asar` on PATH.
+
+## License
+
+asar is MIT (RPGHacker, Alcaro, et al.). This wheel redistributes the
+compiled binary under the same license. See `vendor/asar/LICENSE.txt`.

retrotool_asar-1.91/README.md

@@ -0,0 +1,21 @@
+# retrotool-asar
+
+Bundled [asar](https://github.com/RPGHacker/asar) (RPGHacker) standalone
+65816 patcher CLI for retrotool. Installing this wheel makes `asar`
+available to `retrotool.asm.patcher` without a system asar on PATH.
+
+## Usage
+
+```python
+from retrotool_asar import asar_binary, run_asar
+
+run_asar(["patch.asm", "rom.sfc"])
+```
+
+`retrotool.asm.patcher.apply_patch` prefers the bundled binary when this
+package is installed, else falls back to `asar` on PATH.
+
+## License
+
+asar is MIT (RPGHacker, Alcaro, et al.). This wheel redistributes the
+compiled binary under the same license. See `vendor/asar/LICENSE.txt`.

retrotool_asar-1.91/pyproject.toml

@@ -0,0 +1,45 @@
+[project]
+name = "retrotool-asar"
+version = "1.91"
+description = "Bundled asar (RPGHacker) 65816 patcher binary for retrotool"
+readme = "README.md"
+authors = [{name = "Daniel Burgess", email = "daniel@herotechsys.com"}]
+license = {text = "MIT AND LGPL-3.0-or-later"}
+requires-python = ">=3.12"
+keywords = ["asar", "65816", "snes", "sfc", "patcher", "assembler"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "License :: OSI Approved :: MIT License",
+    "License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Assemblers",
+]
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["retrotool_asar"]
+
+[tool.setuptools.package-data]
+retrotool_asar = ["bin/*", "licenses/*"]
+
+[tool.cibuildwheel]
+skip = ["pp*", "*-musllinux_*", "cp36-*", "cp37-*", "cp38-*", "cp39-*", "cp310-*", "cp311-*"]
+build-verbosity = 1
+
+[tool.cibuildwheel.linux]
+before-all = "yum install -y gcc-c++ make cmake || { apt-get update && apt-get install -y g++ make cmake; }"
+archs = ["x86_64", "aarch64"]
+
+[tool.cibuildwheel.macos]
+archs = ["x86_64", "arm64"]
+
+[tool.cibuildwheel.windows]
+archs = ["AMD64"]

retrotool_asar-1.91/retrotool_asar/__init__.py

@@ -0,0 +1,36 @@
+"""Bundled asar (RPGHacker) standalone CLI accessor.
+
+`asar_binary()` returns the path to the vendored executable, or raises
+`ToolNotBundledError` if this wheel was built without it. `run_asar` is
+a `subprocess.run` convenience wrapper.
+"""
+from __future__ import annotations
+
+import subprocess
+import sys
+from importlib.resources import files
+from pathlib import Path
+
+__version__ = "1.91"
+
+_EXE = ".exe" if sys.platform == "win32" else ""
+
+
+class ToolNotBundledError(FileNotFoundError):
+    """Raised when the bundled asar binary is not present in this wheel."""
+
+
+def asar_binary() -> Path:
+    p = Path(str(files(__package__) / "bin" / f"asar{_EXE}"))
+    if not p.exists():
+        raise ToolNotBundledError(
+            f"Bundled `asar` missing at {p}. This retrotool-asar wheel was "
+            f"built without the binary. Reinstall, or build from sdist with "
+            f"vendor/asar populated."
+        )
+    return p
+
+
+def run_asar(args, **kw) -> subprocess.CompletedProcess:
+    kw.setdefault("check", True)
+    return subprocess.run([str(asar_binary()), *args], **kw)

retrotool_asar-1.91/retrotool_asar/licenses/asar-LICENSE

@@ -0,0 +1,24 @@
+Asar is licensed under GNU Lesser General Public License, version 3 or later. The full legal text
+  can be found in license-lgpl.txt, but it is also allowed to obey the following rules instead if
+  you prefer that (legalese is complicated):
+
+If you don't want to redistribute it or distribute modifications (aka you only want it for personal
+  use), you may do whatever you want with it. The author of Asar claims no copyright over input,
+  binary output or textual output (including error messages) generated by Asar.
+
+If you do want to redistribute it, you must obey the LGPL. This means the following:
+- You must credit the author. Don't claim it as your own. You may modify it and take credit for your
+  modifications, but the author (Alcaro) must be credited for the original software.
+- You must make it possible to replace your copy of Asar with another version, if anyone wants that.
+  If you're using one of the dynamic libraries, you must either keep it as a separate file and allow
+  anyone who wants to replace it, or you must offer all source codes and related files that are
+  required to rebuild your tool to anyone who asks. If Asar is linked statically into the same
+  program, only the latter option is possible.
+- If you modify this software, it must clearly be labeled as a modification, and you must provide
+  full source code to anyone who asks.
+
+However, as a special exception, the DLL interface files (dll/asardll.h and dll/asardll.cpp)
+are licensed under the WTFPL (version 2 or later), which much means you may use them for
+anything you want. You don't need to make them upgradable, you don't need to credit the
+author, and you don't need to release any source codes. Note that this does not apply to the DLLs
+themselves, or anything compiled into a library.