24 stable releases (3 major)

4.1.5 Mar 9, 2024
4.0.2 Feb 2, 2023
3.1.12 Jan 26, 2023
2.0.1 Mar 25, 2020
0.1.2 Sep 30, 2019

#89 in FFI

Download history 6700/week @ 2024-08-15 12329/week @ 2024-08-22 11481/week @ 2024-08-29 10917/week @ 2024-09-05 8606/week @ 2024-09-12 9225/week @ 2024-09-19 10334/week @ 2024-09-26 11249/week @ 2024-10-03 10820/week @ 2024-10-10 11442/week @ 2024-10-17 11532/week @ 2024-10-24 13868/week @ 2024-10-31 12519/week @ 2024-11-07 12639/week @ 2024-11-14 12135/week @ 2024-11-21 12346/week @ 2024-11-28

51,534 downloads per month
Used in 3 crates

MIT/Apache

210KB
2K SLoC

Fork of dart-sys before the upstream is published

Dart-sys brand header

Dart-sys

Stars Forks Crates.io License: MIT License: Apache 2.0 Docs.rs CI

Rust bindings to the Dart ffi api

Prerequisites 🔧

You will need the following tools available on your system:

Unix/Linux 🐧

No additional requirements :)

MacOS 🍎

No additional requirements :)

Windows 🪟

On Windows platforms, dynamic libraries are linked against the executable, not into the executable as is the case o Unix platforms.

⚠️ Important ⚠️

This means that (on Windows) you will Need to have the Dart SDK installed and available on your system path to be able to compile Dart-sys.

Installing 📦

Run the following Cargo command in your project directory:

cargo add dart-sys

Or add the following line to your Cargo.toml:

dart-sys = "4.1.5"

Usage 💻

Examples 📚

An extremely straightforward example of using dart-sys would be like such:

use dart_sys::{Dart_Handle, Dart_NewIntegerFromI64};

#[no_mangle]
/// Adds two integers together.
pub extern "C" fn dart_sys_example_extension_sum(
    a: Dart_Handle,
    b: Dart_Handle,
) -> Dart_Handle {
    let a = unsafe { Dart_NewIntegerFromI64(a) };
    let b = unsafe { Dart_NewIntegerFromI64(b) };
    a + b
}

#[no_mangle]
/// Multiplies two integers together.
pub extern "C" fn dart_sys_example_extension_product(
    a: Dart_Handle,
    b: Dart_Handle,
) -> Dart_Handle {
    let a = unsafe { Dart_NewIntegerFromI64(a) };
    let b = unsafe { Dart_NewIntegerFromI64(b) };
    a * b
}
import 'dart:ffi';

// open and link to the native library
final DynamicLibrary nativeLib = DynamicLibrary.open('libdart_sys_example_extension.so');

// lookup the sum function in the native library
final int Function(int, int) sum = nativeLib
    .lookup<NativeFunction<Int32 Function(Int32, Int32)>>('dart_sys_example_extension_sum')
    .asFunction();

// lookup the product function in the native library
final int Function(int, int) product = nativeLib
    .lookup<NativeFunction<Int32 Function(Int32, Int32)>>('dart_sys_example_extension_product')
    .asFunction();

void main() {
    print(sum(1, 2)); // 3
    print(product(1, 2)); // 2
}

While this example is certainly possible, you are not likely to ever use Dart-sys for this purpose. See the examples directory for more in-depth examples of how to use Dart-sys. All examples are tested using GitHub Actions and documented verbosely.

Built With 🛠️

  • Rust - A systems programming language that runs blazingly fast, prevents segfaults, and guarantees thread safety.
  • Dart - A client-optimized language for fast apps on any platform.
  • Dart Native Extensions - A mechanism for writing native code in C/C++ and calling it from Dart.
  • bindgen - A Rust library for generating bindings to C and C++ APIs.

Contributing ✏️

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests. If you have any questions, please open an issue, or contact admin gutenfries@gmail.com directly.

Versioning 🪧

We use SemVer for versioning. For the versions available, see the tags on this repository.

License 📜

Dart-sys is open-sourced and released under the terms and conditions of one or both of the following licenses:

Acknowledgments 🙏

No runtime deps

~0–300KB