#data #shared #safe #helper #marshalling #buffer #major

cobhan

Cobhan FFI is a system for enabling shared code to be written in Rust and consumed from all major languages/platforms in a safe and effective way, using easy helper functions to manage any unsafe data marshaling

2 releases

0.1.1 Nov 4, 2022
0.1.0 Mar 3, 2022

#2745 in Rust patterns

Download history 30/week @ 2024-01-07 37/week @ 2024-01-14 39/week @ 2024-01-21 90/week @ 2024-01-28 31/week @ 2024-02-04 19/week @ 2024-02-18 11/week @ 2024-02-25 1/week @ 2024-03-03 21/week @ 2024-03-10

52 downloads per month

Custom license

17KB
216 lines

cobhan-rust - FFI Data Interface

Cobhan FFI is a system for enabling shared code to be written in Rust and consumed from all major languages/platforms in a safe and effective way, using easy helper functions to manage any unsafe data marshaling.

Types

  • Supported types
    • i32 - 32bit signed integer
    • i64 - 64bit signed integer
    • f64 - double precision 64bit IEEE 754 floating point
    • Cobhan buffer - length delimited 8bit buffer (no null delimiters)
      • utf-8 encoded string
      • JSON
      • binary data
  • Cobhan buffer details
    • Callers provide the output buffer allocation and capacity
    • Called functions can transparently return larger values via temporary files
    • Modern tmpfs is entirely memory backed
  • Return values
    • Functions that return scalar values can return the value directly
      • Functions can use special case and return maximum positive or maximum negative or zero values to represent error or overflow conditions
      • Functions can allow scalar values to wrap
      • Functions should document their overflow / underflow behavior

Dependencies

~2–12MB
~135K SLoC