ASMLings is an innovative and lightweight educational sandbox designed for Intel 8086 assembly programming, leveraging a Rust-based emulator. This interactive platform enables users to write assembly code, save their files, and receive immediate feedback, fostering a hands-on learning environment.

Features

• Instant Feedback Loop: As users code in assembly, ASMLings compiles and runs the code in real-time, providing instant results in the terminal. This approach accelerates the learning process and enhances code comprehension.
• Structured Exercises: The project includes a series of exercises, each encapsulated in its own .asm file, covering fundamental 8086 instructions like mov, add, push, and more. These exercises are designed to help users master assembly language step by step.

Quick Start Guide

1. Initialize Your Workspace: Set up your project environment by extracting exercise files and creating a progress tracker with the command:

   asmlings init
   

2. Begin Coding: Launch the persistent watch mode to continuously monitor your files:

   asmlings start
   

3. Solve Exercises: Navigate to the exercises/ directory, follow the embedded comments, and modify the assembly code. Each time a file is saved, ASMLings automatically reassembles and checks the code against various test cases.

Learning Approach

Each exercise requires users to satisfy certain assertions and test cases while also ensuring the removal of a specific comment (; I AM NOT DONE) to progress. This method emphasizes thorough understanding and intentional completion of challenges, making it ideal for learners looking to deepen their assembly programming skills.

Contributing

Collaboration is encouraged. Individuals interested in enhancing ASMLings can refer to the Contributing Guide for more information on setting up the development environment and troubleshooting.

With ASMLings, the complexities of Intel 8086 assembly programming become more manageable and engaging, offering an effective way to build essential programming skills.