Skip to content
art-dupl

Output Formats

Format Overview

Section titled “Format Overview”
Format Flag Use case
Text (default) Quick terminal review
Rich text --rich-text Priority badges and refactoring suggestions
HTML --html Detailed report with syntax highlighting and diffs
JSON --json / -j CI/CD integration with metadata and summary
Simple JSON --simple-json Lightweight JSON with impact scores
SARIF --sarif GitHub Advanced Security / CodeQL integration
Plumbing --plumbing / -p Machine-readable file:startLine-endLine for scripts

Text (Default)

Section titled “Text (Default)”
Terminal window
art-dupl

Human-readable clone listing with file paths, line numbers, and diff hints.

Rich Text

Section titled “Rich Text”
Terminal window
art-dupl --rich-text

Enhanced text output with:

  • Priority badges (critical, high, medium, low)
  • Clone type labels (Type 1 / 2 / 3)
  • Actionability verdicts
  • Refactoring suggestions

HTML

Section titled “HTML”
Terminal window
art-dupl --html > report.html
art-dupl --html --diff side-by-side > report.html
art-dupl --html --diff inline > report.html

Dark-themed HTML report with:

  • Syntax highlighting
  • Side-by-side or inline diff visualization (LCS algorithm)
  • VSCode links for direct navigation
  • Clone group summaries

JSON

Section titled “JSON”
Terminal window
art-dupl --json -t 10

Structured JSON with version, timestamp, clone_groups array, and summary statistics. Includes:

  • Clone type classification
  • Extractability scores (lines_saved, extractable)
  • Actionability verdicts
  • Token counts and severity

Simple JSON

Section titled “Simple JSON”
Terminal window
art-dupl --simple-json

Lightweight JSON format with score (impact) and instances with token_count. Easier to consume for simple integrations.

SARIF

Section titled “SARIF”
Terminal window
art-dupl --sarif > results.sarif

SARIF 2.1.0 format for GitHub Advanced Security. Upload via:

- uses: github/codeql-action/upload-sarif@v3
  with:
    sarif_file: results.sarif

Clones appear as results in the GitHub Security tab.

Plumbing

Section titled “Plumbing”
Terminal window
art-dupl --plumbing

Machine-readable format: file:startLine-endLine. Ideal for scripts, editor integrations, and piping to other tools.

Terminal window
# Count duplicate files
art-dupl --plumbing | cut -d: -f1 | sort -u | wc -l

All Formats

Section titled “All Formats”
Terminal window
art-dupl --all --output-dir ./reports

Generate all output formats to a directory at once.

Sorting

Section titled “Sorting”

Control sort order with -s / --sort:

Option Description
size (default) Largest clone groups first
occurrence Most widespread (most files) first
hash Alphabetical by hash value
total-tokens Highest total token count first