chainfile

A crate for working with genomics chain files.
Explore the docs »

Request Feature · Report Bug · ⭐ Consider starring the repo! ⭐

Guiding Principles

This crate is written in the style of noodles, as it was originally intended to be included as a pull request. After discussion with the maintainer of noodles, we decided this should be its own, complimentary crate.

📚 Getting Started

To include this crate in your project, simply use the following command.

cargo add chainfile

You can take a look at the examples to get a sense of how to use the crate.

🖥️ Development

To bootstrap a development environment, please use the following commands.

# Clone the repository
git clone git@github.com:stjude-rust-labs/chainfile.git
cd chainfile

# Build the crate in release mode
cargo build --release

# List out the examples
cargo run --release --example

🚧️ Tests

Before submitting any pull requests, please make sure the code passes the following checks.

# Run the project's tests.
cargo test --all-features

# Ensure the project doesn't have any linting warnings.
cargo clippy --all-features

# Ensure the project passes `cargo fmt`.
cargo fmt --check

Minumum Supported Rust Version (MSRV)

This crate is designed to work with Rust version 1.72.0 or later. It may, by happenstance, work with earlier versions of Rust.

🤝 Contributing

Contributions, issues and feature requests are welcome! Feel free to check issues page.

📝 License

This project is licensed as either Apache 2.0 or MIT at your discretion. Additionally, please see the disclaimer that applies to all crates and command line tools made available by St. Jude Rust Labs.

Copyright © 2023-Present St. Jude Children's Research Hospital.