mvn-tree-visualizer 1.7.0__py3-none-any.whl → 1.8.0__py3-none-any.whl

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/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.7.0.dist-info → mvn_tree_visualizer-1.8.0.dist-info}/METADATA

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: mvn-tree-visualizer
-Version: 1.7.0
+Version: 1.8.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>
 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.dist-info → mvn_tree_visualizer-1.8.0.dist-info}/RECORD

@@ -1,17 +1,18 @@
 mvn_tree_visualizer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mvn_tree_visualizer/__main__.py,sha256=yIQFAdWjthKAFbSzzRuz5_YGlK0c6BnR2ypjNRDq180,82
-mvn_tree_visualizer/cli.py,sha256=luwm0Xsz6ws1JUWzvCOlr5kly7Tc7X6zOebiA8FLsPA,9935
+mvn_tree_visualizer/cli.py,sha256=1qrrcrLdJRM-GHYJsm0I9R1arOQ2XZxdZllazj-yME0,11134
 mvn_tree_visualizer/diagram.py,sha256=UfvP_J4Im4JQLe3EWlY3TsP4tua3oYk5NiCGbZNQwoA,933
 mvn_tree_visualizer/enhanced_template.py,sha256=AwK4gw5U8Ag-RmeD8Y11LXLRSnVzMFZhWja__c2iF4M,9813
 mvn_tree_visualizer/exceptions.py,sha256=R4nnJ0xrOpd84GfPD9rFSDk40etDLoph7iZpj1CCR0c,543
 mvn_tree_visualizer/file_watcher.py,sha256=JtmV1KW08_Az-XqpKhcd342WpxV1vUW-Dge9lodjjJY,2284
 mvn_tree_visualizer/get_dependencies_in_one_file.py,sha256=nXhEhU-dI7tXa3TpoW1pv2t86t1K0yppSw8FYDtmTlQ,1973
 mvn_tree_visualizer/themes.py,sha256=T7vdNVTHPtYYkh4HusGG1MUWk1mJcqFBjCc5IK5l6Dc,6338
+mvn_tree_visualizer/utils.py,sha256=Ws6Yo-I4tioBndZ7BLES8QwoMOcHE0XiRP8CSOTx8tg,901
 mvn_tree_visualizer/validation.py,sha256=UR_v6Jt7IGsgozE3aK0pB-t2-n1ivvS4YKxEa7p4VLQ,3206
 mvn_tree_visualizer/outputs/html_output.py,sha256=Y0IY-UF0UMTa5w8mVFoLidgcW6BUBTxASO0iRo26hH4,5531
 mvn_tree_visualizer/outputs/json_output.py,sha256=cXntw9ndE_BcrmFnuV61cEwZaRMp9Ev0SxaK1SUedlw,2037
-mvn_tree_visualizer-1.7.0.dist-info/METADATA,sha256=9I5whXjVtgJ6l9FhHiT1xEJJizFLcAZyuCVn3Pqzz30,9096
-mvn_tree_visualizer-1.7.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mvn_tree_visualizer-1.7.0.dist-info/entry_points.txt,sha256=Mu3QZhrlvbYuCxqmluVGi2efgKjkQY6T8Opf-vdb7hU,68
-mvn_tree_visualizer-1.7.0.dist-info/licenses/LICENSE,sha256=4zi6unpe17RUDMBu7ebh14jdbyvyeT-UA3n8Zl7aW74,1075
-mvn_tree_visualizer-1.7.0.dist-info/RECORD,,
+mvn_tree_visualizer-1.8.0.dist-info/METADATA,sha256=HtU1JoVK5jN4itRM6RhrdiRxMW0Gu4dyEOE-IepHr6I,9865
+mvn_tree_visualizer-1.8.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mvn_tree_visualizer-1.8.0.dist-info/entry_points.txt,sha256=Mu3QZhrlvbYuCxqmluVGi2efgKjkQY6T8Opf-vdb7hU,68
+mvn_tree_visualizer-1.8.0.dist-info/licenses/LICENSE,sha256=4zi6unpe17RUDMBu7ebh14jdbyvyeT-UA3n8Zl7aW74,1075
+mvn_tree_visualizer-1.8.0.dist-info/RECORD,,