From 00f259c799cacc6ece47ce6948b1f0e40679de13 Mon Sep 17 00:00:00 2001 From: Changqing Wang Date: Tue, 12 Mar 2024 15:58:13 +1100 Subject: [PATCH] update README --- .github/workflows/rust.yml | 2 +- CHANGELOG.md | 4 ++++ README.md | 27 ++++++++++++++++++++++++++- 3 files changed, 31 insertions(+), 2 deletions(-) diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml index 42e21ea..ea26d3c 100644 --- a/.github/workflows/rust.yml +++ b/.github/workflows/rust.yml @@ -46,7 +46,7 @@ jobs: - uses: actions/checkout@v4 - uses: taiki-e/upload-rust-binary-action@v1 with: - bin: SeqSizzle + bin: seqsizzle target: ${{ matrix.target }} build-tool: ${{ matrix.build-tool }} # (optional) On which platform to distribute the `.tar.gz` file. diff --git a/CHANGELOG.md b/CHANGELOG.md index b7e0fe3..4974a85 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,10 @@ Notable changes to this project will be documented in this file. +## [0.1.4] + * renamed binary to `seqsizzle` to comply with Rust package naming conventions + * published `seqsizzle` on [crates.io](https://crates.io/crates/seqsizzle) + ## [0.1.3] * added summarize subcommand - to be moved to the UI interface later * better handling of polyA/T patterns diff --git a/README.md b/README.md index eaae6b1..3e9a752 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,30 @@ SeqSizzle is a pager for viewing FASTQ files with fuzzy matching, allowing different adaptors to be colored differently. -[Latest pre-built release binary](https://github.com/ChangqingW/SeqSizzle/releases/latest) + +# Installation + +### Pre-built binary + +[![Release](https://github.com/ChangqingW/SeqSizzle/actions/workflows/rust.yml/badge.svg?branch=master)](https://github.com/ChangqingW/SeqSizzle/actions/workflows/rust.yml) +You can simply download and run the binary from [Github Actions](https://github.com/ChangqingW/SeqSizzle/releases/latest). + +### Cargo (crates.io) + +![Crates.io](https://img.shields.io/crates/v/seqsizzle?link=https%3A%2F%2Fcrates.io%2Fcrates%2Fsizzle) +If you already have [a Rust environment set up](https://rustup.rs), you can use the `cargo install` command: +``` +cargo install seqsizzle +``` +Cargo will build the `seqsizzle` binary and place it in `$HOME/.local/share/cargo/bin/seqsizzle`. + +### Cargo (git) + +If you already have a Rust environment set up, you can use the `cargo install` command in your local clone of the repo: +``` +git clone https://github.com/ChangqingW/SeqSizzle +cd SeqSizzle +cargo install --path . +``` +Cargo will build the `seqsizzle` binary and place it in `$HOME/.cargo`. # Usage `./seqsizzle -h`: