Portable Foreign Function Interface for R7RS schemes
Foreign function interface that is supported on multiple R7RS Sceheme implementations.
Note that this software is in alpha stage. That said the interface should not be changing anymore.
Any help in form of constructive advice and bug reports are appreciated.
Documentation or run mkdocs serve or see docs/.
For documentation see retropikzel.neocities.org/r7rs-pffi or run mkdocs serve or see or docs/ directory.
Goals
- Support only R7RS implementations
- Needs to have cond-expand and library support atleast (propably much more)
- Same interface on all implementations
- Some things that are procedures on one implementation are macros on other, but they must behave the same
Non goals
- To support all R7RS implementations
- To have every possible FFI feature
- Compiling of C code at any point
- That is no stubs, no C code generated by the library and so on
Support tiers
Tier 1
- Chicken
- Still needs work
- Guile
- Good support, recommended
- Kawa
- Needs at least java version 22
- Needs jvm flags:
- --add-exports java.base/jdk.internal.foreign.abi=ALL-UNNAMED
- --add-exports java.base/jdk.internal.foreign.layout=ALL-UNNAMED
- --add-exports java.base/jdk.internal.foreign=ALL-UNNAMED
- --enable-native-access=ALL-UNNAMED
- Good support (otherwise), recommended
- Sagittarius
- Good support, recommended
- Racket
- Good support, recommended
- Gambit
- Still needs work
Tier 2
These implementations do not have callback support on their FFI. If I'm wrong please let me know!
Tier 3
Support waiting for the implementation.
- LIPS
- Waiting for implementation to have cond-expand and library support
- Will only work on nodejs
- Biwascheme
- Waiting for implementation to have cond-expand and library support
- Will only work on nodejs
Tier 4
Support needs to be investigated.
Tier 5
Support maybe possible/dreaming about.
- Airship
- Other gambit targets
- Gambit compiles to different targets other than C too, for example Javascript. It would be cool and interesting to see if this FFI could also support some of those
Tier 6
Not supported currently, and may never be.