#line-count #line #count #code

bin+lib xloc

A fast, multi-threaded line counting utility written in Rust

4 releases

0.2.0 Nov 15, 2021
0.1.2 Nov 8, 2021
0.1.1 Nov 8, 2021
0.1.0 Nov 7, 2021

#435 in Concurrency

BSD-3-Clause

19KB
359 lines

xloc

A fast, multi-threaded line counting utility written in Rust.

What is xloc

  • Similar to bash's wc command, but can run concurrently.

  • Your project has x lines of code, xloc gets the value of x for you.

  • xloc is itended to be used from the command line. You can use it to count the number of lines/words in a file, or aggregate the total number of lines/words of all files in a directory.

  • While command line utility was the focus, a public API has also been made available to use in your own rust projects in the form of xloc::App.

  • By default xloc will ignore any directory named target or .git. This will likely be configurable at a later date.

Getting started

xloc supports Rust version 1.41.1 and greater.

For more information, read the API Reference.


Installation

From the command line

cargo install xloc

As a package dependency

# Cargo.toml
[dependencies]
xloc = "^0.2"

Usage

On the command line

# Count lines for all files in the current dir, with 1 job.
xloc .

# Count words for all files in the current dir with nproc jobs.
xloc -wj $(nproc) .

# Count words for 1 file, with 1 job.
xloc -w test.txt

# Count lines for all files in the src dir, with 6 jobs.
xloc -j 6 src

In a file

// main.rs
use xloc::App;

fn main() {
    // Create a mutable `App` using 1 job.
    let mut app = App::default();
    assert_eq!(app.get_njobs(), 1);

    // Set the number of jobs to 12.
    app.set_njobs(12);
    assert_eq!(app.get_njobs(), 12);

    // Recursively count lines in the current dir.
    match app.count(".") {
        Ok(count) => println!("{} lines", count),
        Err(e) => println!("Error: {}", e),
    }
}

License

The xloc crate for Rust is licensed under the BSD 3-Clause License.

Dependencies

~2.4–3.5MB
~59K SLoC