tskit

Crates.iotskit
lib.rstskit
version0.15.0-alpha.0
sourcesrc
created_at2021-01-05 01:22:40.012855
updated_at2024-05-07 23:05:47.59116
descriptionrust interface to tskit
homepagehttps://github.com/tskit-dev/tskit-rust
repositoryhttps://github.com/tskit-dev/tskit-rust
max_upload_size
id331866
size1,675,717
Kevin R. Thornton (molpopgen)

documentation

README

rust bindings for tskit

CI tests

This crate provides rust bindings to tskit.

This package provides the following:

  1. Low-level bindings to the C API of both tskit and kastore. We use bindgen to automatically generate the bindings.
  2. Support for table collections, tree sequences, and tree iteration.
  3. An error handling system that maps tskit error codes to rust errors while preserving error messages.

The overview is:

  1. tskit and kastore C code are include in subprojects/
  2. These two tools are compiled into the rust package.
  3. Then bindgen generates the bindings.
  4. Finally, the entire rust package is generated.

The result is a rust library with all of these two C libraries statically compiled in. Further, rust types and functions exist in the module name tskit::bindings, allowing unsafe access to the low-level API.

Help wanted!

Quick start guide

Cloning the repository and running the test suite

git clone https://github.com/tskit-dev/tskit-rust
cd tskit-rust
cargo test --all-features

Viewing the documentation

cargo doc --all-features --open

Calculating code coverage

First, install tarpaulin:

cargo install cargo-tarpaulin

Then, we use all tests, doc tests, and example programs to calculate code coverage for all available features:

cargo tarpaulin --all-features --doc --tests --examples --exclude-files '*.c' --exclude-files '*.h' --ignore-tests  -o html

Then, point your favorite browser to tarpaulin-report.html.

The last few flags exclude the C code and any rust code that is test-only from being part of the denominator of the coverage calculation. The goal here is not to have high test coverage of the C API, as it is up to the upstream project to provide that.

Note: tarpaulin can be fickle, and changing the order of some of those flags can cause the coverage run to fail.

Change log

See here.

Updating the change log.

under scrutinty

Example:

git cliff -u --tag v0.11.0 --date-order -p CHANGELOG.md
Commit count: 536

cargo fmt