Add --max-depth option to control diagram complexity

[Julfried]

Type of Changes

	Type
	🐛 Bug fix
✓	✨ New feature
	🔨 Refactoring
	📜 Docs

Description

This PR adds a new --max-depth option to pyreverse that allows basic controlling of the visualization depth of packages and classes in the generated diagrams. The depth is simply calculated by counting dots in qualified names, where depth 0 represents top-level packages/classes.

For packages, the full path depth is considered. For classes, the depth is calculated based on their containing module to ensure meaningful class diagrams while respecting the depth limit.

Closes #9233

[codecov]

Codecov Report

Attention: Patch coverage is 42.85714% with 16 lines in your changes missing coverage. Please review.

Project coverage is 95.72%. Comparing base (614f80e) to head (7c95c20).

Files with missing lines	Patch %	Lines
pylint/pyreverse/writer.py	40.74%	16 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #10077      +/-   ##
==========================================
- Coverage   95.80%   95.72%   -0.08%     
==========================================
  Files         174      174              
  Lines       18962    18990      +28     
==========================================
+ Hits        18166    18178      +12     
- Misses        796      812      +16     

Files with missing lines	Coverage Δ
pylint/pyreverse/main.py	91.66% <ø> (ø)
pylint/testutils/pyreverse.py	98.11% <100.00%> (+0.03%)	⬆️
pylint/pyreverse/writer.py	86.44% <40.74%> (-13.56%)	⬇️

[github-actions]

🤖 According to the primer, this change has no effect on the checked open source code. 🤖🎉

This comment was generated for commit 7c95c20