Skip to content

Commit d9abda5

Browse files
authored
Change links in Cargo.toml to tskit-dev (#127)
Change LICENSE from Kevin Thornton to Tskit Developers. Change authors to tskit developers. update README.md
1 parent d1b9f12 commit d9abda5

File tree

3 files changed

+34
-12
lines changed

3 files changed

+34
-12
lines changed

Cargo.toml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
[package]
22
name = "tskit"
33
version = "0.3.0"
4-
authors = ["molpopgen <krthornt@uci.edu>"]
4+
authors = ["tskit developers <admin@tskit.dev>"]
55
build = "build.rs"
66
edition = "2018"
77
description = "rust interface to tskit"
88
license = "MIT"
9-
homepage = "https://github.com/molpopgen/tskit-rust"
10-
repository = "https://github.com/molpopgen/tskit-rust"
9+
homepage = "https://github.com/tskit-dev/tskit-rust"
10+
repository = "https://github.com/tskit-dev/tskit-rust"
1111

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

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2020-2021 Kevin Thornton
3+
Copyright (c) 2020-2021 Tskit Developers
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 30 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ This package provides the following:
1414

1515
The overview is:
1616

17-
1. `tskit` and `kastore` source from `tskit 0.3.5` are include in `subprojects/`
17+
1. `tskit` and `kastore` C code are include in `subprojects/`
1818
2. These two tools are compiled into the `rust` package.
1919
3. Then `bindgen` generates the bindings.
2020
4. Finally, the entire rust package is generated.
@@ -26,20 +26,42 @@ Help wanted!
2626

2727
## Quick start guide
2828

29+
### Cloning the repository and running the test suite
30+
2931
```sh
30-
git clone https://github.com/molpopgen/tskit_rust
31-
cd tskit_rust
32-
cargo build
33-
cargo test
32+
git clone https://github.com/tskit-dev/tskit-rust
33+
cd tskit-rust
34+
cargo test --all-features
3435
```
3536

36-
Then, to look at the docs:
37+
### Viewing the documentation
3738

3839
```
39-
cargo doc --open
40+
cargo doc --all-features --open
4041
```
4142

43+
### Calculating code coverage
44+
45+
First, install `tarpaulin`:
46+
47+
```sh
48+
cargo install cargo-tarpaulin
49+
```
50+
51+
Then, we use all tests, doc tests, and example programs to calculate code coverage for all available features:
52+
53+
```sh
54+
cargo tarpaulin --all-features --doc --tests --examples --exclude-files '*.c' --exclude-files '*.h' --ignore-tests -o html
55+
```
56+
57+
Then, point your favorite browser to `tarpaulin-report.html`.
58+
59+
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.
60+
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.
61+
62+
**Note:** `tarpaulin` can be fickle, and changing the order of some of those flags can cause the coverage run to fail.
63+
4264
## Change log
4365

44-
See [here](https://github.com/molpopgen/tskit_rust/blob/main/CHANGELOG.md).
66+
See [here](https://github.com/tskit-dev/tskit-rust/blob/main/CHANGELOG.md).
4567

0 commit comments

Comments
 (0)