unused-pub 0.1.3

A tool to detect unused public items (structs, enums, functions, etc.) in a Rust codebase.
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

use anyhow::Result;

use std::path::PathBuf;

pub mod analysis;
pub mod visitor;
pub mod walker;

pub struct Report {
    pub unused_items: Vec<UnusedItem>,
    pub count: usize,
}

pub struct UnusedItem {
    pub name: String,
    pub kind: String,
    pub location: String,
}

pub fn run(path: PathBuf, verbose: bool, filters: Vec<String>) -> Result<Report> {
    // 1. Walk the directory
    let files = walker::get_rust_files(&path)?;
    if verbose {
        println!("Found {} Rust files.", files.len());
    }

    // 2. Parse and Collect Definitions AND Usages (Parallelized later if needed)
    // For now, simpler sequential or simple parallel map

    let (definitions, usages) = analysis::analyze(files, verbose)?;

    // 3. Diff
    let unused_items = analysis::diff(definitions, usages, filters);

    Ok(Report {
        count: unused_items.len(),
        unused_items,
    })
}