Lib.rs

🔎 Overview

alloy is a standalone Go module that enables calls to Rust code with Apache Arrow datatypes through its defined C data interface.

The overarching goal is to enable calls between languages through an underlying C interface, in this case utilizing cgo and the Rust ffi. This implementation comes with no overhead due to using the Apache Arrow data format.

The only data sent between the language binaries are raw pointers referencing the allocated memory and associated schemas. This allows for fast, (somewhat) robust, and colorful use cases in data engineering scenarios.

📦 Installation

To use the Go module, simply include it in your import with path name github.com/firelink-data/alloy/alloy-go. If you want to install any Go binary utilizing alloy, you need to enable cgo compilation by setting CGO_ENABLED=0.

To add the static Rust crate to your own Rust code, you can use the cargo package manager:

$ cargo add alloy-rs

🚀 Example usage

The example file examples/main.go should envision how your Go application could utilize alloy to call Rust code with Apache Arrow parameters.

package main

import (
    "fmt"
    "github.com/firelink-data/alloy/alloy-go"
)

func main() {
    fmt.Println("Hello from Go!");

    alloy.InitLogging();
    alloy.TestLogging("Hello Rust, sent from Golang!");

    ...

    fmt.Println("Goodbye from Go!");
}

📋 License

All code written by Firelink Data is to be held under a general MIT license, please see LICENSE for specific information.

Any other code included in this repository is to be held under its respective license(s).