cargo-echoes

Whoa, deja vu. A doctest went past us, and then another that looked just like it.

cargo echoes finds duplicated Rust doctests, and optionally duplicated functions and code blocks, across a workspace or across every crate of a GitHub organization. The wiki explains each check, the options and the Action in depth.

Usage

cargo install echoes
cargo echoes --functions --context-blocks
cargo echoes --organization --functions

Options can also live in .echoes.toml at the workspace root, and cargo echoes --help lists them all. Keep an intentional copy with a rust,echoes fence or a // echoes: allow line above the function. The wiki lists what counts as the same code.

--organization scans the default branch of every repository of a GitHub organization or user that the GH_TOKEN or GITHUB_TOKEN credential can read, private ones included, and compares functions across crates and modules. Without a name it scans the owner of the current repository, from GITHUB_REPOSITORY_OWNER or the origin remote. Downloaded repositories never configure the scan or run code, so pass --config for options, and the exit status is 2 whenever a repository could not be analyzed, even with --no-fail.

GitHub Action

on: pull_request
jobs:
  echoes:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - uses: LucaCappelletti94/cargo-echoes@v1
        with:
          pr-number: ${{ github.event.pull_request.number }}
          functions: true

The action reviews the pull request and suggests removing each copy it introduces. action.yml lists every input, and these two workflows review pull requests from forks.

Library

let report = echoes::Echoes::default()
    .functions()
    .context_blocks()
    .run(".")
    .unwrap();
println!("{}", echoes::human(&report, false));

Use default-features = false, features = ["std"] to drop the CLI. Coding agents get the same guidance from the echoes skill.

npx skills add LucaCappelletti94/cargo-echoes