emu6502

emu6502 is a full 6502 emulation, testing, and debugging suite.

It uses vm6502 as a backend. It also uses anima6502 to utilize python bindings for the vm.

How to use

```bash

Clone the repo and enter it.

> git clone git@github.com:GRAYgoose124/emu6502.git
> cd emu6502/

```

Running & building the Rust frontend demo:

```bash

To run the project as a regular binary:

> cargo run --features=debug_vm

Or to build it as a standalone binary and run:

> cargo build --release
> ./target/release/emu650

```

Anima Sub-crate

Anima provides Python bindings for the virtual machine from crate::vm6502.

Anima uses maturin build tooling.

It's recommended you first create a virtual env in the root of emu6502 before installing.

Setup

Build

```bash

cd 6502 maturin [develop|release] # develoop automatically installs

# To develop the Anima backend python
> pip install -e .

# Tests
> maturin test

```
S/N: maturin develop will rewrite this pip installation, useful for python only changes.

Running the Demo Python Frontend

After building with maturin, you can simply run anima, or use it's bindings in python with anima._anima. ```bash

anima6502 ```

Using Python bindings after installing

```python from anima._anima import Animator

animator = Animator() animator.do_program(0x0000, "690101690101") ```