Skip to content

Commit

Permalink
Change links in Cargo.toml to tskit-dev (#127)
Browse files Browse the repository at this point in the history
Change LICENSE from Kevin Thornton to Tskit Developers.

Change authors to tskit developers.

update README.md
  • Loading branch information
molpopgen authored May 19, 2021
1 parent d1b9f12 commit d9abda5
Show file tree
Hide file tree
Showing 3 changed files with 34 additions and 12 deletions.
6 changes: 3 additions & 3 deletions Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
[package]
name = "tskit"
version = "0.3.0"
authors = ["molpopgen <krthornt@uci.edu>"]
authors = ["tskit developers <admin@tskit.dev>"]
build = "build.rs"
edition = "2018"
description = "rust interface to tskit"
license = "MIT"
homepage = "/~https://github.com/molpopgen/tskit-rust"
repository = "/~https://github.com/molpopgen/tskit-rust"
homepage = "/~https://github.com/tskit-dev/tskit-rust"
repository = "/~https://github.com/tskit-dev/tskit-rust"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

Expand Down
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
MIT License

Copyright (c) 2020-2021 Kevin Thornton
Copyright (c) 2020-2021 Tskit Developers

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
38 changes: 30 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ This package provides the following:

The overview is:

1. `tskit` and `kastore` source from `tskit 0.3.5` are include in `subprojects/`
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.
Expand All @@ -26,20 +26,42 @@ Help wanted!

## Quick start guide

### Cloning the repository and running the test suite

```sh
git clone /~https://github.com/molpopgen/tskit_rust
cd tskit_rust
cargo build
cargo test
git clone /~https://github.com/tskit-dev/tskit-rust
cd tskit-rust
cargo test --all-features
```

Then, to look at the docs:
### Viewing the documentation

```
cargo doc --open
cargo doc --all-features --open
```

### Calculating code coverage

First, install `tarpaulin`:

```sh
cargo install cargo-tarpaulin
```

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

```sh
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](/~https://github.com/tskit-dev/tskit) 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](/~https://github.com/molpopgen/tskit_rust/blob/main/CHANGELOG.md).
See [here](/~https://github.com/tskit-dev/tskit-rust/blob/main/CHANGELOG.md).

0 comments on commit d9abda5

Please sign in to comment.