4 releases
0.1.3 | Feb 4, 2024 |
---|---|
0.1.2 | Feb 3, 2024 |
0.1.1 | Jan 29, 2024 |
0.1.0 | Jan 27, 2024 |
#417 in Multimedia
31 downloads per month
Used in aprilasr
210KB
5.5K
SLoC
aprilasr-sys
Low-level FFI bindings for the april-asr C api (libaprilasr).
Overview
Compiles libaprilasr
from source to OUT_DIR
using CMake and generates bindings for April API, made available via vendored upstream source pointing at a specific commit sha as defined by the git submodule.
Requirements
Building requires the following system libraries:
- libonnxruntime
- libclang
Use locate
to search for installed libraries. For example, on Linux run command locate libonnxruntime.so
to determine if the ONNX Runtime is available.
Installation
To get the latest unyanked release published to crates.io:
cargo add aprilasr-sys
Or get the tip of the development branch via cargo using git:
cargo add --git https://codeberg.org/vhs/aprilasr-sys.git
It's also possible to vendor this crate:
mkdir crates && \
(cd crates; git submodule add https://codeberg.org/vhs/aprilasr-sys)
And once cloned updating dependent's Cargo.toml
manifest like:
[dependencies]
aprilasr-sys = { path = "crates/aprilasr-sys" }
Examples
For a basic usage example see examples/init.rs
and run command:
cargo run --example init
You should see output like:
April ASR api v1 initialized and ready for model.
Development
First clone vendored source:
git submodule update --init --recursive
To generate bindings run command:
cargo build [--release]
To specify include directory set env APRIL_INCLUDE_DIR
before running build.
To inspect bindings generated:
bat $(echo $(exa target/*/build/*/out/bindings.rs) | head -1)
Command requires bat
and exa
rust binaries and displays output with syntax highlighting.
Versioning
Consider using chrono
to parse the date format unless april-asr adopts semantic versioning:
let date_str = "2023.05.12";
let native_date = chrono::NaiveDate::parse_from_str(date_str, "%Y.%m.%d");
p!("{:?}", native_date);
Here p!
is a debug helper in build.rs
and date_str
represents the VERSION
in vendor/april-asr/CMakeLists.txt
file. With some additional work cmake-parser looks well-suited for parsing the file to get the version.
Date-based versioning is not currently implemented in the build.rs
build script. Once versioning is implemented it would also ideal to use it as an input to pkg-config to scan the system for the library.
See Making a *-sys crate for other possible enhancements.
Vendoring
Because we are vendoring April ASR source using a git submodule we have the ability to update the submodule to generate new bindings when the upstream source code changes.
To view the current commit of the april-asr
submodule:
git submodule status | awk '{print substr($1, 1, 7)}'
To update the submodule to the latest commit in the main
branch of the submodule:
git submodule update --remote --recursive --merge
This command fetches the latest commits from the submodule's remote repository, checks out the commit referenced by the main
branch, and updates the submodule in the main repository.
Releasing
Steps to package a release of this crate for crates.io:
- Update git submodule as described in Vendoring.
- Run
cargo clean
to remove existing build artifacts. - Run
cargo build --release
to update generated bindings. - Inspect bindings as described in Development.
- Run
cargo test
to execute unit tests including bindgen. - Run
cargo run --example init
to check example. - Run
cargo doc
to generate crate docs and review them. - Bump the package version in
Cargo.toml
manifest. - Run
cargo publish --dry-run
to review your work. - Then
cargo login
andcargo publish
to publish crate.
Once published visit docs.rs to review crate documentation.
Dependencies
~0–2.1MB
~42K SLoC