Metadata-Version: 2.1
Name: ppc-asm
Version: 1.3.0
Summary: library for writing assembly for PowerPC, focused on Nintendo GameCube/Wii
Author: Henrique Gemignani Passos Lima
Project-URL: Homepage, https://github.com/henriquegemignani/ppc-asm
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
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
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: pytest-mock; extra == "test"

# ppc-asm

This package provides allows one to easily modify existing Nintendo GameCube or Wii game executables.


## Usage

```python

import pathlib
from ppc_asm.dol_file import DolFile
from ppc_asm.assembler.ppc import *

dol_file = DolFile(pathlib.Path("main.dol"))
dol_file.set_editable(True)
with dol_file:
    dol_file.write_instructions(
        0x800857F0,
        [
            or_(r3, r30, r30),
            li(r4, 0x29),
            li(r5, 9999),
            bl(0x80085760),
        ]
    )

```
