/BF-Swift-Interpreter

The Brainfuck Interpreter for iOS is an app that lets iPhone users write, run, and debug Brainfuck code. It has an easy-to-use code editor, handles errors like mismatched brackets, and includes tools for checking code as it runs. The app has been thoroughly tested for reliability.

Primary LanguageSwiftMIT LicenseMIT

Brainfuck Interpreter for iOS

Description

This repository hosts an iOS application that serves as an interpreter for the Brainfuck programming language. Aimed at providing an interactive and user-friendly platform, this app allows users to write, execute, and debug Brainfuck code directly from their iPhone.

Features

  • Interactive Brainfuck code editor and interpreter
  • Error handling for syntax and runtime errors, such as mismatched brackets
  • Debugging tools to monitor code execution and cell values
  • Comprehensive unit tests ensuring reliability and performance
  • Stepping and highlighting debugging features

Installation

To run and modify this app, you'll need Xcode installed on your Mac.

  1. Clone the repository: 
    git clone https://github.com/mcgirr5799/BF-Swift-Interpreter.git
  2. Open the project:
    • Navigate to the cloned directory and open the .xcodeproj file in Xcode.

Usage

To test the app:

  1. Open the project in Xcode.
  2. Select an iPhone simulator or connect an iPhone device.
  3. Press the 'Run' button in Xcode to build and run the app on the selected simulator or device.

Screenshots

Get a glimpse of the Brainfuck Interpreter in action:

  1. Home Page

Home Page

The intuitive home page of the Brainfuck Interpreter. Here, users can immediately start typing in Brainfuck code, with clear options for running, debugging, and resetting their code. Designed for simplicity and ease of use.

  1. Hello World Example

Hello World Example

Experience the classic "Hello World" program in Brainfuck. This screenshot shows the app running the iconic introductory code snippet, demonstrating the interpreter's ability to execute Brainfuck code seamlessly.

Running Tests

  • The project includes a suite of unit tests.
  • To run these tests, select the test navigator in Xcode and click the 'Run' button next to the test suite.

Contributing

Contributions are welcome! If you have ideas for new features or improvements, feel free to fork the repository and submit pull requests.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Acknowledgements

  • This app is inspired by the intriguing simplicity of the Brainfuck programming language and aims to make it more accessible to enthusiasts and learners alike.