mvn-tree-visualizer 1.4.0__py3-none-any.whl → 1.5.1__py3-none-any.whl

mvn_tree_visualizer/cli.py

@@ -4,12 +4,12 @@ from pathlib import Path
 from typing import NoReturn
 
 from .diagram import create_diagram
-from .exceptions import DependencyFileNotFoundError, DependencyParsingError, MvnTreeVisualizerError, OutputGenerationError
+from .exceptions import DependencyParsingError, MvnTreeVisualizerError, OutputGenerationError
 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 .validation import find_dependency_files, print_maven_help, validate_dependency_files, validate_output_directory
+from .validation import find_dependency_files, validate_dependency_files, validate_output_directory
 
 
 def generate_diagram(
@@ -108,8 +108,6 @@ def generate_diagram(
     except MvnTreeVisualizerError as e:
         # Our custom errors already have helpful messages
         print(f"[{timestamp}] ❌ Error: {e}")
-        if isinstance(e, DependencyFileNotFoundError):
-            print_maven_help()
     except KeyboardInterrupt:
         print(f"\n[{timestamp}] ⏹️  Operation cancelled by user")
     except Exception as e:

mvn_tree_visualizer/enhanced_template.py

@@ -2,7 +2,7 @@
 
 from typing import Any, Dict
 
-from .themes import STANDARD_COLORS, Theme
+from .themes import MAX_ZOOM, MIN_ZOOM, STANDARD_COLORS, ZOOM_SCALE_SENSITIVITY, Theme
 
 
 def get_html_template(theme: Theme) -> str:
@@ -93,6 +93,12 @@ def get_html_template(theme: Theme) -> str:
             <button id="downloadButton" class="toggle-btn">Download SVG</button>
             <!-- Note: PNG download feature to be implemented in future version -->
         </div>
+        <div class="control-group">
+            <span class="control-label">Navigation:</span>
+            <button id="zoomInButton" class="toggle-btn">Zoom In (+)</button>
+            <button id="zoomOutButton" class="toggle-btn">Zoom Out (-)</button>
+            <button id="resetZoomButton" class="toggle-btn">Reset (Ctrl+R)</button>
+        </div>
     </div>
     
     <div id="graphDiv"></div>
@@ -107,6 +113,10 @@ def get_html_template(theme: Theme) -> str:
         // Global variables
         let panZoomInstance = null;
         
+        const MIN_ZOOM = {MIN_ZOOM};
+        const MAX_ZOOM = {MAX_ZOOM};
+        const ZOOM_SCALE_SENSITIVITY = {ZOOM_SCALE_SENSITIVITY};
+        
         const drawDiagram = async function () {{
             const element = document.querySelector('#graphDiv');
             const graphDefinition = `{{{{diagram_definition}}}}`;
@@ -115,14 +125,21 @@ def get_html_template(theme: Theme) -> str:
                 const {{ svg }} = await mermaid.render('mySvgId', graphDefinition);
                 element.innerHTML = svg.replace(/[ ]*max-width:[ 0-9\\.]*px;/i , '');
                 
-                // Initialize pan & zoom
+                // Initialize pan & zoom with improved settings for large diagrams
                 panZoomInstance = svgPanZoom('#mySvgId', {{
                     zoomEnabled: true,
                     controlIconsEnabled: true,
                     fit: true,
                     center: true,
-                    minZoom: 0.1,
-                    maxZoom: 10
+                    minZoom: MIN_ZOOM,  // Allow zooming out further for large diagrams
+                    maxZoom: MAX_ZOOM,  // Allow much higher zoom for detailed inspection
+                    zoomScaleSensitivity: ZOOM_SCALE_SENSITIVITY,  // Smoother zoom increments
+                    mouseWheelZoomEnabled: true,
+                    preventMouseEventsDefault: true,
+                    beforeZoom: function(oldScale, newScale) {{
+                        // Prevent zooming beyond reasonable limits
+                        return newScale >= MIN_ZOOM && newScale <= MAX_ZOOM;
+                    }}
                 }});
                 
                 // Setup node interactions
@@ -142,11 +159,29 @@ def get_html_template(theme: Theme) -> str:
             }});
         }};
         
-        // Download functionality
+        // Button event listeners
         document.getElementById('downloadButton').addEventListener('click', function() {{
             downloadSVG();
         }});
         
+        document.getElementById('zoomInButton').addEventListener('click', function() {{
+            if (panZoomInstance) {{
+                panZoomInstance.zoomIn();
+            }}
+        }});
+        
+        document.getElementById('zoomOutButton').addEventListener('click', function() {{
+            if (panZoomInstance) {{
+                panZoomInstance.zoomOut();
+            }}
+        }});
+        
+        document.getElementById('resetZoomButton').addEventListener('click', function() {{
+            if (panZoomInstance) {{
+                panZoomInstance.reset();
+            }}
+        }});
+        
         const downloadSVG = function() {{
             const svg = document.querySelector('#mySvgId');
             let svgData = new XMLSerializer().serializeToString(svg);
@@ -183,6 +218,34 @@ def get_html_template(theme: Theme) -> str:
                             panZoomInstance.reset();
                         }}
                         break;
+                    case '=':
+                    case '+':
+                        e.preventDefault();
+                        if (panZoomInstance) {{
+                            panZoomInstance.zoomIn();
+                        }}
+                        break;
+                    case '-':
+                        e.preventDefault();
+                        if (panZoomInstance) {{
+                            panZoomInstance.zoomOut();
+                        }}
+                        break;
+                }}
+            }} else {{
+                // Non-Ctrl shortcuts
+                switch(e.key) {{
+                    case '+':
+                    case '=':
+                        if (panZoomInstance) {{
+                            panZoomInstance.zoomIn();
+                        }}
+                        break;
+                    case '-':
+                        if (panZoomInstance) {{
+                            panZoomInstance.zoomOut();
+                        }}
+                        break;
                 }}
             }}
         }});

mvn_tree_visualizer/themes.py

@@ -2,6 +2,15 @@
 
 from typing import Any, Dict
 
+# Mermaid configuration constants for large project support
+MAX_TEXT_SIZE_LARGE_PROJECTS = 900000000  # Increase max text size for large dependency trees
+MAX_EDGES_LARGE_PROJECTS = 20000  # Increase max edges for large projects
+
+# Zoom configuration constants for enhanced navigation
+MIN_ZOOM = 0.01  # Minimum zoom level for large diagram overview
+MAX_ZOOM = 50  # Maximum zoom level for detailed inspection
+ZOOM_SCALE_SENSITIVITY = 0.2  # Smoother zoom increments
+
 
 class Theme:
     """Base theme configuration class."""
@@ -98,6 +107,8 @@ THEMES = {
                 "secondaryColor": "#f5f5f5",
                 "tertiaryColor": "#ffffff",
             },
+            "maxTextSize": MAX_TEXT_SIZE_LARGE_PROJECTS,  # Increase max text size for large dependency trees
+            "maxEdges": MAX_EDGES_LARGE_PROJECTS,  # Increase max edges for large projects
         },
     ),
     "dark": Theme(
@@ -174,6 +185,8 @@ THEMES = {
                 "nodeTextColor": "#ffffff",
                 "textColor": "#ffffff",
             },
+            "maxTextSize": MAX_TEXT_SIZE_LARGE_PROJECTS,  # Increase max text size for large dependency trees
+            "maxEdges": MAX_EDGES_LARGE_PROJECTS,  # Increase max edges for large projects
         },
     ),
 }

mvn_tree_visualizer/validation.py

@@ -15,15 +15,6 @@ def find_dependency_files(directory: str, filename: str) -> list[str]:
     return found_files
 
 
-def print_maven_help() -> None:
-    """Print helpful Maven commands for generating dependency files."""
-    print("\n💡 To generate a Maven dependency file, try one of these commands:")
-    print("   mvn dependency:tree -DoutputFile=maven_dependency_file")
-    print("   mvn dependency:tree > maven_dependency_file")
-    print("   mvn dependency:tree -DoutputFile=maven_dependency_file -DoutputType=text")
-    print("\n📍 Make sure you're in a directory with a pom.xml file.")
-
-
 def validate_directory(directory: str) -> None:
     """Validate that the directory exists and is accessible."""
     if not os.path.exists(directory):

{mvn_tree_visualizer-1.4.0.dist-info → mvn_tree_visualizer-1.5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mvn-tree-visualizer
-Version: 1.4.0
+Version: 1.5.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>
@@ -57,12 +57,10 @@ pip install mvn-tree-visualizer
   - **JSON:** Creates a structured JSON representation of the dependency tree, perfect for scripting or integration with other tools.
 - **🎨 Theme System:** Choose from 2 built-in themes (minimal, dark) for clean and consistent diagram styling.
 - **🔄 Watch Mode:** Automatically regenerates diagrams when Maven dependency files change using the `--watch` flag.
-- **📋 Version Display:** Show or hide dependency versions in both HTML and JSON outputs using the `--show-versions` flag.
-- **⚡ Easy to Use:** A simple command-line interface that gets the job done with minimal configuration.
-- **📂 File Merging:** Automatically finds and merges multiple `maven_dependency_file` files from different subdirectories.
-- **🎨 Customizable Output:** Specify the output file name and location.
-- **💾 Enhanced Downloads:** Download diagrams as SVG or high-resolution PNG directly from the HTML page.
-- **🖱️ Interactive Features:** Hover tooltips, click-to-highlight connections, pan/zoom controls, and keyboard shortcuts.
+- **📋 Version Display:** Toggle dependency versions in outputs with `--show-versions`
+- **💾 Enhanced Downloads:** SVG and PNG export directly from browser
+- **📂 Smart File Handling:** Automatically finds and merges multiple `maven_dependency_file` files from different subdirectories.
+- **🎯 Color Coding:** Visual distinction between root, intermediate, and leaf dependencies
 
 ## How to Use
 
@@ -82,36 +80,36 @@ Use the `mvn-tree-visualizer` command to generate the diagram.
 
 #### HTML Output (Interactive Diagram)
 ```bash
-mvn_tree_visualizer --filename "maven_dependency_file" --output "diagram.html" --format html
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --format html
 ```
 
 #### JSON Output (Structured Data)
 ```bash
-mvn_tree_visualizer --filename "maven_dependency_file" --output "dependencies.json" --format json
+mvn-tree-visualizer --filename "maven_dependency_file" --output "dependencies.json" --format json
 ```
 
 #### With Version Information
 ```bash
-mvn_tree_visualizer --filename "maven_dependency_file" --output "diagram.html" --show-versions
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --show-versions
 ```
 
 #### With Custom Themes
 ```bash
 # Dark theme for low-light environments  
-mvn_tree_visualizer --filename "maven_dependency_file" --output "diagram.html" --theme dark
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --theme dark
 
 # Default minimal theme (clean monospace design)
-mvn_tree_visualizer --filename "maven_dependency_file" --output "diagram.html"
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html"
 ```
 
 #### JSON Output with Versions
 ```bash
-mvn_tree_visualizer --filename "maven_dependency_file" --output "dependencies.json" --format json --show-versions
+mvn-tree-visualizer --filename "maven_dependency_file" --output "dependencies.json" --format json --show-versions
 ```
 
 #### Watch Mode (Auto-regeneration)
 ```bash
-mvn_tree_visualizer --filename "maven_dependency_file" --output "diagram.html" --watch
+mvn-tree-visualizer --filename "maven_dependency_file" --output "diagram.html" --watch
 ```
 
 > **💡 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.

{mvn_tree_visualizer-1.4.0.dist-info → mvn_tree_visualizer-1.5.1.dist-info}/RECORD

@@ -1,17 +1,17 @@
 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=Gufk14zH74lqSTz2o2KPPEmNLvOHKHLyno-eSyXqahw,8504
+mvn_tree_visualizer/cli.py,sha256=Kq29UoFPHEKjWzmrs7b-yn4T1bT76PXx984WD3rRco8,8371
 mvn_tree_visualizer/diagram.py,sha256=UfvP_J4Im4JQLe3EWlY3TsP4tua3oYk5NiCGbZNQwoA,933
-mvn_tree_visualizer/enhanced_template.py,sha256=I35fNkZrlA5jYdyjPW0jU4FH4FF2HEagtwcUX6fcmMc,7050
+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=91asg9VIqa7q2sUmgRD-Fw5wJ6kKsVWlPJ-bX9kGZhw,5469
-mvn_tree_visualizer/validation.py,sha256=UQ194gHiVS8UnJpp90sCM-Vjn3aeXT6scdwOplAoaSE,3689
+mvn_tree_visualizer/themes.py,sha256=T7vdNVTHPtYYkh4HusGG1MUWk1mJcqFBjCc5IK5l6Dc,6338
+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.4.0.dist-info/METADATA,sha256=AIAeZ3goQMeRVtZDxJLIRnlw37nBL1kCMHHRnjk2XuM,8756
-mvn_tree_visualizer-1.4.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mvn_tree_visualizer-1.4.0.dist-info/entry_points.txt,sha256=Mu3QZhrlvbYuCxqmluVGi2efgKjkQY6T8Opf-vdb7hU,68
-mvn_tree_visualizer-1.4.0.dist-info/licenses/LICENSE,sha256=4zi6unpe17RUDMBu7ebh14jdbyvyeT-UA3n8Zl7aW74,1075
-mvn_tree_visualizer-1.4.0.dist-info/RECORD,,
+mvn_tree_visualizer-1.5.1.dist-info/METADATA,sha256=F1SJi1YTZyENETyMipYJnojylvqCY3BEu9IbT7pCRpM,8477
+mvn_tree_visualizer-1.5.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mvn_tree_visualizer-1.5.1.dist-info/entry_points.txt,sha256=Mu3QZhrlvbYuCxqmluVGi2efgKjkQY6T8Opf-vdb7hU,68
+mvn_tree_visualizer-1.5.1.dist-info/licenses/LICENSE,sha256=4zi6unpe17RUDMBu7ebh14jdbyvyeT-UA3n8Zl7aW74,1075
+mvn_tree_visualizer-1.5.1.dist-info/RECORD,,