mvn-tree-visualizer 1.5.0__tar.gz → 1.5.1__tar.gz

{mvn_tree_visualizer-1.5.0 → mvn_tree_visualizer-1.5.1}/.github/SECURITY.md

@@ -6,8 +6,10 @@ We actively support the following versions of mvn-tree-visualizer:
 
 | Version | Supported          |
 | ------- | ------------------ |
-| 1.3.x   | :white_check_mark: |
-| 1.2.x   | :white_check_mark: |
+| 1.5.x   | :white_check_mark: |
+| 1.4.x   | :white_check_mark: |
+| 1.3.x   | :x:                |
+| 1.2.x   | :x:                |
 | 1.1.x   | :x:                |
 | 1.0.x   | :x:                |
 

{mvn_tree_visualizer-1.5.0 → mvn_tree_visualizer-1.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mvn-tree-visualizer
-Version: 1.5.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>
@@ -80,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.5.0 → mvn_tree_visualizer-1.5.1}/README.md

@@ -60,36 +60,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.5.0 → mvn_tree_visualizer-1.5.1}/docs/INTEGRATION.md

@@ -35,8 +35,8 @@ jobs:
     
     - name: Create dependency visualization
       run: |
-        mvn_tree_visualizer --filename maven_dependency_file --output dependencies.json --format json
-        mvn_tree_visualizer --filename maven_dependency_file --output dependencies.html
+        mvn-tree-visualizer --filename maven_dependency_file --output dependencies.json --format json
+        mvn-tree-visualizer --filename maven_dependency_file --output dependencies.html
     
     - name: Upload artifacts
       uses: actions/upload-artifact@v3
@@ -58,7 +58,7 @@ pipeline {
             steps {
                 sh 'mvn dependency:tree -DoutputFile=maven_dependency_file'
                 sh 'pip install mvn-tree-visualizer'
-                sh 'mvn_tree_visualizer --filename maven_dependency_file --output dependencies.json --format json'
+                sh 'mvn-tree-visualizer --filename maven_dependency_file --output dependencies.json --format json'
             }
         }
         
@@ -91,7 +91,7 @@ def analyze_dependencies(project_path):
     
     # Generate JSON output
     subprocess.run([
-        'mvn_tree_visualizer', 
+        'mvn-tree-visualizer', 
         '--filename', 'maven_dependency_file',
         '--output', 'dependencies.json',
         '--format', 'json'
@@ -127,9 +127,9 @@ cd "$PROJECT_DIR"
 mvn dependency:tree -DoutputFile=maven_dependency_file
 
 # Generate visualizations
-mvn_tree_visualizer --filename maven_dependency_file --output "$OUTPUT_DIR/dependencies.html"
-mvn_tree_visualizer --filename maven_dependency_file --output "$OUTPUT_DIR/dependencies.json" --format json
-mvn_tree_visualizer --filename maven_dependency_file --output "$OUTPUT_DIR/dependencies-with-versions.json" --format json --show-versions
+mvn-tree-visualizer --filename maven_dependency_file --output "$OUTPUT_DIR/dependencies.html"
+mvn-tree-visualizer --filename maven_dependency_file --output "$OUTPUT_DIR/dependencies.json" --format json
+mvn-tree-visualizer --filename maven_dependency_file --output "$OUTPUT_DIR/dependencies-with-versions.json" --format json --show-versions
 
 echo "Analysis complete! Check $OUTPUT_DIR for results."
 ```
@@ -220,7 +220,7 @@ RUN mvn dependency:tree -DoutputFile=maven_dependency_file
 FROM python:3.13-slim AS visualizer
 RUN pip install mvn-tree-visualizer
 COPY --from=maven-deps /app/maven_dependency_file .
-RUN mvn_tree_visualizer --filename maven_dependency_file --output dependencies.json --format json
+RUN mvn-tree-visualizer --filename maven_dependency_file --output dependencies.json --format json
 
 FROM nginx:alpine
 COPY --from=visualizer /dependencies.json /usr/share/nginx/html/
@@ -253,7 +253,7 @@ find . -name "pom.xml" -exec dirname {} \; | while read project; do
     echo "Processing $project"
     cd "$project"
     mvn dependency:tree -DoutputFile=maven_dependency_file
-    mvn_tree_visualizer --filename maven_dependency_file --output "../analysis/$(basename $project).json" --format json
+    mvn-tree-visualizer --filename maven_dependency_file --output "../analysis/$(basename $project).json" --format json
     cd - > /dev/null
 done
 ```

{mvn_tree_visualizer-1.5.0 → mvn_tree_visualizer-1.5.1}/examples/README.md

@@ -19,11 +19,11 @@ The `simple-project/` directory contains a modern Spring Boot 3.2 web applicatio
 cd examples/simple-project
 
 # Generate with different themes
-mvn_tree_visualizer --filename maven_dependency_file --output diagram-minimal.html
-mvn_tree_visualizer --filename maven_dependency_file --output diagram-dark.html --theme dark
+mvn-tree-visualizer --filename maven_dependency_file --output diagram-minimal.html
+mvn-tree-visualizer --filename maven_dependency_file --output diagram-dark.html --theme dark
 
 # Generate JSON output for automation
-mvn_tree_visualizer --filename maven_dependency_file --output dependencies.json --format json
+mvn-tree-visualizer --filename maven_dependency_file --output dependencies.json --format json
 ```
 
 ## Complex Project Example
@@ -46,8 +46,8 @@ The `complex-project/` directory demonstrates a **real-world enterprise microser
 cd examples/complex-project
 
 # Generate with version numbers (recommended for enterprise projects)
-mvn_tree_visualizer --filename maven_dependency_file --output diagram-minimal.html --show-versions
-mvn_tree_visualizer --filename maven_dependency_file --output diagram-dark.html --theme dark --show-versions
+mvn-tree-visualizer --filename maven_dependency_file --output diagram-minimal.html --show-versions
+mvn-tree-visualizer --filename maven_dependency_file --output diagram-dark.html --theme dark --show-versions
 ```
 
 ## 🎨 Theme Comparison
@@ -122,13 +122,13 @@ maxZoom: 50             // 50x zoom in for detailed inspection
 2. **Create visualizations**:
    ```bash
    # Basic diagram
-   mvn_tree_visualizer --filename maven_dependency_file --output diagram.html
+   mvn-tree-visualizer --filename maven_dependency_file --output diagram.html
    
    # With versions for detailed analysis
-   mvn_tree_visualizer --filename maven_dependency_file --output diagram.html --show-versions
+   mvn-tree-visualizer --filename maven_dependency_file --output diagram.html --show-versions
    
    # Dark theme for coding sessions
-   mvn_tree_visualizer --filename maven_dependency_file --output diagram.html --theme dark
+   mvn-tree-visualizer --filename maven_dependency_file --output diagram.html --theme dark
    ```
 
 3. **Open in browser** and explore with enhanced zoom and navigation controls!
@@ -137,28 +137,28 @@ maxZoom: 50             // 50x zoom in for detailed inspection
 
 ### 1. Quick Dependency Overview
 ```bash
-mvn_tree_visualizer --filename maven_dependency_file --output overview.html
+mvn-tree-visualizer --filename maven_dependency_file --output overview.html
 ```
 - Clean view without version numbers
 - Easy to identify dependency relationships
 
 ### 2. Detailed Analysis with Versions
 ```bash
-mvn_tree_visualizer --filename maven_dependency_file --output detailed.html --show-versions
+mvn-tree-visualizer --filename maven_dependency_file --output detailed.html --show-versions
 ```
 - Shows all version information
 - Useful for debugging version conflicts
 
 ### 3. Scripting and Automation
 ```bash
-mvn_tree_visualizer --filename maven_dependency_file --output deps.json --format json
+mvn-tree-visualizer --filename maven_dependency_file --output deps.json --format json
 ```
 - Machine-readable JSON format
 - Perfect for CI/CD pipelines and automated analysis
 
 ### 4. Multi-module Projects
 ```bash
-mvn_tree_visualizer --directory ./my-project --output multi-module.html
+mvn-tree-visualizer --directory ./my-project --output multi-module.html
 ```
 - Automatically finds and merges dependency files from subdirectories
 - Comprehensive view of entire project structure

{mvn_tree_visualizer-1.5.0 → mvn_tree_visualizer-1.5.1}/examples/watch-test/README.md

@@ -6,7 +6,7 @@ This directory contains a simple test to demonstrate the watch mode functionalit
 
 1. **Start watch mode:**
    ```bash
-   mvn_tree_visualizer --filename test_maven_file --output watch-test.html --watch
+   mvn-tree-visualizer --filename test_maven_file --output watch-test.html --watch
    ```
 
 2. **Modify the test file** while the watch is running to see automatic regeneration.

{mvn_tree_visualizer-1.5.0 → mvn_tree_visualizer-1.5.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mvn-tree-visualizer"
-version = "1.5.0"
+version = "1.5.1"
 authors = [
     { name = "Iraklis Konsoulas", email = "dyka3773@gmail.com" },
 ]

{mvn_tree_visualizer-1.5.0 → mvn_tree_visualizer-1.5.1}/src/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-1.5.0 → mvn_tree_visualizer-1.5.1}/src/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.5.0 → mvn_tree_visualizer-1.5.1}/uv.lock

@@ -360,7 +360,7 @@ wheels = [
 
 [[package]]
 name = "mvn-tree-visualizer"
-version = "1.4.0"
+version = "1.5.0"
 source = { editable = "." }
 dependencies = [
     { name = "jinja2" },

mvn_tree_visualizer-1.5.0/.github/instructions/copilot-instructions.md

@@ -1,92 +0,0 @@
-# GitHub Copilot Instructions for mvn-tree-visualizer
-
-## Project Overview
-This is a Python CLI tool that parses Maven dependency trees (`mvn dependency:tree` output) and generates interactive HTML diagrams (using Mermaid.js) or JSON outputs. The tool supports watch mode for real-time regeneration and has a modular architecture focused on error handling and user experience.
-
-## Architecture & Key Components
-
-### Core Flow
-1. **Input Validation** (`validation.py`) - Find and validate Maven dependency files
-2. **File Merging** (`get_dependencies_in_one_file.py`) - Combine multiple dependency files
-3. **Parsing** (`diagram.py`) - Read merged dependency tree
-4. **Output Generation** (`outputs/`) - Generate HTML (Mermaid.js) or JSON
-5. **Watch Mode** (`file_watcher.py`) - Monitor files for changes using watchdog
-
-### Module Structure
-```
-src/mvn_tree_visualizer/
-├── cli.py              # Entry point with comprehensive error handling
-├── exceptions.py       # Custom exception hierarchy
-├── validation.py       # File discovery and validation logic
-├── diagram.py          # Core dependency tree processing
-├── file_watcher.py     # Real-time file monitoring
-├── get_dependencies... # Multi-file merging logic
-├── TEMPLATE.py         # Jinja2 HTML template for Mermaid.js
-└── outputs/
-    ├── html_output.py  # Mermaid diagram generation
-    └── json_output.py  # Structured JSON output
-```
-
-## Development Conventions
-
-### Error Handling Pattern
-- Use custom exceptions from `exceptions.py`: `DependencyFileNotFoundError`, `DependencyParsingError`, `OutputGenerationError`
-- Provide actionable error messages with Maven commands and file paths
-- Follow the pattern in `cli.py:generate_diagram()` for comprehensive error handling
-
-### Testing Approach
-- Use pytest with descriptive test names like `test_convert_to_mermaid_deeper_tree()`
-- Test both positive cases and error conditions
-- Include realistic Maven dependency tree samples in test data
-- Run tests with: `uv run pytest tests/ -v`
-
-### Package Management
-- Uses `uv` as package manager - always use `uv run` for commands
-- Core dependencies: `jinja2` (templating), `watchdog` (file monitoring)
-- Entry point: `mvn-tree-visualizer` command maps to `cli:cli`
-
-### Code Quality
-- Lint with: `uv run ruff check .`
-- Type hints required throughout (project uses Python 3.13+)
-- Follow existing patterns for file validation and path handling
-
-## Critical Implementation Details
-
-### Maven Dependency Parsing
-- Input format: `[INFO] groupId:artifactId:type:version:scope` with tree structure using `+`, `|`, `\`
-- Handle both 4-part and 5-part dependency strings (see `html_output.py:_convert_to_mermaid`)
-- Depth calculation based on whitespace: `depth = len(parts[0].split(" ")) - 1`
-
-### File Discovery Pattern
-- Multi-file support: searches directory tree for `maven_dependency_file` (configurable)
-- Merges files from different Maven modules into single intermediate file
-- Validates file existence, permissions, and content before processing
-
-### Output Generation
-- HTML uses Mermaid.js with `graph LR` format
-- Version display controlled by `--show-versions` flag
-- JSON output maintains tree structure with parent-child relationships
-
-### Watch Mode Implementation
-- Uses watchdog library for cross-platform file monitoring
-- Monitors specific filename pattern across directory tree
-- Debounces changes and provides timestamped feedback
-
-## Common Development Tasks
-
-### Adding New Output Formats
-1. Create new module in `outputs/` directory
-2. Follow pattern from `html_output.py` and `json_output.py`
-3. Add format option to CLI and update `generate_diagram()` in `cli.py`
-
-### Error Message Improvements
-- All user-facing errors should include specific file paths and suggested Maven commands
-- Use `print_maven_help()` pattern for guiding users to generate dependency files
-- Test error scenarios in addition to happy path
-
-### Testing New Features
-- Include realistic Maven dependency trees in test data
-- Test both single-module and multi-module project scenarios
-- Verify error handling with invalid/missing files
-
-Remember: This tool processes Maven output files, not Maven projects directly. Users must run `mvn dependency:tree -DoutputFile=maven_dependency_file` first.