detect_unused_code 2.1.2

A fast, zero-dependency Dart and Flutter dead code detector and remediation engine. Safely finds and cleans unused classes, imports, dead code, and TODOs.

example/example.dart

import 'package:detect_unused_code/detect_unused_code.dart';

void main() {
  // 1. Initialize auditor for the current project or a specific directory
  final auditor = UnusedCodeAuditor(
    options: const AuditorOptions(
      // targetPath: 'lib/features', // optional: limit scan scope
      includeInternal: true,
      commentThreshold: 60,
      minBlockLines: 15,
    ),
  );

  // 2. Run analysis with progress monitoring
  final report = auditor.run(
    onProgress: (percent, message) {
      print('[$percent%] $message');
    },
  );

  // 3. Inspect results
  print('\n--- Audit Summary ---');
  print('Target: ${report.targetPath}');
  print('Scanned files: ${report.totalTargetDartFiles}');
  print('Dead classes: ${report.deadClasses.length}');
  print('Internal-only classes: ${report.internalOnlyClasses.length}');
  print('Fully commented files: ${report.fullyCommentedFiles.length}');
  print('Files with dead blocks: ${report.filesWithCommentBlocks.length}');
  print('Pending TODOs: ${report.todos.length}');
  print('Unused imports: ${report.unusedImports.length}');
  print('Unused variables & fields: ${report.unusedVariablesAndFields.length}');
  print('Unused elements: ${report.unusedElements.length}');
  print('Dead code & null-aware: ${report.deadCodeAndExpressions.length}');

  for (final deadClass in report.deadClasses) {
    print(
        'Dead class: ${deadClass.name} at ${deadClass.relPath}:${deadClass.line}');
  }

  for (final todo in report.todos) {
    print('TODO at ${todo.file}:${todo.line} -> ${todo.message}');
  }
}