|
4 | 4 | [![Crates.io][crates-badge]][crates-url]
|
5 | 5 | [![docs.rs][docs-badge]][docs-url]
|
6 | 6 | [![Rust][ci-badge]][ci-url]
|
7 |
| -![Stability][stability-badge] |
| 7 | +[![stable][stability-badge]][stability-url] |
8 | 8 | [![codecov][codecov-badge]][codecov-url]
|
9 | 9 |
|
10 | 10 | [license-badge]: https://img.shields.io/crates/l/slow5?style=flat-square
|
|
17 | 17 | [ci-url]: https://github.com/bsaintjo/slow5-rs/actions/workflows/rust.yml
|
18 | 18 | [codecov-badge]: https://codecov.io/gh/bsaintjo/slow5-rs/branch/main/graph/badge.svg?token=MODXRVRNQ0
|
19 | 19 | [codecov-url]: https://codecov.io/gh/bsaintjo/slow5-rs
|
20 |
| -[stability-badge]: https://img.shields.io/badge/stability-experimental-orange.svg |
| 20 | +[stability-badge]: http://badges.github.io/stability-badges/dist/stable.svg |
| 21 | +[stability-url]: https://github.com/badges/stability-badges |
| 22 | +A library for interacting with SLOW5/BLOW5 files in the Rust programming language. |
21 | 23 |
|
22 |
| -A library for interacting with SLOW5/BLOW5 files in rust. Not official. |
| 24 | +For more information check out the main [slow5lib repository](https://github.com/hasindu2008/slow5lib) or the [paper](https://doi.org/10.1038/s41587-021-01147-4). |
23 | 25 |
|
24 |
| -For more information checkout the main [slow5lib repository](https://github.com/hasindu2008/slow5lib). |
| 26 | +This repository provides two crates: |
25 | 27 |
|
26 |
| -*Note*: Library design is in flux and care should be taken in upgrading this crate. |
| 28 | +- `slow5lib-sys`: Bindings to the C library using `bindgen` |
| 29 | +- `slow5`: Rust API built on-top of `slow5lib-sys` |
| 30 | + |
| 31 | +The interface for `slow5` is largely stable and now updated primarily to follow new versions `slow5lib`. If there is additional functionality you'd like to see, please file a Github Issue. |
27 | 32 |
|
28 | 33 | ## Installation
|
29 | 34 |
|
@@ -94,16 +99,19 @@ For more example code, see the [test code](tests/full.rs). Several examples from
|
94 | 99 |
|
95 | 100 | ## Feature flags
|
96 | 101 |
|
97 |
| -* `zstd`: Enable zstd-based compression (enabled by default) |
98 |
| -* `zlib-ng`: Enable usage of high performance zlib-ng, adds `cmake` dependency |
99 |
| -* `serde`: Enable `serde` dependency (mainly for serializing `Record`) |
| 102 | +- `zstd`: Enable zstd-based compression |
| 103 | + - enabled by default |
| 104 | +- `zlib-ng`: Enable usage of high performance zlib-ng |
| 105 | + - adds `cmake` dependency |
| 106 | +- `serde`: Enable `serde` dependency |
| 107 | + - Mainly for serializing `Record` into `serde`-compatible formats |
100 | 108 |
|
101 | 109 | ## License
|
102 | 110 |
|
103 | 111 | Licensed under either of
|
104 | 112 |
|
105 |
| -* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>) |
106 |
| -* MIT license ([LICENSE-MIT](LICENSE-MIT) or <http://opensource.org/licenses/MIT>) |
| 113 | +- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>) |
| 114 | +- MIT license ([LICENSE-MIT](LICENSE-MIT) or <http://opensource.org/licenses/MIT>) |
107 | 115 |
|
108 | 116 | at your option.
|
109 | 117 |
|
|
0 commit comments