feat: add check unused code command

[incendial]

What is the purpose of this pull request? (put an "X" next to an item)

[ ] Documentation update
[ ] Bug fix
[ ] New rule
[ ] Changes an existing rule
[ ] Add autofixing to a rule
[ ] Add a CLI option
[ ] Add something to the core
[X] Other, please explain: new command

What changes did you make? (Give an overview)

This implementation is a first iteration of unused code check, it checks for top level declarations usage, such as:

• top level variables
• top level functions
• enums
• classes
• mixins
• extensions
• type aliases (a.k.a. typedefs)

In the next iterations we should add checks for specific class method / properties / getters usage, but this command already brings a lot of value to our users, so let's not block the release on this.

[incendial]

@diegoveloper @lukepighetti hope it's the command you were looking for. Do you want to "beta-test" it?

[diegoveloper]

@diegoveloper @lukepighetti hope it's the command you were looking for. Do you want to "beta-test" it?

Ohh nice!! We'll try the next week

[github-actions]

Dart Code Metrics unused files report of dart_code_metrics. ✅

Summary

• Scanned package folders: bin, example, lib
• No unused files found! ✅

[github-actions]

Dart Code Metrics analyze report of dart_code_metrics. ✅

Summary

• Scanned folders: bin, example, lib, test

• Total scanned files: 375

• Total lines of source code: 6739

• Total classes: 251

• Average Cyclomatic Number per line of code: 0.35 / 1

• Average Source Lines of Code per method: 6

• Total tech debt: 1094.0 hours

• Found issues: 6 ⚠

[codecov]

Codecov Report

Merging #649 (e655d1e) into master (26ca53e) will decrease coverage by 0.16%.
The diff coverage is 83.80%.

❗ Current head e655d1e differs from pull request most recent head 756ffe8. Consider uploading reports for the commit 756ffe8 to get more accurate results

@@            Coverage Diff             @@
##           master     #649      +/-   ##
==========================================
- Coverage   86.17%   86.01%   -0.17%     
==========================================
  Files         235      247      +12     
  Lines        5049     5319     +270     
==========================================
+ Hits         4351     4575     +224     
- Misses        698      744      +46     

Impacted Files	Coverage Δ
...ib/src/cli/commands/check_unused_code_command.dart	55.88% <55.88%> (ø)
...lyzers/unused_code_analyzer/used_code_visitor.dart	63.88% <63.88%> (ø)
lib/src/config_builder/config_builder.dart	82.60% <75.00%> (-1.61%)	⬇️
...yzers/unused_code_analyzer/unused_code_config.dart	80.00% <80.00%> (ø)
...ers/unused_code_analyzer/unused_code_analyzer.dart	98.71% <98.71%> (ø)
.../src/analyzers/lint_analyzer/rules/rule_utils.dart	100.00% <100.00%> (ø)
...used_code_analyzer/models/file_elements_usage.dart	100.00% <100.00%> (ø)
..._code_analyzer/models/unused_code_file_report.dart	100.00% <100.00%> (ø)
...unused_code_analyzer/models/unused_code_issue.dart	100.00% <100.00%> (ø)
...zers/unused_code_analyzer/public_code_visitor.dart	100.00% <100.00%> (ø)
... and 53 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 26ca53e...756ffe8. Read the comment docs.

[dkrutskikh]

@incendial I think for new commands we can activate immediately

[incendial]

Let's keep all commands in sync

[dkrutskikh]

@incendial please add test like test/src/cli/commands/check_unused_files_command_test.dart and update readme.md at line 123

[diegoveloper]

hey @incendial , thanks for this new command, one question, is the excluding files working?

I ran the command : flutter pub run dart_code_metrics:metrics check-unused-code lib (4.10.0-dev.1).

And the output contains a lot of *.g.dart: files. Checking the documentation https://dartcodemetrics.dev/docs/cli/check-unused-code

It says that the it's excluding those files by default.

[dkrutskikh]

@diegoveloper can we move discussion to the issue #653 ?

[incendial]

@diegoveloper hi, this should fix the problem #654