Skip to content

rustyconover/libh3-sys

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
src
 
 
 
 
 
 
 
 
 
 

libh3-sys - Wrapper for Uber’s Hexagonal Hierarchical Spatial Index in Rust

This crate provides unsafe Rust functions that call the underlying H3 library.

An interface to H3 using safe Rust is provided by libh3.

Contributions are welcome.

See the documentation here:

https://docs.rs/libh3-sys/

Example build.rs

Assume you have vendored the H3 project into your crate's source tree at deps/h3. You can now write a build.rs script which will statically build and link the external dependency into your own crate, thus removing any dependency on any system installation of H3.

use cmake::Config;

fn main() {
    let build_type = if cfg!(debug_assertions) {
        "Debug"
    } else {
        "Release"
    };

    let dst = Config::new("deps/h3")
        .define("BUILD_TESTING", "OFF")
        .define("BUILD_GENERATORS", "OFF")
        .define("BUILD_BENCHMARKS", "OFF")
        .define("BUILD_FILTERS", "OFF")
        .define("ENABLE_LINTING", "OFF")
        .define("ENABLE_DOCS", "OFF")
        .define("ENABLE_COVERAGE", "OFF")
        .define("BUILD_TYPE", build_type)
        .build();
    println!("cargo:rustc-link-search=native={}/lib", dst.display());
    println!("cargo:cargo:include={}/include", dst.display());
    println!("cargo:rustc-link-lib=static=h3");
}

And add this to the build-dependencies section of your Cargo.toml:

[build-dependencies]
cmake = "0.1"

About

Rust bindings for Uber's Hexagonal Hierarchical Spatial Index - H3

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published