RDKit-Sys

Rust code that binds to the C++ rdkit library!

How does it work?

RDKit is a C++ mega-library, full of cheminformatics wisdom. We don't want to rewrite RDKit in Rust, we should instead meet somewhere in the middle and "bridge" Rust to C++ through some wrappers.

The goal is to do 1-1 bindings with the C++ library, exposing all the classes as we need them. The goal is not to create a high-level functionality like the MinimalLib (cffiwrapper). Our goal is to expose the building blocks. If you're looking for idiomatic Rust, check out the rdkit crate.

Static Linking

The build.rs script informs cargo how to find headers, library files, and finally how to link the final result. This crate currently links all RDKit libraries statically, meaning output binaries are portable and users of your software will not need to find their own RDKit.

Prerequisites

On Mac:

brew install rdkit

boost is a RDKit C++ dependency, cmake is how you create RDKit's Makefile, llvm is used by bind-gen to create the rust bindings.rs file with all the dylib definitions required to use RDKit from rust.

Testing

Or just run the test suite:

cargo test

TODO

Related Documentation

Prior art