RIS-CPP

A comprehensive development environment for the Reverse Instruction System (RIS) in C++.

Features

• 🚀 Complete project scaffolding
• 🔍 VS Code integration with syntax highlighting
• 📝 Language server with autocompletion
• 🐛 Integrated debugging support
• 📊 Test framework integration
• 👀 File watching and live reload
• 🛠️ CMake-based build system

Installation

npm install -g ris-cpp

Quick Start

1. Create a new project:

ris-cpp --init

2. Start coding in the src directory
3. Compile your project:

ris-cpp --compile src/main.cpp

4. Run with file watching:

ris-cpp --watch

Project Structure

./
├── src/                 # Source files
│   ├── main.cpp        # Main interpreter
│   └── example.ris     # Example RIS file
├── .vscode/            # VS Code configuration
│   ├── settings.json   # Editor settings
│   └── launch.json     # Debug configuration
├── server/             # Language server
│   └── server.js       # Server implementation
├── tests/              # Test directory
│   └── interpreter.test.js
└── CMakeLists.txt      # Build configuration

RIS Language Support

The package provides full language support for RIS files including:

• Syntax highlighting
• Code completion
• Error detection
• Symbol navigation

Supported Commands

• VAR: Variable declaration
• PRN: Print statement
• HLT: Halt execution
• INT: Hardware interrupt
• OUT: Port output
• IN: Port input
• PROC: Process creation

VS Code Integration

Features

• Custom syntax highlighting for .ris files
• Debugging configuration
• IntelliSense support
• Format on save
• Custom snippets

Debugging

1. Set breakpoints in your code
2. Press F5 to start debugging
3. Use the debug toolbar to step through code

Build System

The project uses CMake for building. To build your project:

# In the project root
mkdir build && cd build
cmake ..
make

Testing

Run the test suite:

npm test

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

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