#foreign-interface #java #jni #swig #cpp

flapigen

Tool for connecting libraries written in Rust with other languages

16 releases

0.8.0 Nov 11, 2024
0.7.0 Jun 5, 2024
0.6.1 Apr 9, 2024
0.6.0 Apr 16, 2023
0.6.0-pre13 Jul 14, 2022

#38 in FFI

Download history 330/week @ 2024-08-17 287/week @ 2024-08-24 243/week @ 2024-08-31 203/week @ 2024-09-07 210/week @ 2024-09-14 448/week @ 2024-09-21 596/week @ 2024-09-28 384/week @ 2024-10-05 418/week @ 2024-10-12 346/week @ 2024-10-19 337/week @ 2024-10-26 344/week @ 2024-11-02 406/week @ 2024-11-09 344/week @ 2024-11-16 233/week @ 2024-11-23 453/week @ 2024-11-30

1,475 downloads per month

BSD-3-Clause

800KB
22K SLoC

flapigen Build Status License Rust Documentation

Tool for connecting programs or libraries written in Rust with other languages. Foreign language api generator - flapigen. Former name rust_swig was changed to not confuse with swig. Currently implemented support for C++ and Java, but you can write support for any language of your choice. For an instruction how to integrate flapigen with your project look here.

Suppose you have the following Rust code:

struct Foo {
    data: i32
}

impl Foo {
    fn new(val: i32) -> Foo {
        Foo{data: val}
    }

    fn f(&self, a: i32, b: i32) -> i32 {
        self.data + a + b
    }

    fn set_field(&mut self, v: i32) {
        self.data = v;
    }
}

fn f2(a: i32) -> i32 {
    a * 2
}

and you want to write in Java something like this:

Foo foo = new Foo(5);
int res = foo.f(1, 2);
assert res == 8;

or in C++ something like this:

Foo foo(5);
int res = foo.f(1, 2);
assert(res == 8);

In order to implement it flapigen suggests the following functionality, in Rust project you write (in Rust language):

foreign_class!(class Foo {
    self_type Foo;
    constructor Foo::new(_: i32) -> Foo;
    fn Foo::set_field(&mut self, _: i32);
    fn Foo::f(&self, _: i32, _: i32) -> i32;
    fn f2(_: i32) -> i32;
});

and that's all, as a result flapigen generates JNI wrappers for Rust functions and Java code to call these JNI functions or generates C compatible wrappers in case of C++ and C++ code to call these C functions.

If you want the interface file (the file containing foreign_class! and so on) to be automatically generated for you, checkout rifgen.

Users Guide

📚 Read the flapigen users guide here! 📚

Dependencies

~4–13MB
~165K SLoC