11 unstable releases

0.6.1 Oct 2, 2022
0.6.0 Jul 24, 2021
0.5.0 Oct 6, 2020
0.4.0 May 9, 2020
0.1.0 Jun 29, 2019

#78 in Biology

Download history 6/week @ 2023-12-15 2/week @ 2023-12-22 3/week @ 2024-01-05 2/week @ 2024-01-19 34/week @ 2024-02-16 28/week @ 2024-02-23 30/week @ 2024-03-01 49/week @ 2024-03-08 84/week @ 2024-03-15 52/week @ 2024-03-22 47/week @ 2024-03-29

237 downloads per month
Used in vcf_add_ids

Apache-2.0

96KB
2.5K SLoC

vcf-rs

Build Crates.io doc-rs GitHub GitHub top language

Rust implementation of VCF parser.

License

Apache 2.0

Example

use vcf::*;
use flate2::read::MultiGzDecoder;
use std::fs::File;

fn usage_test() -> Result<(), VCFError> {
    let mut reader = VCFReader::new(BufReader::new(MultiGzDecoder::new(File::open(
        "./testfiles/NA12878-subset.vcf.gz",
    )?)))?;

    // access FILTER contents
    assert_eq!(
        Some(VCFHeaderFilterAlt {
            id: b"PASS",
            description: b"All filters passed"
        }),
        reader.header().filter(b"PASS")
    );

    // access INFO contents
    assert_eq!(
        b"Stop position of the interval",
        reader.header().info(b"END").unwrap().description
    );

    // prepare VCFRecord object
    let mut vcf_record = VCFRecord::new(reader.header());

    // read one record
    reader.next_record(&mut vcf_record)?;

    // get record attributes
    assert_eq!(vcf_record.chromosome, b"13");
    assert_eq!(vcf_record.position, 32889968);
    assert_eq!(vcf_record.id, Vec::<U8Vec>::new());
    assert_eq!(vcf_record.reference, b"G");
    assert_eq!(vcf_record.alternative, vec![b"A"]);
    assert_eq!(vcf_record.qual, Some(25743.5));
    assert_eq!(vcf_record.info(b"AC"), Some(&vec![b"54".to_vec()]));
    assert_eq!(
        vcf_record.genotype(b"ERP001775_HiSeq2000_SAMEA1531955-1", b"GT"),
        Some(&vec![b"1/1".to_vec()])
    );
    assert_eq!(
        vcf_record.genotype(b"ERP001775_HiSeq2000_SAMEA1531955-1", b"AD"),
        Some(&vec![b"0".to_vec(), b"14".to_vec()])
    );

    Ok(())
}

Dependencies

~1.1–1.8MB
~36K SLoC