#cargo #source #find #cli #output

app cargo-files

List all source files in a cargo crate

4 releases (2 breaking)

0.3.0 Mar 27, 2024
0.2.1 Feb 13, 2024
0.2.0 Mar 11, 2023
0.1.0 Mar 11, 2023

#125 in Cargo plugins

Download history 28/week @ 2024-02-12 18/week @ 2024-02-19 23/week @ 2024-02-26 14/week @ 2024-03-11 91/week @ 2024-03-25 27/week @ 2024-04-01

132 downloads per month

MIT/Apache

23KB
379 lines

cargo-files

Latest version crates.io downloads Build Status Apache/MIT2.0 License

A tool to list all source files in a cargo crate.

Motivation

While I was writing cargo-derivefmt I found myself wishing for a simple way to get the source files in a cargo crate. I wasn't able to find an existing crate which did this, so I wrote this one.

This library is still a work-in-progress. There are likely many issues and unsupported situations.

CLI

For end users, we provide a CLI which lists all source files in a crate.

Installation

cargo install (crates.io)

cargo install cargo-files --locked

cargo install (master)

cargo install --git https://github.com/dcchut/cargo-files --locked

Usage

cargo files

Sample output

> cargo files
/home/dcchut/cargo-files/cargo-files/src/main.rs
/home/dcchut/cargo-files/cargo-files-core/src/lib.rs
/home/dcchut/cargo-files/cargo-files-core/src/parser.rs
/home/dcchut/cargo-files/cargo-files-core/tests/tests.rs
/home/dcchut/cargo-files/cargo-files-test/src/lib.rs

Developers

The cargo-files-core crate contains the logic underlying cargo-files, and can be reused by other applications that care about source files. At the moment the API is extremely simplistic, but any improvement suggestions are welcome!

Minimal example

use cargo_files_core::{get_targets, get_target_files, Error};

fn main() -> Result<(), Error> {
    // Each target (e.g. bin/lib) in your workspace will contribute a target.
    let targets = get_targets(None)?;
    for target in targets {
        // Get all the files related to a specific target.
        let files = get_target_files(&target)?;
        for file in files {
            println!("{}", file.display());
        }
    }
    
    Ok(())
}

Dependencies

~1.9–2.7MB
~53K SLoC