Datalink 6805 Online Assembler (Rust Port)

This is a Rust port of the datalink ASM6805 assembler, originally written in TypeScript by John Toebes. The original project can be found at https://github.com/toebes/asm6805.

This port was automatically translated from the original TypeScript source code with the assistance of AI tools and has had minimal human supervision.

Building the code

After pulling down the repository, you can build the project with:

cargo build --release

This will create an optimized executable in the target/release directory.

Running the assembler

To assemble a file, run the following command:

./target/release/asm6805 <input_file>

For more options, run:

./target/release/asm6805 --help

Using as a Library

To use this assembler as a library in your own Rust project, add the following to your Cargo.toml:

[dependencies]
rs-asm6805 = "1.0.1"

Or execute cargo add rs-asm6805 to add it automatically.

Then, you can use the assemble function in your code like this:

use rs_asm6805::assemble;

fn main() {
    let source_code = vec![
        "ORG $110".to_string(),
        "LDA #$42".to_string(),
    ];

    match assemble("my_source.asm".to_string(), source_code) {
        Ok((errors, hex, listing)) => {
            if !errors.is_empty() {
                for error in errors {
                    eprintln!("{}", error);
                }
            }
            println!("Hex output: {}", hex);
            println!("Listing:");
            for line in listing {
                println!("{}", line);
            }
        }
        Err(errors) => {
            for error in errors {
                eprintln!("{}", error);
            }
        }
    }
}

License

This project is licensed under the BSD-3-Clause license. See the LICENSE file for details.