30 releases (6 breaking)

new 0.11.2 Nov 11, 2024
0.7.1 Oct 10, 2024
0.6.6 Jul 10, 2024
0.5.1 Feb 6, 2024
0.1.0 Jul 29, 2021

#40 in #statically-typed

Download history 933/week @ 2024-07-29 1508/week @ 2024-08-05 1234/week @ 2024-08-12 1334/week @ 2024-08-19 1259/week @ 2024-08-26 2140/week @ 2024-09-02 1472/week @ 2024-09-09 1515/week @ 2024-09-16 802/week @ 2024-09-23 1269/week @ 2024-09-30 1593/week @ 2024-10-07 999/week @ 2024-10-14 1053/week @ 2024-10-21 1096/week @ 2024-10-28 1193/week @ 2024-11-04 1188/week @ 2024-11-11

4,550 downloads per month
Used in narrow

Apache-2.0 OR MIT

110KB
2K SLoC

Narrow logo

crates.io docs.rs

An experimental (work-in-progress) statically typed implementation of Apache Arrow.

This crate provides methods to automatically generate types to support reading and writing instances of abstract data types in Arrow's in-memory data structures.

Why

  • The arrow crate provides APIs that make sense when the array types are only known at run-time. Many of its APIs require the use of trait objects and downcasting. However, for applications where types are known at compile-time, these APIs are not ergonomic.
  • Builders for nested array types are complex and error-prone.

There are other crates that aim to prevent users from having to maintain array builder code by providing derive macros. These builders typically produce type-erased arrays, whereas this crate only provides fully statically typed arrays.

Goals and non-goals

Goals

  • Provide production ready, fully statically typed, safe and efficient Arrow array implementations
  • Enable everyone using Rust to easily benefit from the Arrow ecosystem
  • Provide zero-copy interop with the arrow crate
  • Support custom buffer implementations e.g. to support accelerators
  • Explore expressing Arrow concepts using the Rust type system, and mapping Rust concepts to Arrow

Non-goals

  • Support arbitrary array types at runtime (the arrow crate supports this use case)
  • Provide compute kernels
  • Replace other Arrow implementations

Example

use narrow::{
    array::{StructArray, UnionArray},
    ArrayType, Length,
};

#[derive(ArrayType, Default, Clone, Debug, PartialEq, Eq)]
struct Foo {
    a: bool,
    b: u32,
    c: Option<String>,
}

#[derive(ArrayType, Default, Clone, Debug, PartialEq, Eq)]
struct Bar(Vec<u8>);

#[derive(ArrayType, Clone, Debug, PartialEq, Eq)]
enum FooBar {
    Foo(Foo),
    Bar(Bar),
    None,
}

let foos = vec![
    Foo {
        a: false,
        b: 0,
        c: None,
    },
    Foo {
        a: true,
        b: 42,
        c: Some("hello world".to_owned()),
    },
];
let struct_array = foos.clone().into_iter().collect::<StructArray<Foo>>();
assert_eq!(struct_array.len(), 2);
assert_eq!(struct_array.into_iter().collect::<Vec<_>>(), foos);

let foo_bars = vec![
    FooBar::Foo(Foo {
        a: true,
        b: 42,
        c: Some("hello world".to_owned()),
    }),
    FooBar::Bar(Bar(vec![1, 2, 3, 4])),
    FooBar::None,
    FooBar::None,
];
let union_array = foo_bars
    .clone()
    .into_iter()
    .collect::<UnionArray<FooBar, 3>>();
assert_eq!(union_array.len(), 4);
assert_eq!(union_array.into_iter().collect::<Vec<_>>(), foo_bars);

Features

The crate supports the following optional features:

  • derive: adds ArrayType derive support.
  • arrow-rs: adds array conversion methods for arrow.
  • uuid: adds ArrayType support for uuid::Uuid.

Docs

Minimum supported Rust version

The minimum supported Rust version for this crate is Rust 1.79.0.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~1.3–2MB
~40K SLoC