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

mvn_tree_visualizer-1.8.4/.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@v6
+    
+    - name: Set up Python
+      uses: actions/setup-python@v6
+    
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+      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.8.4}/.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 }}
@@ -18,34 +18,26 @@ jobs:
 
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
         fetch-depth: 0
         token: ${{ secrets.GITHUB_TOKEN }}
 
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: '3.13'
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v6
+      uses: astral-sh/setup-uv@v7
 
     - 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
-      uses: python-semantic-release/python-semantic-release@v10.2.0
+      uses: python-semantic-release/python-semantic-release@v10.5.2
       with:
         github_token: ${{ secrets.GITHUB_TOKEN }}
 

mvn_tree_visualizer-1.8.4/CHANGELOG.md

@@ -0,0 +1,153 @@
+# 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.8.3](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.8.3) - 2025-11-24
+
+<small>[Compare with v1.8.2](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.8.2...v1.8.3)</small>
+
+## [v1.8.2](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.8.2) - 2025-11-10
+
+<small>[Compare with v1.8.1](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.8.1...v1.8.2)</small>
+
+## [v1.8.1](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.8.1) - 2025-11-10
+
+<small>[Compare with v1.8.0](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.8.0...v1.8.1)</small>
+
+## [v1.8.0](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.8.0) - 2025-08-13
+
+<small>[Compare with v1.7.0](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.7.0...v1.8.0)</small>
+
+### Features
+
+- add --timestamp-output flag to append timestamp to output filenames ([0292ac5](https://github.com/dyka3773/mvn-tree-visualizer/commit/0292ac5209a6b16c281b8146acc32e47264a02a7) by Hercules Konsoulas).
+- add --open flag to automatically open HTML diagrams in browser ([fb5237e](https://github.com/dyka3773/mvn-tree-visualizer/commit/fb5237ee5e3696bd550b08c1d8a4d5b428666b6f) by Hercules Konsoulas).
+
+### Code Refactoring
+
+- encode URL with proper built-in function ([eed841d](https://github.com/dyka3773/mvn-tree-visualizer/commit/eed841d007f1d2a0b0d6632d8a36b93e4524acc2) by Hercules Konsoulas).
+- restructure test suite into modular architecture ([6d25b7b](https://github.com/dyka3773/mvn-tree-visualizer/commit/6d25b7b1948252615d32ff7076428dc520ed60de) by Hercules Konsoulas).
+- moved timestamp creation to a separate util module for clarity ([cf8d188](https://github.com/dyka3773/mvn-tree-visualizer/commit/cf8d1885b0a4056988dba94496a4ac992af2b693) by Hercules Konsoulas).
+
+## [v1.7.0](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.7.0) - 2025-08-02
+
+<small>[Compare with v1.6.0](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.6.0...v1.7.0)</small>
+
+### Features
+
+- add --quiet/-q flag for silent operation ([5dfc82c](https://github.com/dyka3773/mvn-tree-visualizer/commit/5dfc82c57987870ab6200a7ec6682bda3aaf06c7) by Hercules Konsoulas).
+- add --version/-v flag to display current tool version ([6ee3e56](https://github.com/dyka3773/mvn-tree-visualizer/commit/6ee3e56302893aecb5ad87c115ea801acf03b4bc) by Hercules Konsoulas).
+
+### Bug Fixes
+
+- CLI test timeouts and file cleanup issues ([3d236d9](https://github.com/dyka3773/mvn-tree-visualizer/commit/3d236d93406e4bcc0a0ee6ea4c6f096ba5c0f861) by Hercules Konsoulas).
+
+### Code Refactoring
+
+- correct copilot's mistake for traceback ([d33b5a8](https://github.com/dyka3773/mvn-tree-visualizer/commit/d33b5a847399b34cb101f5650ff98af29e133db1) by Hercules Konsoulas).
+
+## [v1.6.0](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.6.0) - 2025-07-24
+
+<small>[Compare with v1.5.2](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.5.2...v1.6.0)</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/README.md → mvn_tree_visualizer-1.8.4/PKG-INFO

@@ -1,7 +1,30 @@
+Metadata-Version: 2.4
+Name: mvn-tree-visualizer
+Version: 1.8.4
+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>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,command-line,dependency,graph,maven,mermaid,tool,tree,visualization
+Classifier: Development Status :: 5 - Production/Stable
+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.10
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: watchdog>=6.0.0
+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)
@@ -92,6 +115,30 @@ 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
+```
+
+#### Auto-Open in Browser
+```bash
+# Automatically open the generated HTML diagram in your default browser
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --open
+```
+
+#### Timestamped Output Files
+```bash
+# Generate files with timestamps (e.g., diagram_20250813_143022.html)
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --timestamp-output
+
+# Combine with auto-open for immediate viewing
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --timestamp-output --open
+```
+
 > **💡 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 +170,10 @@ 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` |
+| `--open` | Automatically open generated HTML files in default browser | `False` |
+| `--timestamp-output` | Add timestamp to output filename (e.g., `diagram-2025-08-13-203045.html`) | `False` |
+| `--version`, `-v` | Show the current version and exit | - |
 | `--help` | Show the help message and exit | - |
 
 ### Theme Options

mvn_tree_visualizer-1.6.0b1/PKG-INFO → mvn_tree_visualizer-1.8.4/README.md

@@ -1,27 +1,7 @@
-Metadata-Version: 2.4
-Name: mvn-tree-visualizer
-Version: 1.6.0b1
-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>
-License-Expression: MIT
-License-File: LICENSE
-Keywords: cli,command-line,dependency,graph,maven,mermaid,tool,tree,visualization
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Typing :: Typed
-Requires-Python: >=3.13
-Requires-Dist: jinja2>=3.1.6
-Requires-Dist: watchdog>=6.0.0
-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 +92,30 @@ 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
+```
+
+#### Auto-Open in Browser
+```bash
+# Automatically open the generated HTML diagram in your default browser
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --open
+```
+
+#### Timestamped Output Files
+```bash
+# Generate files with timestamps (e.g., diagram_20250813_143022.html)
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --timestamp-output
+
+# Combine with auto-open for immediate viewing
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --timestamp-output --open
+```
+
 > **💡 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 +147,10 @@ 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` |
+| `--open` | Automatically open generated HTML files in default browser | `False` |
+| `--timestamp-output` | Add timestamp to output filename (e.g., `diagram-2025-08-13-203045.html`) | `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.8.4}/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.8.4/ROADMAP.md

@@ -0,0 +1,130 @@
+# 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.8.0 - User Experience & Test Architecture Improvements (In Progress)
+
+**Focus:** Practical CLI enhancements and improved maintainability
+
+**Status:** Ready for Release - August 13, 2025
+
+**Completed Features:**
+*   [x] **`--open` flag:** Automatically open generated HTML diagrams in default browser
+    *   Platform-agnostic implementation using Python's `webbrowser` module
+    *   Intelligent handling: only works with HTML output, graceful error handling
+    *   Combined functionality with quiet mode and other flags
+*   [x] **`--timestamp-output` flag:** Auto-append timestamp to output filenames
+    *   Format: `diagram_20250813_143022.html` for version tracking
+    *   Works with both HTML and JSON output formats
+    *   Perfect for CI/CD and avoiding file overwrites
+*   [x] **Comprehensive Test Architecture Refactoring:**
+    *   Modular test structure: Split monolithic test files into focused modules
+    *   `tests/cli/` - Individual CLI feature testing (version, quiet, open, timestamp)
+    *   `tests/large_diagrams/` - Focused large diagram feature testing
+    *   Single-responsibility principle: Each test file has one clear purpose
+    *   Improved maintainability and parallel test execution support
+
+### 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.
+
+#### User Experience Enhancements
+*   [ ] **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 13, 2025*

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

@@ -1,12 +1,12 @@
 [project]
 name = "mvn-tree-visualizer"
-version = "1.6.0-beta.1"
+version = "1.8.4"
 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",
@@ -20,9 +20,12 @@ keywords = [
     "mermaid",
 ]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "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",
@@ -40,12 +43,12 @@ 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",
+    "twine>=6.2.0",
+    "python-semantic-release>=10.5.2",
+    "build>=1.3.0",
+    "git-changelog>=2.7.0",
+    "tox>=4.32.0",
+    "pytest>=9.0.1",
 ]
 
 [build-system]
@@ -67,15 +70,10 @@ 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"]
+allowed_tags = ["build", "chore", "deps", "ci", "docs", "feat", "fix", "perf", "style", "refactor", "test"]
 minor_tags = ["feat"]
-patch_tags = ["fix", "perf"]
+patch_tags = ["fix", "perf", "deps"]
 
 [tool.git-changelog]
 convention = "conventional"
@@ -91,4 +89,23 @@ sections = [
     {type = "build", section = "Build System", scopes = []},
     {type = "test", section = "Tests", scopes = []},
     {type = "style", section = "Style", scopes = []},
+    {type = "deps", section = "Dependencies", 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>=9.0.1",
+]
+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/" ]]