Skip to content

Implementation of a custom Assembler & Simulator for a given ISA using python script. This is a CO group assignment (Semester-2) done by me, Aditya Raj Jain, Hardik Sachdeva and Keshav!

License

Notifications You must be signed in to change notification settings

akshatrajsaxena/Simple_Simulator_Assembler_Project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

Simple Simulator and Assembler Project

A comprehensive toolkit for simulating and assembling simple assembly language instructions.

Stars Badge Forks Badge Pull Requests Badge Issues Badge GitHub contributors License Badge

Overview

The Simple Simulator and Assembler Project provides a set of tools to assemble and simulate simple assembly language programs. This project is designed to help understand the basics of how assemblers and simulators work by providing a hands-on toolkit for assembling and simulating instructions.

Features

Assembler: Converts assembly language instructions into machine code.

Simulator: Executes the machine code instructions and provides an environment to test and debug assembly programs.

Automated Testing: Comprehensive testing suite to validate the correctness of the assembler and simulator.

Project Structure

Screenshot 2024-06-21 110653

Getting Started

Prerequisites

Python 3.x

Installation

Clone the repository:

git clone https://github.com/yourusername/Simple_Simulator_Assembler_Project.git
cd Simple_Simulator_Assembler_Project

Navigate to the assembler directory and run the assembler:

cd Simple_Simulator_Assembler/Simple-Assembler
python assembler.py

Navigate to the simulator directory and run the simulator:

cd ../SimpleSimulator
python simulator.py

Run automated tests to ensure everything is set up correctly:

cd ../automatedTesting
python run

Usage

Assembler

The assembler translates assembly code into machine code. To use the assembler, provide your assembly code in the appropriate format, and run the assembler.py script.

Simulator

The simulator executes machine code generated by the assembler. Run the simulator.py script to start the simulation.

Automated Testing

Automated tests ensure the reliability and correctness of the assembler and simulator. The tests cover various scenarios and edge cases to validate the functionality of the project.

FAQs

Q: What is the purpose of this project?

A: This project is designed to help users understand the basics of assemblers and simulators by providing a practical toolkit for converting and executing simple assembly language instructions.

Q: What languages are supported by the assembler?

A: The assembler supports a custom-designed simple assembly language tailored for educational purposes.

Q: How do I run tests?

A: Navigate to the automatedTesting directory and execute the run script using Python.

Q: Can I contribute to this project?

A: Yes, contributions are welcome! Please create a PR to add new features, fix bugs, or improve documentation.

Contribute

Contributions are always welcome! Please create a PR to add features, fix bugs, or improve documentation.

License

This project is licensed under the MIT license.

MIT License

Show your support

Give a ⭐️ if this project helped you!

About

Implementation of a custom Assembler & Simulator for a given ISA using python script. This is a CO group assignment (Semester-2) done by me, Aditya Raj Jain, Hardik Sachdeva and Keshav!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published