Metadata-Version: 2.4
Name: retrotool-xdelta
Version: 3.1.1
Summary: Bundled xdelta3 binary for retrotool mbuild diff generation
Author-email: Daniel Burgess <daniel@herotechsys.com>
License: Apache-2.0
Keywords: xdelta,xdelta3,diff,patch,snes,rom
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Apache Software License
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 :: Build Tools
Classifier: Topic :: System :: Archiving :: Compression
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# retrotool-xdelta

Bundled [xdelta3](https://github.com/jmacd/xdelta) binary for retrotool's
mbuild diff pipeline. Installing this wheel makes `xdelta` diff output
available to `retrotool.mbuild` without requiring a system `xdelta3` on
PATH.

## Usage

```python
from retrotool_xdelta import xdelta3_binary, run_xdelta3

run_xdelta3(["-e", "-f", "-s", "orig.sfc", "mod.sfc", "out.xdelta"])
```

`retrotool.mbuild.diff.write_xdelta` prefers the bundled binary when this
package is installed, else falls back to `xdelta3` on PATH, else returns
a skipped `DiffResult` with an install hint (when `required=False`).

## License

xdelta3 is Apache-2.0 (Joshua MacDonald). This wheel redistributes the
compiled binary under the same license. See `vendor/xdelta/xdelta3/COPYING`.
