paraseq 0.4.10

A minimal-copy parser for FASTA and FASTQ files built for paired parallel processing.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

use std::sync::Arc;

use anyhow::Result;
use clap::Parser;
use paraseq::{fastx, prelude::*, ProcessError, MAX_ARITY};
use parking_lot::Mutex;

#[derive(Default, Clone)]
pub struct SeqSum {
    /// Thread local sum of bytes in the sequence
    pub byte_sum: u64,
    /// Thread local number of records
    pub num_records: u64,

    /// Global sum of bytes in the sequence
    pub global_byte_sum: Arc<Mutex<u64>>,
    /// Global number of records
    pub global_num_records: Arc<Mutex<u64>>,
}
impl SeqSum {
    #[must_use]
    pub fn get_num_records(&self) -> u64 {
        *self.global_num_records.lock()
    }
    #[must_use]
    pub fn get_byte_sum(&self) -> u64 {
        *self.global_byte_sum.lock()
    }
    pub fn pprint(&self) {
        println!("Total records: {}", self.get_num_records());
        println!("Total bytes: {}", self.get_byte_sum());
    }
}
impl<Rf: Record> MultiParallelProcessor<Rf> for SeqSum {
    fn process_multi_record(&mut self, records: &[Rf]) -> Result<(), ProcessError> {
        for _ in 0..100 {
            for rec in records.iter() {
                // Simulate some work
                rec.seq()
                    .iter()
                    .for_each(|b| self.byte_sum += u64::from(*b));
            }
        }
        self.num_records += 1;
        Ok(())
    }
    fn on_batch_complete(&mut self) -> Result<(), ProcessError> {
        *self.global_byte_sum.lock() += self.byte_sum;
        *self.global_num_records.lock() += self.num_records;
        self.byte_sum = 0;
        self.num_records = 0;
        Ok(())
    }
}

#[derive(Parser)]
pub struct Args {
    /// Input files to process (multiple paired fasta/fastq)
    ///
    /// Must provide at least two files.
    ///
    /// *must all be same format*
    #[clap(num_args = 2..MAX_ARITY, required = true)]
    pub input_fastx: Vec<String>,

    #[clap(short = 'T', long, default_value_t = 1)]
    pub threads: usize,
}

fn main() -> Result<()> {
    let args = Args::parse();
    let mut readers = args
        .input_fastx
        .iter()
        .map(|path| -> Result<_> {
            let reader = fastx::Reader::from_path(path)?;
            Ok(reader)
        })
        .collect::<Result<Vec<_>>>()?;

    let mut processor = SeqSum::default();
    let reader = readers.remove(0);
    reader.process_parallel_multi(readers, &mut processor, args.threads)?;
    processor.pprint();
    Ok(())
}