Retropikzel
/
foreign-c
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
foreign-c/README.md

3.7 KiB
Raw Blame History

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/.

Issue tracker

Maling lists

For documentation see retropikzel.neocities.org/r7rs-pffi or run mkdocs serve or see or docs/ directory.

For status of what tests pass on which implementations see Jenkins.

Goals

  • Support only R7RS implementations (for now)
  • 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 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

Support is defined in tiers, each tier has short explanation about it after the title.

Currently the interface of the library is okay. Now work needs to be done to make tests and see that each implementation passes those tests. This will be done in tiered order starting from tier 1.

Untiered, support needs to be investigated:

Tier 1

Aiming to support these first

  • Chicken
  • Guile
  • 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
  • Sagittarius
  • Racket

Tier 2

Work in progress

  • Gambit
    • Propably able to support everything but so annoying to deal with that it's currently in tier 2
  • STKlos
    • No callback support
  • Cyclone
    • No callback support

Tier 3

In queue

  • LIPS
    • Will work on nodejs by using some Javascript FFI
    • Javascript side needs design
  • Biwascheme
    • Will work on nodejs by using some Javascript FFI
    • Javascript side needs design

Tier 4

Support needs investigation and serious design or making dynamic FFI for the implementation

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

Other.

  • Loko
    • Desires no C interop, I can respect that