Crate ella

Getting Started

ella requires a few additional setup steps after adding it as a dependency.

ella depends on the currently unstable UUIDv7 specification. You will need to add --cfg uuid_unstable to your RUSTFLAGS. The easiest way to do this is to update (or create) your .cargo/config.toml to include

[build]
rustflags = ["--cfg", "uuid_unstable"]

For your crate to build on platforms like doc.rs you’ll also need to add the following to your Cargo.toml file:

[package.metadata.docs.rs]
rustc-args = ["--cfg", "uuid_unstable"]
rustdoc-args = ["--cfg", "uuid_unstable"]

Usage

You can access ella by either starting a new instance or connecting to an existing instance.

Start a new instance by opening or creating a datastore:

let el = ella::open("file:///path/to/db")
    .or_create(ella::Config::default())
    .and_serve("localhost:50052")?
    .await?;

Connect to an existing instance using ella::connect:

let el = ella::connect("http://localhost:50052").await?;

Re-exports

• pub use table::Table;
• pub use ella_common as common;
• pub use ella_engine as engine;
• pub use ella_server as server;

Modules

• shape
• table
• tensor
• time

Macros

• row

Structs

• Config
• ConfigBuilder
• Ella
• Path
• Row
• Time

Enums

• Error
• TensorType

Functions

• connect
  Connect to an ella API server at addr.
• create
  Create a new datastore at root.
• now
• open
  Open the datastore at root, if one exists.

Type Definitions

• Result

Derive Macros

• RowFormat