Experimental FFI bindings of p2panda's Node API for Python, Go and Node.js.

Next to these bindings you'll find GObject bindings (GLib/GObject introspection) for p2panda in p2panda-gobject.

🚧 This library is under active development and the APIs are not yet considered stable for production use. Core data types and user-facing APIs may still undergo breaking changes. Stability guarantees will improve with the release of v1.0.0.

• We're using UniFFI. UniFFI is a tool that automatically generates foreign-language bindings targeting Rust libraries.
• Make sure you have Rust ready on your machine. We've tested this with v1.95.0.
• We're using proc macros to "scaffold" everything for UniFFI from Rust, so there's no need to create an additional UDL file.
• uniffi-bindgen is the UniFFI CLI tool we need to generate p2panda FFI bindings for various languages. This tool can be compiled from this project.

# First compile `uniffi-bindgen` and the p2panda library. The binary and library lands in the `target`
# folder. Don't forget to repeat this step whenever you change the Rust code.
make build

# From now on we can use the tool `uniffi-bindgen`.
cargo run --bin uniffi-bindgen --release

# The p2panda library is compiled as well and ready to be used for FFI into other languages (Python,
# Go, etc.). Follow the next steps below for generating FFI bindings for specific languages.
#
# Make sure the library is available by linking it into the right path:
ln -s ./target/release/libp2panda_ffi.so ./python/p2panda_ffi

# Generate FFI bindings for Python
make ffi-python

# Run example
python ./python/example.py

libp2panda is currently built for the x86_64-unknown-linux-musl target. Other targets can be added on request.

Make sure you have uniffi-bindgen-go installed in your Rust toolbelt.

See the examples in ./examples/go.

# Generate FFI bindings for Go
make ffi-go

# Run test bindings
./scripts/test-go-uniffi.sh

Make sure you have uniffi-bindgen-node-js installed in your Rust toolbelt.

# Generate FFI bindings for Node.js
make ffi-nodejs

# Re-build wrapper package if any changes done there
cd nodejs
npm run build

# Run example
node nodejs/example.js