nes-pascal

Prerequisites and installation

English Português (Brasil)

Prerequisites

The compiler has no runtime Python dependencies outside the standard library. Installing the Python package does not install the cc65 toolchain: ca65 and ld65 are external dependencies required for the final ROM build.

Installing the package

Install NES Pascal from the repository:

python -m pip install .

The installation provides the nes-pascal command:

nes-pascal --version
nes-pascal examples/minimal.nsp -o build/minimal.nes

python -m nes_pascal.cli remains supported as an equivalent module invocation:

python -m nes_pascal.cli examples/minimal.nsp -o build/minimal.nes

For development, an editable installation links the installed package to the working tree so source changes take effect immediately:

python -m pip install -e .

Running from the repository

Without installing, the compiler can run directly from the repository root:

python -m nes_pascal.cli examples/minimal.nsp -o build/minimal.nes

Building the final ROM

ca65 and ld65 must be available on PATH to assemble and link the generated Assembly into a .nes ROM. When they are missing, the compiler still writes the .asm, .cfg, and .map outputs and then reports the E5001 missing-toolchain diagnostic.

Continue with Your first program.