Skip to content

Latest commit

 

History

History
31 lines (26 loc) · 1.83 KB

README.md

File metadata and controls

31 lines (26 loc) · 1.83 KB
Raw

diplomat-java

Panama-based Java backend for Diplomat. This backend depends on the jextract command-line tool to generate JEP 454 access and calling code for the generated native library. Because of this dependency this backend won't be packaged with the diplomat tool.

JEP 454 binding generation

In order to package this backend with the other backends there is a long term plan to implement a subset of jextract's functionality. The reasons for this include:

  • reducing the amount of generated code: By default jextract produces wrappers for standard library code as well as other methods that should not be unnecessary for a Diplomat wrapped library.
  • simplifying development setup: most Diplomat developers are not familiar with Java and setting up a Java development environment causes unnecessary friction. Diplomat strives to enable contributors to only have to set up an environment for the language that they need a backend for. But all Diplomat contributors need to generate the code for all backends.
  • simplifying ci setup: jextract does not appear to be available via package manager, and so needs to be downloaded via URL. This is an undesired step for Diplomat.

This JEP 454 binding generation will be developed as a library jextrsact in this repository. It will not be a replacement for jextract as it will focus only on

Running

You need to specify a toml config file with a domain a library name

domain = "dev.diplomattest"
lib_name = "somelib"

then pass the location of the library with -e, with a config path specified with -l and then an output directory

diplomat-java -e feature/src/lib.rs -l feature/diplomat-java-conf.toml feature/tmp/