Skip to content

Latest commit

 

History

History
60 lines (37 loc) · 2.1 KB

README.md

File metadata and controls

60 lines (37 loc) · 2.1 KB

ByteCoreFast Emulator

ByteCoreFast is a high-performance drop-in replacement for the ByteCore Emulator. It extends the ByteCore classes and replaces the emulator engine with a custom engine written in C for enhanced speed. This project aims to maintain 100% compatibility with the public interfaces of the ByteCore Emulator. If you encounter any incompatibilities, please create an issue detailing the discrepancy.

Key Features

  • Fast performance for long-running programs.
  • Seamless integration with ByteCore Emulator projects.
  • Simple installation and usage.

Installation

Using pip

To install ByteCoreFast, run:

pip3 install bytecorefast

Manual Setup

  1. Ensure you have Python 3.11 or newer installed.
  2. Clone the repository and navigate into the root directory.
  3. (Optional) Create a Python virtual environment to isolate dependencies.
  4. Install the necessary dependencies:
pip3 install -r requirements.txt

Gitpod Setup

You can also use Gitpod to run the emulator by clicking here.

How to Use

To use ByteCoreFast, replace the import statement in your project:

# Original import
from bytecore.emulator import ByteCore

# New import for faster performance
from bytecorefast.emulator import ByteCore

You should now see improved performance for long-running programs. Note that small programs or step-by-step execution might be slower due to overhead.

Running the Emulator

To run the emulator, follow the instructions provided in the ByteCore project.

Troubleshooting

If the C code is not compiled for your system, you may encounter issues. In such cases, please revert to the original ByteCore Emulator written entirely in Python.

License

This project is licensed under the terms of the MIT License. See the LICENSE file for the full text.