mvn-tree-visualizer 1.6.0__py3-none-any.whl → 1.8.1__py3-none-any.whl

mvn_tree_visualizer/cli.py

@@ -1,5 +1,9 @@
 import argparse
+import sys
 import time
+import traceback
+import webbrowser
+from importlib import metadata
 from pathlib import Path
 from typing import NoReturn
 
@@ -9,9 +13,18 @@ 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
 
 
+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 +33,8 @@ def generate_diagram(
     output_format: str,
     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")
@@ -31,7 +46,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 +118,35 @@ 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}")
+
+        # 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}")
+        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 +154,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 +220,25 @@ 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.",
+    )
+
+    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
@@ -195,20 +248,43 @@ def cli() -> NoReturn:
     show_versions: bool = args.show_versions
     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
-    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, open_browser)
+    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, 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)
+            traceback.print_exc()
 
     watcher = FileWatcher(directory, filename, regenerate_callback)
     watcher.start()
@@ -216,7 +292,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__":

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

@@ -1,19 +1,22 @@
 Metadata-Version: 2.4
 Name: mvn-tree-visualizer
-Version: 1.6.0
+Version: 1.8.1
 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
+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,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 +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.0.dist-info → mvn_tree_visualizer-1.8.1.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=Kq29UoFPHEKjWzmrs7b-yn4T1bT76PXx984WD3rRco8,8371
+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.6.0.dist-info/METADATA,sha256=3u4CUISws1yO3X-CTmo7ydS26o-7QBJ_1h8Ne5IxnNM,8477
-mvn_tree_visualizer-1.6.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mvn_tree_visualizer-1.6.0.dist-info/entry_points.txt,sha256=Mu3QZhrlvbYuCxqmluVGi2efgKjkQY6T8Opf-vdb7hU,68
-mvn_tree_visualizer-1.6.0.dist-info/licenses/LICENSE,sha256=4zi6unpe17RUDMBu7ebh14jdbyvyeT-UA3n8Zl7aW74,1075
-mvn_tree_visualizer-1.6.0.dist-info/RECORD,,
+mvn_tree_visualizer-1.8.1.dist-info/METADATA,sha256=tnHNh02nGgqrzgf6tlsE2jIz5BLTGvmell395bVgEeQ,9865
+mvn_tree_visualizer-1.8.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mvn_tree_visualizer-1.8.1.dist-info/entry_points.txt,sha256=Mu3QZhrlvbYuCxqmluVGi2efgKjkQY6T8Opf-vdb7hU,68
+mvn_tree_visualizer-1.8.1.dist-info/licenses/LICENSE,sha256=4zi6unpe17RUDMBu7ebh14jdbyvyeT-UA3n8Zl7aW74,1075
+mvn_tree_visualizer-1.8.1.dist-info/RECORD,,