Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dyne/cjit
Just in time interpreter for C
https://github.com/dyne/cjit
c interpreter jit
Last synced: 1 day ago
JSON representation
Just in time interpreter for C
- Host: GitHub
- URL: https://github.com/dyne/cjit
- Owner: dyne
- Created: 2024-09-28T11:52:25.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-12-22T21:00:46.000Z (5 days ago)
- Last Synced: 2024-12-22T22:17:45.154Z (5 days ago)
- Topics: c, interpreter, jit
- Language: C
- Homepage: https://dyne.org/cjit/
- Size: 2.99 MB
- Stars: 326
- Watchers: 7
- Forks: 18
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSES/Apache-2.0.txt
Awesome Lists containing this project
README
[](https://dyne.org/cjit)
CJIT is a C interpreter based on tinyCC that compiles C code in-memory and runs it live. It is released as a small, all-in-one executable that can do a lot, including call functions from any installed library on Linux, Windows, and MacOSX.
More info on [Dyne.org/CJIT](https://dyne.org/cjit).
## 🚀 Quick start
Download the CJIT executable for your system
- Windows x86 64bit: [cjit.exe](https://github.com/dyne/cjit/releases/latest/download/cjit.exe)
- Apple/OSX: [cjit-Darwin-arm64](https://github.com/dyne/cjit/releases/download/v0.10.5/cjit-Darwin-arm64)
- GNU/Linux: [cjit-Linux-x86_64-static](https://github.com/dyne/cjit/releases/download/v0.10.5/cjit-Linux-x86_64-static)
and run it with c source files as well dynamic libraries as arguments:
```
./cjit.exe mysource.c mylib.dll
```
CJIT can do a lot more! continue reading its tutorial for a hands-on introduction.
### 📖 [The CJIT tutorial](https://dyne.org/docs/cjit)
## 💾 Downloads
We provide ready to execute binary builds on [github releases](https://github.com/dyne/cjit/releases).
Some systems may warn you about a virus in the file. There isn't, we submit each built executable to Virustotal via [github actions](https://github.com/dyne/cjit/actions).
## ⚙️ Build from source
There are various build targets, just type `make` to have a list:
```
✨ Welcome to the CJIT build system
🛟 Usage: make
👇 List of targets:
_
------ __ Production targets
musl-linux 🗿 Build a fully static cjit using musl-libc on Linux
linux-x86 🐧 Build a dynamically linked cjit using libs found on Linux x86
win-wsl 🪟 Build cjit.exe for WIN64 on an Ubuntu WSL VM using gcc-mingw-w64
win-native 🪟 Build cjit.exe for WIN64 on Windows Server
apple-osx 🍎 Build cjit.command for Apple/OSX using clang static
_
------ __ Debugging targets
debug-asan 🔬 Build using the address sanitizer to detect memory leaks
_
------ __ Testing targets
check 🧪 Run all tests using the currently built binary ./cjit
_
clean 🧹 Clean the source from all built objects
```
## 🔬 Internals
CJIT is a bit complex inside.
1. It relies on [tinycc](https://bellard.org/tcc/) to compile C code in-memory and run it immediately.
2. It detects automatically the system on which its running and auto-configures to support most features.
3. It embeds all C code and headers in [cjit/assets](https://github.com/dyne/cjit/tree/main/assets) making them available to all running code.
4. To embed them creates a `tar.gz` of assets at build-time and decompresses them at run-time in a temporary dir.
5. It ships a non-exclusive, opinionated selection of libraries useful to quickly script advanced applications in C.
The [CJIT's Frequently Asked Questions](https://dyne.org/docs/cjit/faq/) page may provide more information.
## 📑 License
CJIT is copyright (C) 2024 by the Dyne.org foundation
CJIT is distributed under the GNU General Public License v3
TinyCC is copyright (C) 2001-2004 by Fabrice Bellard
TinyCC is distributed under the GNU Lesser General Public License
For more information on licensing please refer to the Reuse report and
license texts included in [LICENSES](https://github.com/dyne/cjit/tree/main/LICENSES).
[](http://www.dyne.org)