https://github.com/mull-project/llvm-jit-objc
Extensions for LLVM's JIT to run Objective-C and Swift code.
https://github.com/mull-project/llvm-jit-objc
Last synced: about 1 month ago
JSON representation
Extensions for LLVM's JIT to run Objective-C and Swift code.
- Host: GitHub
- URL: https://github.com/mull-project/llvm-jit-objc
- Owner: mull-project
- Created: 2018-05-07T19:18:51.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-09-29T20:47:28.000Z (over 5 years ago)
- Last Synced: 2025-04-04T21:11:10.909Z (about 2 months ago)
- Language: C++
- Homepage:
- Size: 331 KB
- Stars: 37
- Watchers: 4
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Attempt to run Objective-C and Swift code with LLVM JIT
This is a highly experimental proof of concept which was supposed to serve as
an Objective-C/Swift backend for Mull mutation testing tool. We have never
finished this project because we mostly focused on C/C++ since then.
See these articles for a background:
- [LLVM JIT, Objective-C and Swift on macOS: knowledge dump](https://stanislaw.github.io/2018/09/03/llvm-jit-objc-and-swift-knowledge-dump.html)
- [Mutation testing for Swift with Mull: how it could work. Looking for contributors.](https://stanislaw.github.io/2018/09/03/mull-and-swift-how-it-almost-works.html)
**Note:** Please keep in mind, that the code covers only very basics of running
Objective-C with LLVM JIT. The code is quite raw and you can quickly hit some
weird crashes or unexpected behavior once you start adding some new
functionality and test cases. See also this Twitter thread where the engineer
from Apple says that this project's implementation is based on a very unstable
API: https://twitter.com/gparker/status/1036671921616609280.
## Setup
### Preconditions
You need to have a binary version of LLVM 6 installed on your machine in
`/opt/llvm-6.0.0` folder.
The binary distribution of LLVM 6 can be found on
[LLVM Download Page](http://releases.llvm.org/download.html) page.
### Cloning the repository
Please clone the repository to the `/opt/llvm-jit-objc`. Putting everything
to the `/opt` was an old convention that allowed faster prototyping. This
should be changed in the future but for now many things are hardcoded to the
`/opt/llvm-jit-objc` folder.
### Generating fixtures
Generation of the fixtures is not (yet) part of CMake project so you have to
create them manually:
```bash
cd fixtures && make all
cd fixtures/xctest_swift_001_minimal_xctestcase_run/ && make compile
```
### Creating a project
The project works on macOS only.
To run with Xcode, clone the repository and run:
```
make xcode.build
make xcode.open
```
Otherwise the project is a normal CMake project so opening it with any
CMake-aware IDE like CLion should work out of the box.