Skip to main content

alef/
lib.rs

1//! # alef
2//!
3//! Name reservation for the [alef][] polyglot binding generator.
4//!
5//! **You probably want one of these instead:**
6//!
7//! - `alef-cli` — the CLI binary. Install with `cargo install alef-cli`.
8//! - `alef-codegen` — the codegen library.
9//! - `alef-backend-*` — language backends (PyO3, NAPI, Magnus, JNI, etc.).
10//!
11//! Calling any item from this crate panics with a guidance message; this crate
12//! exists only to prevent name squatting on crates.io.
13//!
14//! [alef]: https://github.com/kreuzberg-dev/alef
15
16#![deny(missing_docs)]
17
18/// Panics with a guidance message pointing at the real crates.
19#[track_caller]
20pub fn not_available() -> ! {
21    panic!(
22        "The `alef` crate is a name reservation only. \
23         Install the CLI with `cargo install alef-cli`, or depend on \
24         `alef-codegen` / `alef-backend-*` for libraries. \
25         See https://github.com/kreuzberg-dev/alef."
26    );
27}