https://github.com/lochbrunner/charlie
A learning project: Compiles C-Code to Byte-Code and runs it in a virtual machine.
https://github.com/lochbrunner/charlie
bytecode-compiler debugger virtual-machine
Last synced: 9 months ago
JSON representation
A learning project: Compiles C-Code to Byte-Code and runs it in a virtual machine.
- Host: GitHub
- URL: https://github.com/lochbrunner/charlie
- Owner: lochbrunner
- Created: 2016-06-01T06:45:29.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2022-12-11T19:18:19.000Z (about 3 years ago)
- Last Synced: 2025-03-24T15:41:30.732Z (9 months ago)
- Topics: bytecode-compiler, debugger, virtual-machine
- Language: C++
- Homepage:
- Size: 7.78 MB
- Stars: 8
- Watchers: 3
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Charlie
A learning project: Compiles C-Code to Byte-Code and runs it in a virtual machine.
## Prerequisites
* Boost C++ Library
* CMake
## Build
Run `./configure` to create the build directory and the make files.
RUn `cmake --build .` inside the `build-debug` directory to build the binaries into `build-debug/bin` and `build-debug/lib`.
## Usage
### The Console
Type into the console
charlie build where `` is your entry C++ file in which a `main` function must be defined.
For now the compiler only supports source files. Note the ending `.cc` willl be append to your given filename.
### The Library
Usage example:
``` c++
using namespace charlie;
// Init the Compiler and set the output for compiler messages.
Compiler compiler = Compiler([](string const& message)
{
cout << message << endl;
});
// Add external function which can be called by the program
compiler.ExternalFunctionManager.AddFunction("print", [](const char *message)
{
cout << message;
});
// Compile the file "src/main.cc"
compiler.Build("src/main");
// Run the program
compiler.Run();
```
## Supported Features
The [samples](/samples) in show the currently supported features of that tool set. Or [click here](/docs/features.md) for more informations.
## Contributing Code
Please feel welcome to folk this repository.
You will need to download the [Google Test](https://github.com/google/googletest) library in order to run the tests.
If you are using Visual Studio you have to set the system variable `GTEST` to the directory `googletest\googletest`.