mvn-tree-visualizer 1.6.0b1__tar.gz → 1.7.0__tar.gz

mvn_tree_visualizer-1.7.0/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [ master, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.13"]
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+    
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+      with:
+        version: "latest"
+    
+    - name: Install dependencies
+      run: uv sync --dev
+    
+    - name: Install tox
+      run: uv tool install tox --with tox-uv
+
+    - name: Run linter & tests
+      run: tox --parallel
+    
+    - name: Test CLI
+      run: uv run python -m mvn_tree_visualizer --help

{mvn_tree_visualizer-1.6.0b1 → mvn_tree_visualizer-1.7.0}/.github/workflows/release.yml

@@ -2,7 +2,7 @@ name: Semantic Release
 
 on:
   push:
-    branches: [ master, develop ]
+    branches: [ master ]
   workflow_dispatch:
 
 concurrency: ${{ github.workflow }}-${{ github.ref }}
@@ -34,14 +34,6 @@ jobs:
     - name: Install dependencies
       run: |
         uv sync --dev
-        
-    - name: Run tests
-      run: |
-        uv run pytest tests/ -v
-
-    - name: Run linting
-      run: |
-        uv run ruff check .
 
     - name: Python Semantic Release
       id: release

mvn_tree_visualizer-1.7.0/CHANGELOG.md

@@ -0,0 +1,113 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+<!-- insertion marker -->
+## [v1.6.0](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.6.0) - 2025-07-24
+
+<small>[Compare with v1.6.0-beta.1](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.6.0-beta.1...v1.6.0)</small>
+
+## [v1.6.0-beta.1](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.6.0-beta.1) - 2025-07-24
+
+<small>[Compare with v1.5.2](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.5.2...v1.6.0-beta.1)</small>
+
+### Features
+
+- add beta release support for develop branch ([e578499](https://github.com/dyka3773/mvn-tree-visualizer/commit/e5784991ae136242fd4c8ddb929704f2b6f77616) by Hercules Konsoulas).
+
+### Bug Fixes
+
+- implement comprehensive changelog generation with git-changelog ([17e0c89](https://github.com/dyka3773/mvn-tree-visualizer/commit/17e0c894dfaff23ab464be52c9e1df8ac4bf71bc) by Hercules Konsoulas).
+
+## [v1.5.2](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.5.2) - 2025-07-24
+
+<small>[Compare with v1.5.1](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.5.1...v1.5.2)</small>
+
+### Bug Fixes
+
+- enable automatic changelog generation in semantic release ([c10460e](https://github.com/dyka3773/mvn-tree-visualizer/commit/c10460e09e96510ae95e795dafae53ac28230c50) by Hercules Konsoulas).
+
+## [v1.5.1](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.5.1) - 2025-07-21
+
+<small>[Compare with v1.5.0](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.5.0...v1.5.1)</small>
+
+### Bug Fixes
+
+- resolve an issue causing similar duplicate logs ([e861008](https://github.com/dyka3773/mvn-tree-visualizer/commit/e86100867de380ea37ff49a8b4d4659486bd7046) by Hercules Konsoulas).
+
+### Code Refactoring
+
+- remove unused and wrong imports ([3051ea2](https://github.com/dyka3773/mvn-tree-visualizer/commit/3051ea20b9f40f40c97a5b3aed5a67c167b75a99) by Hercules Konsoulas).
+
+## [v1.5.0](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.5.0) - 2025-07-19
+
+<small>[Compare with v1.4.0](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.4.0...v1.5.0)</small>
+
+### Features
+
+- resolve GitHub issue #7 with enhanced large project support ([3b3b14e](https://github.com/dyka3773/mvn-tree-visualizer/commit/3b3b14e88608c4b1c64295bbf786a898e3b600be) by Hercules Konsoulas).
+
+### Code Refactoring
+
+- updated another test to stay consistent with the previous commits ([01a100f](https://github.com/dyka3773/mvn-tree-visualizer/commit/01a100f01587a3f2b43eaa9b6859d7c77e849202) by Hercules Konsoulas).
+- centralize all magic numbers into shared constants module ([e3ee53c](https://github.com/dyka3773/mvn-tree-visualizer/commit/e3ee53cd99f146ca56265ea54c1ea3389ee1e1d8) by Hercules Konsoulas).
+- extract hardcoded magic numbers to named constants ([f1f6734](https://github.com/dyka3773/mvn-tree-visualizer/commit/f1f67347b401959d1700e2da36632e1eb87e6a34) by Hercules Konsoulas).
+- fix to previous commit ([2652892](https://github.com/dyka3773/mvn-tree-visualizer/commit/265289286eafe94f3aeef649ed6856c587061941) by Hercules Konsoulas).
+- extract zoom configuration values to constants ([b2d506e](https://github.com/dyka3773/mvn-tree-visualizer/commit/b2d506e7446e79e998be3bc6bd000930a7cab78c) by Hercules Konsoulas).
+
+## [v1.4.0](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.4.0) - 2025-07-17
+
+<small>[Compare with v1.3.0](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.3.0...v1.4.0)</small>
+
+### Features
+
+- add theme system with minimal and dark themes ([649e317](https://github.com/dyka3773/mvn-tree-visualizer/commit/649e317dac9531cc16b03cba3602994188468bf9) by Hercules Konsoulas).
+
+## [v1.3.0](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.3.0) - 2025-07-16
+
+<small>[Compare with v1.2.0](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.2.0...v1.3.0)</small>
+
+### Features
+
+- implement automated release system ([e8fc847](https://github.com/dyka3773/mvn-tree-visualizer/commit/e8fc8472ecbc3ebc7376b07f43aae63a27f299bc) by Hercules Konsoulas).
+- implement v1.3.0 user experience improvements ([2b87699](https://github.com/dyka3773/mvn-tree-visualizer/commit/2b8769903c34527542ee491ea9ac58f46e439e23) by Hercules Konsoulas).
+- enhance error handling and refactor code organization ([c4a183c](https://github.com/dyka3773/mvn-tree-visualizer/commit/c4a183c59380c30d6fe74e8609fc5eb706e88c85) by Hercules Konsoulas).
+- transform repository into professional open-source project ([4ceebdc](https://github.com/dyka3773/mvn-tree-visualizer/commit/4ceebdc886c87eb0d9852259a3aa06d0bc610ab2) by Hercules Konsoulas).
+
+### Bug Fixes
+
+- install build module within semantic-release build command ([cd5718d](https://github.com/dyka3773/mvn-tree-visualizer/commit/cd5718d56cd91934b55285c46713bb6cd738b4fa) by Hercules Konsoulas).
+- ensure build tools available for semantic-release action ([e2db367](https://github.com/dyka3773/mvn-tree-visualizer/commit/e2db367f3ebd14768eee5efc5d7515fab0f48c1c) by Hercules Konsoulas).
+- use uv run for build command in semantic-release ([bc5857b](https://github.com/dyka3773/mvn-tree-visualizer/commit/bc5857b080224b2489542470bff9beabf84b59fa) by Hercules Konsoulas).
+- add missing ruff dependency for CI linting ([675d892](https://github.com/dyka3773/mvn-tree-visualizer/commit/675d89209db91d0bbf234b7872a5a1893d81b729) by Hercules Konsoulas).
+- corrected funding link ([13c76c4](https://github.com/dyka3773/mvn-tree-visualizer/commit/13c76c4ad99ead6ecb5d7471c07b5ea5a22ffc8f) by Hercules Konsoulas).
+- install pytest separately in CI to resolve command not found error ([1a99192](https://github.com/dyka3773/mvn-tree-visualizer/commit/1a991927a9d94a405170d93660b62f89513e0056) by Hercules Konsoulas).
+- update JSON tests to match show_versions=False default ([88bcf95](https://github.com/dyka3773/mvn-tree-visualizer/commit/88bcf951f08243c97ddf8d3f3fa4c26e3f7de41d) by Hercules Konsoulas).
+
+### Code Refactoring
+
+- add watch mode and standardize JSON output format ([c1a6e14](https://github.com/dyka3773/mvn-tree-visualizer/commit/c1a6e143120031b4f9cf2417cb5db32a35899ddb) by Hercules Konsoulas).
+
+## [v1.2.0](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.2.0) - 2025-07-08
+
+<small>[Compare with v1.1.0](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.1.0...v1.2.0)</small>
+
+### Features
+
+- add --show-versions flag for both HTML and JSON outputs ([80c7d10](https://github.com/dyka3773/mvn-tree-visualizer/commit/80c7d1089e21c3a345bdc9a61242ed1233605a0e) by Hercules Konsoulas).
+- add comprehensive type hints to improve code quality ([b9b9da5](https://github.com/dyka3773/mvn-tree-visualizer/commit/b9b9da5a48b3c40feeca40de0c69eef3316afc7f) by Hercules Konsoulas).
+
+### Bug Fixes
+
+- Correct dependency installation in workflow ([3e500fc](https://github.com/dyka3773/mvn-tree-visualizer/commit/3e500fc76927b736a0f529ad8b2261b6735b949d) by Hercules Konsoulas).
+
+## [v1.1.0](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.1.0) - 2025-07-08
+
+<small>[Compare with first commit](https://github.com/dyka3773/mvn-tree-visualizer/compare/58ba414323de8d69f0f80a514cf9bb14f40fa22c...v1.1.0)</small>
+
+### Features
+
+- Add JSON output and decouple output logic ([e6cd138](https://github.com/dyka3773/mvn-tree-visualizer/commit/e6cd13836f93221f2dbd334574ca614d7dbe0e4a) by Hercules Konsoulas).

{mvn_tree_visualizer-1.6.0b1 → mvn_tree_visualizer-1.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mvn-tree-visualizer
-Version: 1.6.0b1
+Version: 1.7.0
 Summary: A simple command line tool to visualize the dependency tree of a Maven project in a graphical format.
 Project-URL: source, https://github.com/dyka3773/mvn-tree-visualizer
 Author-email: Iraklis Konsoulas <dyka3773@gmail.com>
@@ -10,10 +10,13 @@ Keywords: cli,command-line,dependency,graph,maven,mermaid,tool,tree,visualizatio
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Build Tools
 Classifier: Typing :: Typed
-Requires-Python: >=3.13
+Requires-Python: >=3.10
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: watchdog>=6.0.0
 Description-Content-Type: text/markdown
@@ -21,7 +24,7 @@ Description-Content-Type: text/markdown
 # Maven Dependency Tree Visualizer
 
 [![PyPI version](https://badge.fury.io/py/mvn-tree-visualizer.svg)](https://badge.fury.io/py/mvn-tree-visualizer)
-![Python](https://img.shields.io/badge/python-3.13+-blue.svg)
+![Python](https://img.shields.io/badge/python-3.10%20|%203.11%20|%203.12%20|%203.13-blue.svg)
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
 [![Downloads](https://pepy.tech/badge/mvn-tree-visualizer)](https://pepy.tech/project/mvn-tree-visualizer)
 [![CI](https://github.com/dyka3773/mvn-tree-visualizer/workflows/CI/badge.svg)](https://github.com/dyka3773/mvn-tree-visualizer/actions)
@@ -112,6 +115,15 @@ mvn-tree-visualizer --filename "maven_dependency_file" --output "dependencies.js
 mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --watch
 ```
 
+#### Quiet Mode (For Automation/Scripts)
+```bash
+# Only show errors, suppress success messages
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --quiet
+
+# Short form also available
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" -q
+```
+
 > **💡 Tip:** In watch mode, the tool will monitor for changes to your Maven dependency files and automatically regenerate the diagram. Perfect for development workflows! Press `Ctrl+C` to stop watching.
 
 ### Step 3: View the output
@@ -143,6 +155,8 @@ Each example includes:
 | `--watch` | Watch for file changes and auto-regenerate diagram | `False` |
 | `--directory` | The directory to scan for the Maven dependency file(s) | current directory |
 | `--keep-tree` | Keep the intermediate `dependency_tree.txt` file | `False` |
+| `--quiet`, `-q` | Suppress all console output except errors | `False` |
+| `--version`, `-v` | Show the current version and exit | - |
 | `--help` | Show the help message and exit | - |
 
 ### Theme Options

{mvn_tree_visualizer-1.6.0b1 → mvn_tree_visualizer-1.7.0}/README.md

@@ -1,7 +1,7 @@
 # Maven Dependency Tree Visualizer
 
 [![PyPI version](https://badge.fury.io/py/mvn-tree-visualizer.svg)](https://badge.fury.io/py/mvn-tree-visualizer)
-![Python](https://img.shields.io/badge/python-3.13+-blue.svg)
+![Python](https://img.shields.io/badge/python-3.10%20|%203.11%20|%203.12%20|%203.13-blue.svg)
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
 [![Downloads](https://pepy.tech/badge/mvn-tree-visualizer)](https://pepy.tech/project/mvn-tree-visualizer)
 [![CI](https://github.com/dyka3773/mvn-tree-visualizer/workflows/CI/badge.svg)](https://github.com/dyka3773/mvn-tree-visualizer/actions)
@@ -92,6 +92,15 @@ mvn-tree-visualizer --filename "maven_dependency_file" --output "dependencies.js
 mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --watch
 ```
 
+#### Quiet Mode (For Automation/Scripts)
+```bash
+# Only show errors, suppress success messages
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --quiet
+
+# Short form also available
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" -q
+```
+
 > **💡 Tip:** In watch mode, the tool will monitor for changes to your Maven dependency files and automatically regenerate the diagram. Perfect for development workflows! Press `Ctrl+C` to stop watching.
 
 ### Step 3: View the output
@@ -123,6 +132,8 @@ Each example includes:
 | `--watch` | Watch for file changes and auto-regenerate diagram | `False` |
 | `--directory` | The directory to scan for the Maven dependency file(s) | current directory |
 | `--keep-tree` | Keep the intermediate `dependency_tree.txt` file | `False` |
+| `--quiet`, `-q` | Suppress all console output except errors | `False` |
+| `--version`, `-v` | Show the current version and exit | - |
 | `--help` | Show the help message and exit | - |
 
 ### Theme Options

{mvn_tree_visualizer-1.6.0b1 → mvn_tree_visualizer-1.7.0}/RELEASE.md

@@ -89,24 +89,6 @@ When the release PR is merged to `master`, the automation triggers:
 7. **Publishes to PyPI** automatically
 8. **Creates GitHub release** with generated release notes
 
-## Manual Release (Emergency)
-
-For emergency releases or manual intervention:
-
-```bash
-# Install semantic-release locally
-uv sync --dev
-
-# Preview what will be released (dry-run)
-uv run semantic-release --dry-run
-
-# Force a specific version type
-uv run semantic-release --patch  # or --minor, --major
-
-# Generate changelog only
-uv run semantic-release changelog
-```
-
 ## Monitoring Releases
 
 ### Check Release Status:
@@ -144,21 +126,6 @@ minor_tags = ["feat"]
 patch_tags = ["fix", "perf"]
 ```
 
-## Migration from Manual Process
-
-**Previous manual steps no longer needed:**
-- ❌ Manual version updates in `pyproject.toml`
-- ❌ Manual CHANGELOG.md editing
-- ❌ Manual Git tag creation
-- ❌ Manual PyPI uploads
-
-**New automated process:**
-- ✅ Conventional commit messages
-- ✅ Automatic version management
-- ✅ Automatic changelog generation
-- ✅ Automatic PyPI publishing
-- ✅ Automatic GitHub releases
-
 ## Emergency Procedures
 
 ### Rollback a Release:

mvn_tree_visualizer-1.7.0/ROADMAP.md

@@ -0,0 +1,119 @@
+# Project Roadmap
+
+This document outlines the evolution and future direction of the `mvn-tree-visualizer` project. Major milestones show the progression from a basic tool to an enterprise-ready solution.
+
+## 🎉 Recently Completed ✅
+
+### v1.6.0 - Mistake Release (Released)
+
+**Focus:** Enhance automatic documentation generation and prerelease configs
+
+**Status:** Released July 24, 2025
+
+### Previous Major Releases ✅
+
+*   **v1.5 - GitHub Issue #7 Resolution and Navigation Enhancements** (July 19, 2025)
+    *   [x] **Support for Massive Dependency Trees**: Enhanced Mermaid configuration with `maxTextSize: 900000000` and `maxEdges: 20000`
+    *   [x] **Advanced Zoom Controls**: 50x zoom range with smooth mouse wheel support
+    *   [x] **Keyboard Shortcuts**: `Ctrl+R` for reset, `+/-` for zoom, `Ctrl+S` for download
+
+*   **v1.4 - Visual and Theme Enhancements** (July 17, 2025)
+    *   [x] Professional minimal and dark themes
+    *   [x] Enhanced HTML templates with interactive features
+    *   [x] SVG download functionality and improved user experience
+
+*   **v1.3 - User Experience Improvements** (July 9, 2025)
+    *   [x] Watch mode functionality with `--watch` flag
+    *   [x] Enhanced error handling system with comprehensive guidance
+    *   [x] Custom exception classes and validation modules
+    *   [x] Comprehensive test coverage and modular organization
+
+*   **Core Foundation** (Earlier versions)
+    *   [x] Multiple output formats (HTML and JSON)
+    *   [x] Dependency version display with `--show-versions`
+    *   [x] Multi-module Maven project support
+    *   [x] CI/CD workflows and comprehensive documentation
+    *   [x] `--theme` option with multiple built-in themes (default/minimal, dark, light)
+## 🔮 Future Development
+
+### Candidate Features for Upcoming Releases
+
+**Philosophy:** Small, practical improvements that provide immediate value to users. Features will be selected based on user feedback, development bandwidth, and priority.
+
+#### Essential CLI Features
+*   [ ] **`--quiet` / `-q` flag:** Suppress all console output except errors
+    *   **Use Case:** Perfect for CI/CD pipelines and scripted usage
+*   [ ] **`--version` / `-v` flag:** Display the current version of the tool
+    *   **Use Case:** Essential for any CLI tool, currently missing
+
+#### User Experience Enhancements
+*   [ ] **Alternative output filename patterns:** `--timestamp-output` flag to auto-append timestamp
+    *   **Use Case:** Useful for version tracking (e.g., `diagram-2025-08-01-143022.html`)
+*   [ ] **`--open` flag:** Automatically open generated diagram in default browser
+    *   **Implementation:** Platform-agnostic using Python's `webbrowser` module
+*   [ ] **Custom title support:** `--title "My Project Dependencies"`
+    *   **Use Case:** Personalize diagrams with meaningful project names
+*   [ ] **Progress indicators:** Simple feedback during long operations
+    *   **Implementation:** "Parsing dependencies..." → "Generating diagram..." → "Done!"
+
+#### Configuration & Customization
+*   [ ] **Configuration file support:** `.mvnviz.conf` file for default options
+    *   **Use Case:** Avoid typing same flags repeatedly, team consistency
+*   [ ] **`--exclude-scopes` option:** Filter out test, provided, or other scopes
+*   [ ] **`--max-depth` option:** Limit dependency tree depth for overview mode
+
+#### Output & Analysis Improvements
+*   [ ] **Basic dependency statistics:** Show total counts in CLI output and HTML comments
+
+#### Enterprise & Integration Features
+*   [ ] **Docker container:** Official container images for CI/CD
+*   [ ] **GitHub Actions integration:** Pre-built actions for automated diagram generation
+
+## 🎯 Technical Debt & Maintenance
+
+### Ongoing Improvements
+*   **Performance Optimization:** Continuous improvements for larger and more complex projects
+*   **Browser Compatibility:** Ensure compatibility with all major browsers and versions
+*   **Accessibility:** Enhanced accessibility features for users with disabilities
+*   **Documentation:** Comprehensive API documentation and developer guides
+
+### Code Quality
+*   **Test Coverage:** Maintain high test coverage with focus on edge cases
+*   **Type Safety:** Full type annotation coverage and strict type checking
+*   **Security:** Regular security audits and dependency updates
+*   **Performance:** Continuous profiling and optimization of critical paths
+
+**Focus:** Advanced analysis and integration features.
+
+*   **Dependency Analysis:**
+    *   [ ] Dependency conflict detection and highlighting
+    *   [ ] Dependency statistics and analysis
+    *   [ ] Version mismatch warnings
+*   **Integration Capabilities:**
+    *   [ ] CI/CD pipeline integration examples
+    *   [ ] Docker support and containerization
+    *   [ ] Maven plugin version (if demand exists)
+
+## Long-Term Vision (6-12 Months+)
+
+*   **Web-Based Version:** A web-based version where users can paste their dependency tree and get a visualization without installing the CLI.
+*   **IDE Integration:** Plugins for VS Code, IntelliJ IDEA, or Eclipse for direct dependency visualization.
+*   **Multi-Language Support:** Extend beyond Maven to support Gradle, npm, pip, etc.
+
+## Release Strategy
+
+Each release follows this approach:
+- **Incremental Value:** Each version adds meaningful value without breaking existing functionality
+- **User-Driven:** Priority based on user feedback and common pain points
+- **Quality First:** New features include comprehensive tests and documentation
+- **Backward Compatibility:** CLI interface remains stable across minor versions
+- **Small & Focused:** Features are kept small and manageable for faster delivery
+- **Feature Selection:** Features are chosen from the candidate list based on current priorities and available development time
+
+## Contributing
+
+If you're interested in contributing to any of these features, please check out our [CONTRIBUTING.md](CONTRIBUTING.md) file for more information.
+
+---
+
+*Last updated: August 1, 2025*

{mvn_tree_visualizer-1.6.0b1 → mvn_tree_visualizer-1.7.0}/pyproject.toml

@@ -1,12 +1,12 @@
 [project]
 name = "mvn-tree-visualizer"
-version = "1.6.0-beta.1"
+version = "1.7.0"
 authors = [
     { name = "Iraklis Konsoulas", email = "dyka3773@gmail.com" },
 ]
 description = "A simple command line tool to visualize the dependency tree of a Maven project in a graphical format."
 readme = "README.md"
-requires-python = ">=3.13"
+requires-python = ">=3.10"
 license = "MIT"
 keywords = [
     "maven",
@@ -23,6 +23,9 @@ classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Topic :: Software Development :: Build Tools",
     "Typing :: Typed",
@@ -41,11 +44,11 @@ mvn-tree-visualizer = "mvn_tree_visualizer.cli:cli"
 [dependency-groups]
 dev = [
     "twine>=6.1.0",
-    "ruff>=0.12.3",
-    "pytest>=8.3.2",
     "python-semantic-release>=10.2.0",
     "build>=1.0.0",
     "git-changelog>=2.5.3",
+    "tox>=4.28.4",
+    "pytest>=8.4.1",
 ]
 
 [build-system]
@@ -67,11 +70,6 @@ remove_dist = false
 match = "master"
 prerelease = false
 
-[tool.semantic_release.branches.develop]
-match = "develop"
-prerelease = true
-prerelease_token = "beta"
-
 [tool.semantic_release.commit_parser_options]
 allowed_tags = ["build", "chore", "ci", "docs", "feat", "fix", "perf", "style", "refactor", "test"]
 minor_tags = ["feat"]
@@ -92,3 +90,21 @@ sections = [
     {type = "test", section = "Tests", scopes = []},
     {type = "style", section = "Style", scopes = []},
 ]
+
+[tool.tox]
+env_list = ["lint", "3.10", "3.11", "3.12", "3.13"]
+
+[tool.tox.env_run_base]
+description = "Run tests with the current Python version"
+deps = [
+    "pytest>=8.3.2",
+]
+commands = [[ "pytest", "-v" ]]
+
+[tool.tox.env.lint]
+description = "Lint the codebase with ruff"
+deps = [
+    "ruff>=0.12.3",
+]
+skip_install = true
+commands = [[ "ruff", "check", "src/", "tests/" ]]

{mvn_tree_visualizer-1.6.0b1 → mvn_tree_visualizer-1.7.0}/src/mvn_tree_visualizer/cli.py

@@ -1,5 +1,8 @@
 import argparse
+import sys
 import time
+import traceback
+from importlib import metadata
 from pathlib import Path
 from typing import NoReturn
 
@@ -12,6 +15,14 @@ from .outputs.json_output import create_json_output
 from .validation import find_dependency_files, validate_dependency_files, validate_output_directory
 
 
+def get_version() -> str:
+    """Get the current version of the package."""
+    try:
+        return metadata.version("mvn-tree-visualizer")
+    except metadata.PackageNotFoundError:
+        return "unknown"
+
+
 def generate_diagram(
     directory: str,
     output_file: str,
@@ -20,6 +31,7 @@ def generate_diagram(
     output_format: str,
     show_versions: bool,
     theme: str = "minimal",
+    quiet: bool = False,
 ) -> None:
     """Generate the dependency diagram with comprehensive error handling."""
     timestamp = time.strftime("%H:%M:%S")
@@ -31,7 +43,7 @@ def generate_diagram(
 
         # Show what files we found
         dependency_files = find_dependency_files(directory, filename)
-        if len(dependency_files) > 1:
+        if len(dependency_files) > 1 and not quiet:
             print(f"[{timestamp}] Found {len(dependency_files)} dependency files")
 
         # Setup paths
@@ -103,24 +115,27 @@ def generate_diagram(
         except Exception as e:
             raise OutputGenerationError(f"Error generating {output_format.upper()} output: {e}")
 
-        print(f"[{timestamp}] ✅ Diagram generated and saved to {output_file}")
+        if not quiet:
+            print(f"[{timestamp}] SUCCESS: Diagram generated and saved to {output_file}")
 
     except MvnTreeVisualizerError as e:
         # Our custom errors already have helpful messages
-        print(f"[{timestamp}] ❌ Error: {e}")
+        print(f"[{timestamp}] ERROR: {e}", file=sys.stderr)
+        raise  # Re-raise the exception for the caller to handle
     except KeyboardInterrupt:
-        print(f"\n[{timestamp}] ⏹️  Operation cancelled by user")
+        print(f"\n[{timestamp}] Operation cancelled by user", file=sys.stderr)
+        raise  # Re-raise for the caller to handle
     except Exception as e:
         # Unexpected errors
-        print(f"[{timestamp}] ❌ Unexpected error: {e}")
-        print("This is an internal error. Please report this issue with the following details:")
-        print(f"  - Directory: {directory}")
-        print(f"  - Filename: {filename}")
-        print(f"  - Output: {output_file}")
-        print(f"  - Format: {output_format}")
-        import traceback
+        print(f"[{timestamp}] UNEXPECTED ERROR: {e}", file=sys.stderr)
+        print("This is an internal error. Please report this issue with the following details:", file=sys.stderr)
+        print(f"  - Directory: {directory}", file=sys.stderr)
+        print(f"  - Filename: {filename}", file=sys.stderr)
+        print(f"  - Output: {output_file}", file=sys.stderr)
+        print(f"  - Format: {output_format}", file=sys.stderr)
 
         traceback.print_exc()
+        raise  # Re-raise for the caller to handle
 
 
 def cli() -> NoReturn:
@@ -128,6 +143,14 @@ def cli() -> NoReturn:
         prog="mvn-tree-visualizer",
         description="Generate a dependency diagram from a file.",
     )
+
+    parser.add_argument(
+        "-v",
+        "--version",
+        action="version",
+        version=f"mvn-tree-visualizer {get_version()}",
+    )
+
     parser.add_argument(
         "directory",
         type=str,
@@ -186,6 +209,13 @@ def cli() -> NoReturn:
         help="Theme for the diagram visualization. Default is 'minimal'.",
     )
 
+    parser.add_argument(
+        "-q",
+        "--quiet",
+        action="store_true",
+        help="Suppress all console output except errors. Perfect for CI/CD pipelines and scripted usage.",
+    )
+
     args = parser.parse_args()
     directory: str = args.directory
     output_file: str = args.output
@@ -195,20 +225,37 @@ def cli() -> NoReturn:
     show_versions: bool = args.show_versions
     watch_mode: bool = args.watch
     theme: str = args.theme
+    quiet: bool = args.quiet
 
     # Generate initial diagram
-    print("Generating initial diagram...")
-    generate_diagram(directory, output_file, filename, keep_tree, output_format, show_versions, theme)
+    if not quiet:
+        timestamp = time.strftime("%Y-%m-%d %H:%M:%S")
+        print(f"[{timestamp}] Generating initial diagram...")
+
+    try:
+        generate_diagram(directory, output_file, filename, keep_tree, output_format, show_versions, theme, quiet)
+    except MvnTreeVisualizerError:
+        sys.exit(1)
+    except KeyboardInterrupt:
+        sys.exit(130)  # Standard exit code for SIGINT
+    except Exception:
+        sys.exit(1)
 
     if not watch_mode:
-        print("You can open it in your browser to view the dependency tree.")
-        print("Thank you for using mvn-tree-visualizer!")
+        if not quiet:
+            print("You can open it in your browser to view the dependency tree.")
+            print("Thank you for using mvn-tree-visualizer!")
         return
 
     # Watch mode
     def regenerate_callback():
         """Callback function for file watcher."""
-        generate_diagram(directory, output_file, filename, keep_tree, output_format, show_versions, theme)
+        try:
+            generate_diagram(directory, output_file, filename, keep_tree, output_format, show_versions, theme, quiet)
+        except Exception:
+            # In watch mode, we don't want to exit on errors, just log them
+            print("Error during diagram regeneration:", file=sys.stderr)
+            traceback.print_exc()
 
     watcher = FileWatcher(directory, filename, regenerate_callback)
     watcher.start()
@@ -216,7 +263,8 @@ def cli() -> NoReturn:
     try:
         watcher.wait()
     finally:
-        print("Thank you for using mvn-tree-visualizer!")
+        if not quiet:
+            print("Thank you for using mvn-tree-visualizer!")
 
 
 if __name__ == "__main__":