mvn-tree-visualizer 1.7.0__tar.gz → 1.8.4__tar.gz

{mvn_tree_visualizer-1.7.0 → mvn_tree_visualizer-1.8.4}/.github/workflows/ci.yml

@@ -12,13 +12,13 @@ jobs:
         python-version: ["3.13"]
     
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
     
     - name: Install uv
-      uses: astral-sh/setup-uv@v4
+      uses: astral-sh/setup-uv@v7
       with:
         version: "latest"
     

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

@@ -18,18 +18,18 @@ 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: |
@@ -37,7 +37,7 @@ jobs:
 
     - 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.7.0 → mvn_tree_visualizer-1.8.4}/CHANGELOG.md

@@ -6,13 +6,53 @@ 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
+## [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
 
-<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>
+- 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.6.0-beta.1](https://github.com/dyka3773/mvn-tree-visualizer/releases/tag/v1.6.0-beta.1) - 2025-07-24
+## [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-beta.1)</small>
+<small>[Compare with v1.5.2](https://github.com/dyka3773/mvn-tree-visualizer/compare/v1.5.2...v1.6.0)</small>
 
 ### Features
 

{mvn_tree_visualizer-1.7.0 → mvn_tree_visualizer-1.8.4}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: mvn-tree-visualizer
-Version: 1.7.0
+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 :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
@@ -124,6 +124,21 @@ mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" -
 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
@@ -156,6 +171,8 @@ Each example includes:
 | `--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 | - |
 

{mvn_tree_visualizer-1.7.0 → mvn_tree_visualizer-1.8.4}/README.md

@@ -101,6 +101,21 @@ mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" -
 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
@@ -133,6 +148,8 @@ Each example includes:
 | `--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 | - |
 

{mvn_tree_visualizer-1.7.0 → mvn_tree_visualizer-1.8.4}/ROADMAP.md

@@ -4,6 +4,28 @@ This document outlines the evolution and future direction of the `mvn-tree-visua
 
 ## 🎉 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
@@ -40,22 +62,11 @@ This document outlines the evolution and future direction of the `mvn-tree-visua
 
 **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
@@ -116,4 +127,4 @@ If you're interested in contributing to any of these features, please check out
 
 ---
 
-*Last updated: August 1, 2025*
+*Last updated: August 13, 2025*

{mvn_tree_visualizer-1.7.0 → mvn_tree_visualizer-1.8.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mvn-tree-visualizer"
-version = "1.7.0"
+version = "1.8.4"
 authors = [
     { name = "Iraklis Konsoulas", email = "dyka3773@gmail.com" },
 ]
@@ -20,7 +20,7 @@ keywords = [
     "mermaid",
 ]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.10",
@@ -43,12 +43,12 @@ mvn-tree-visualizer = "mvn_tree_visualizer.cli:cli"
 
 [dependency-groups]
 dev = [
-    "twine>=6.1.0",
-    "python-semantic-release>=10.2.0",
-    "build>=1.0.0",
-    "git-changelog>=2.5.3",
-    "tox>=4.28.4",
-    "pytest>=8.4.1",
+    "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]
@@ -71,9 +71,9 @@ match = "master"
 prerelease = false
 
 [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"
@@ -89,6 +89,7 @@ sections = [
     {type = "build", section = "Build System", scopes = []},
     {type = "test", section = "Tests", scopes = []},
     {type = "style", section = "Style", scopes = []},
+    {type = "deps", section = "Dependencies", scopes = []},
 ]
 
 [tool.tox]
@@ -97,7 +98,7 @@ 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",
+    "pytest>=9.0.1",
 ]
 commands = [[ "pytest", "-v" ]]
 

{mvn_tree_visualizer-1.7.0 → mvn_tree_visualizer-1.8.4}/src/mvn_tree_visualizer/cli.py

@@ -2,6 +2,7 @@ import argparse
 import sys
 import time
 import traceback
+import webbrowser
 from importlib import metadata
 from pathlib import Path
 from typing import NoReturn
@@ -12,6 +13,7 @@ from .file_watcher import FileWatcher
 from .get_dependencies_in_one_file import merge_files
 from .outputs.html_output import create_html_diagram
 from .outputs.json_output import create_json_output
+from .utils import add_timestamp_to_filename
 from .validation import find_dependency_files, validate_dependency_files, validate_output_directory
 
 
@@ -32,6 +34,7 @@ def generate_diagram(
     show_versions: bool,
     theme: str = "minimal",
     quiet: bool = False,
+    open_browser: bool = False,
 ) -> None:
     """Generate the dependency diagram with comprehensive error handling."""
     timestamp = time.strftime("%H:%M:%S")
@@ -118,6 +121,14 @@ def generate_diagram(
         if not quiet:
             print(f"[{timestamp}] SUCCESS: Diagram generated and saved to {output_file}")
 
+        # Open in browser if requested and format is HTML
+        if open_browser and output_format == "html" and not quiet:
+            try:
+                webbrowser.open(Path(output_file).resolve().as_uri())
+                print(f"[{timestamp}] Opening diagram in your default browser...")
+            except Exception as e:
+                print(f"[{timestamp}] WARNING: Could not open browser: {e}", file=sys.stderr)
+
     except MvnTreeVisualizerError as e:
         # Our custom errors already have helpful messages
         print(f"[{timestamp}] ERROR: {e}", file=sys.stderr)
@@ -216,6 +227,18 @@ def cli() -> NoReturn:
         help="Suppress all console output except errors. Perfect for CI/CD pipelines and scripted usage.",
     )
 
+    parser.add_argument(
+        "--open",
+        action="store_true",
+        help="Automatically open the generated HTML diagram in your default browser. Only works with HTML output format.",
+    )
+
+    parser.add_argument(
+        "--timestamp-output",
+        action="store_true",
+        help="Append timestamp to output filename (e.g., diagram-2025-08-13-203045.html). Useful for version tracking and CI/CD.",
+    )
+
     args = parser.parse_args()
     directory: str = args.directory
     output_file: str = args.output
@@ -226,6 +249,12 @@ def cli() -> NoReturn:
     watch_mode: bool = args.watch
     theme: str = args.theme
     quiet: bool = args.quiet
+    open_browser: bool = args.open
+    timestamp_output: bool = args.timestamp_output
+
+    # Apply timestamp to output filename if requested
+    if timestamp_output:
+        output_file = add_timestamp_to_filename(output_file)
 
     # Generate initial diagram
     if not quiet:
@@ -233,7 +262,7 @@ def cli() -> NoReturn:
         print(f"[{timestamp}] Generating initial diagram...")
 
     try:
-        generate_diagram(directory, output_file, filename, keep_tree, output_format, show_versions, theme, quiet)
+        generate_diagram(directory, output_file, filename, keep_tree, output_format, show_versions, theme, quiet, open_browser)
     except MvnTreeVisualizerError:
         sys.exit(1)
     except KeyboardInterrupt:
@@ -251,7 +280,7 @@ def cli() -> NoReturn:
     def regenerate_callback():
         """Callback function for file watcher."""
         try:
-            generate_diagram(directory, output_file, filename, keep_tree, output_format, show_versions, theme, quiet)
+            generate_diagram(directory, output_file, filename, keep_tree, output_format, show_versions, theme, quiet, open_browser)
         except Exception:
             # In watch mode, we don't want to exit on errors, just log them
             print("Error during diagram regeneration:", file=sys.stderr)

mvn_tree_visualizer-1.8.4/src/mvn_tree_visualizer/utils.py

@@ -0,0 +1,29 @@
+import time
+from pathlib import Path
+
+
+def add_timestamp_to_filename(filename: str) -> str:
+    """Add timestamp to filename before the extension.
+
+    Args:
+        filename: Original filename (e.g., 'diagram.html', 'output.json', 'folder/diagram.html')
+
+    Returns:
+        Timestamped filename (e.g., 'diagram-2025-08-13-203045.html')
+    """
+    timestamp = time.strftime("%Y-%m-%d-%H%M%S")
+    path = Path(filename)
+
+    # Handle paths by preserving directory and only modifying the filename
+    if path.parent != Path("."):
+        # Has a directory component
+        directory = path.parent
+        stem = path.stem
+        suffix = path.suffix
+        timestamped_name = f"{stem}-{timestamp}{suffix}"
+        return str(directory / timestamped_name)
+    else:
+        # No directory component
+        stem = path.stem
+        suffix = path.suffix
+        return f"{stem}-{timestamp}{suffix}"

mvn_tree_visualizer-1.8.4/tests/README.md

@@ -0,0 +1,69 @@
+# Test Structure Documentation
+
+## Overview
+This document describes the organization and structure of our test suite, which has been refactored to follow single-responsibility principles and improve maintainability.
+
+## Test Organization
+
+### Modular Test Structure
+We have moved away from monolithic test files containing multiple test classes to focused, single-purpose modules:
+
+#### CLI Tests (`tests/cli/`)
+- **`test_version.py`** - Version flag functionality (`--version`, `-v`)
+- **`test_quiet.py`** - Quiet mode functionality (`--quiet`, `-q`)  
+- **`test_open.py`** - Auto-open browser functionality (`--open`)
+- **`test_timestamp.py`** - Timestamp output functionality (`--timestamp-output`)
+
+Each CLI test module contains a single test class focused on one specific CLI feature.
+
+#### Large Diagram Tests (`tests/large_diagrams/`)
+- **`test_config.py`** - Mermaid configuration for large diagrams
+- **`test_navigation.py`** - Enhanced navigation controls and zoom features
+- **`test_compatibility.py`** - Backward compatibility testing
+- **`test_errors.py`** - Error handling scenarios
+
+Each large diagram test module contains a single test class focused on one aspect of large diagram support.
+
+### Standalone Test Files
+- **`test_github_issue_7.py`** - Specific GitHub issue #7 fix testing (single class)
+- **`test_html_output.py`** - HTML output generation testing (function-based tests)
+- **`test_json_output.py`** - JSON output generation testing (function-based tests)
+- **`test_watch_mode.py`** - File watching mode testing (function-based tests)
+
+## Benefits of Current Structure
+
+1. **Single Responsibility**: Each test file has a clear, focused purpose
+2. **Maintainability**: Changes to one feature don't affect tests for other features
+3. **Readability**: Easier to find and understand tests for specific functionality
+4. **Parallel Testing**: Better support for parallel test execution
+5. **Modularity**: Easy to add new feature tests without modifying existing files
+
+## Test Execution
+
+### Run All Tests
+```bash
+python -m pytest tests/ -v
+```
+
+### Run Specific Module Tests
+```bash
+# CLI functionality tests
+python -m pytest tests/cli/ -v
+
+# Large diagram tests  
+python -m pytest tests/large_diagrams/ -v
+
+# Specific feature tests
+python -m pytest tests/cli/test_open.py -v
+```
+
+## Test Count Summary
+- **CLI Tests**: 23 tests across 4 modules
+- **Large Diagram Tests**: 14 tests across 4 modules  
+- **Other Tests**: 31 tests in standalone modules
+- **Total**: 68 tests
+
+## Refactoring History
+- **Before**: Monolithic files with multiple test classes (e.g., `test_cli.py` with 4 classes)
+- **After**: Focused modules with single test classes or related functions
+- **Result**: Improved maintainability and clearer test organization

mvn_tree_visualizer-1.8.4/tests/cli/README.md

@@ -0,0 +1,61 @@
+# CLI Tests
+
+This directory contains modular tests for CLI functionality. Each file focuses on a specific CLI feature or flag, making tests easier to maintain and understand.
+
+## Structure
+
+```
+tests/cli/
+├── __init__.py              # Package initialization
+├── test_version.py          # Tests for --version/-v flag
+├── test_quiet.py            # Tests for --quiet/-q flag  
+├── test_open.py             # Tests for --open flag
+└── test_timestamp.py        # Tests for --timestamp-output flag
+```
+
+## Test Organization
+
+### `test_version.py`
+- Tests version string formatting and validation
+- Tests both `--version` and `-v` flags
+- Tests version precedence over other arguments
+- Tests edge cases like package not found
+
+### `test_quiet.py`
+- Tests output suppression with `--quiet`/`-q` flags
+- Tests that errors still show in quiet mode
+- Tests normal vs quiet behavior comparison
+
+### `test_open.py`
+- Tests automatic browser opening with `--open` flag
+- Tests HTML vs JSON format behavior
+- Tests quiet mode interaction
+- Tests error handling for browser failures
+
+### `test_timestamp.py`
+- Tests timestamp filename generation with `--timestamp-output`
+- Tests format consistency and path handling
+- Tests interaction with other flags
+- Tests both HTML and JSON output formats
+
+## Benefits of This Structure
+
+1. **Single Responsibility**: Each file tests one specific feature
+2. **Easy Navigation**: Developers can quickly find tests for a specific flag
+3. **Maintainable**: Changes to one feature don't affect other test files
+4. **Modular**: Can run tests for specific features independently
+5. **Clear Naming**: File names clearly indicate what functionality is tested
+
+## Running Tests
+
+```bash
+# Run all CLI tests
+pytest tests/cli/ -v
+
+# Run specific feature tests
+pytest tests/cli/test_version.py -v
+pytest tests/cli/test_open.py -v
+
+# Run specific test class
+pytest tests/cli/test_version.py::TestVersionFlag -v
+```

mvn_tree_visualizer-1.8.4/tests/cli/__init__.py

@@ -0,0 +1 @@
+"""CLI tests package."""