mvn-tree-visualizer 1.2.0__tar.gz → 1.3.0__tar.gz

mvn_tree_visualizer-1.3.0/.github/FUNDING.yml

@@ -0,0 +1,13 @@
+# These are supported funding model platforms
+
+github: # Replace with a single GitHub username or organization
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: irakliskonsoulas
+tidelift: # Replace with a single Tidelift package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

mvn_tree_visualizer-1.3.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,36 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Run command '...'
+2. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Maven dependency tree sample**
+Please provide a sample of your Maven dependency tree output:
+```
+[paste your maven dependency tree here]
+```
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Environment:**
+- OS: [e.g. Windows 10, macOS, Ubuntu 20.04]
+- Python version: [e.g. 3.13]
+- Package version: [e.g. 1.2.0]
+- Maven version: [e.g. 3.8.1]
+
+**Additional context**
+Add any other context about the problem here.

mvn_tree_visualizer-1.3.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,22 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Use case**
+Describe how this feature would be used and who would benefit from it.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

mvn_tree_visualizer-1.3.0/.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,21 @@
+---
+name: Question
+about: Ask a question about usage or functionality
+title: '[QUESTION] '
+labels: question
+assignees: ''
+---
+
+**Question**
+What would you like to know?
+
+**Context**
+Provide any relevant context about your use case or what you're trying to achieve.
+
+**What you've tried**
+If applicable, describe what you've already tried.
+
+**Environment (if relevant):**
+- OS: [e.g. Windows 10, macOS, Ubuntu 20.04]
+- Python version: [e.g. 3.13]
+- Package version: [e.g. 1.2.0]

mvn_tree_visualizer-1.3.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,30 @@
+## Description
+Brief description of the changes made in this PR.
+
+## Type of Change
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Code refactoring
+- [ ] Performance improvement
+- [ ] Other (please describe):
+
+## Testing
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] I have tested the CLI functionality manually
+
+## Checklist
+- [ ] My code follows the project's style guidelines
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have updated the CHANGELOG.md file (if applicable)
+
+## Screenshots (if applicable)
+Add screenshots to help explain your changes.
+
+## Additional Notes
+Any additional information that would be helpful for reviewers.

mvn_tree_visualizer-1.3.0/.github/SECURITY.md

@@ -0,0 +1,51 @@
+# Security Policy
+
+## Supported Versions
+
+We actively support the following versions of mvn-tree-visualizer:
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.2.x   | :white_check_mark: |
+| 1.1.x   | :white_check_mark: |
+| 1.0.x   | :x:                |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in mvn-tree-visualizer, please report it to us responsibly.
+
+### How to Report
+
+1. **Do not create a public GitHub issue** for security vulnerabilities
+2. **Email us directly** at: dyka3773@gmail.com
+3. **Include the following information:**
+   - Description of the vulnerability
+   - Steps to reproduce
+   - Affected versions
+   - Potential impact
+   - Suggested fix (if available)
+
+### Response Timeline
+
+- **Acknowledgment**: We will acknowledge receipt of your report as soon as possible (usually within 48 hours)
+- **Assessment**: We will assess the vulnerability within 7 days
+- **Fix**: We will work on a fix and release it as soon as possible
+- **Credit**: We will credit you in the security advisory (unless you prefer to remain anonymous)
+
+### Security Best Practices
+
+When using mvn-tree-visualizer:
+
+1. **Keep updated**: Always use the latest version
+2. **Validate inputs**: Be cautious with dependency files from untrusted sources
+3. **File permissions**: Ensure proper file permissions on generated outputs
+4. **CI/CD**: Use in secure CI/CD environments
+
+### Scope
+
+This security policy applies to:
+- The mvn-tree-visualizer Python package
+- Official GitHub repository
+- Documentation and examples
+
+Thank you for helping keep mvn-tree-visualizer secure!

mvn_tree_visualizer-1.3.0/.github/dependabot.yml

@@ -0,0 +1,26 @@
+version: 2
+updates:
+  # Enable version updates for Python dependencies
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+    commit-message:
+      prefix: "deps"
+      prefix-development: "deps-dev"
+    labels:
+      - "dependencies"
+      - "python"
+  
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "ci"
+    labels:
+      - "dependencies"
+      - "github-actions"

mvn_tree_visualizer-1.3.0/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [ master, develop ]
+  pull_request:
+    branches: [ master, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.13"]
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .
+        pip install pytest ruff
+    
+    - name: Run linter
+      run: ruff check src/ tests/
+    
+    - name: Run tests
+      run: pytest -v
+    
+    - name: Test CLI
+      run: |
+        python -m mvn_tree_visualizer --help

{mvn_tree_visualizer-1.2.0 → mvn_tree_visualizer-1.3.0}/.gitignore

@@ -18,6 +18,14 @@ lib/
 lib64/
 parts/
 sdist/
+
+# Project specific - only ignore in root directory
+/dependency_tree.txt
+/maven_dependency_file
+/diagram.html
+/dependencies.json
+/*.svg
+
 var/
 wheels/
 share/python-wheels/
@@ -179,7 +187,7 @@ cython_debug/
 #  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
 #  and can be added to the global gitignore or merged into this file. However, if you prefer, 
 #  you could uncomment the following to ignore the entire vscode folder
-# .vscode/
+.vscode/
 
 # Ruff stuff:
 .ruff_cache/

{mvn_tree_visualizer-1.2.0 → mvn_tree_visualizer-1.3.0}/CHANGELOG.md

@@ -7,6 +7,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- Placeholder for future features
+
+## [1.3.0] - 2025-07-09
+
+### Added
+- Watch mode functionality with `--watch` flag for automatic diagram regeneration
+- File system monitoring using watchdog library for real-time updates
+- New file_watcher module for decoupled file monitoring logic
+- Enhanced error handling system with comprehensive user guidance
+  - Clear error messages for missing dependency files with helpful Maven commands
+  - Specific validation for directories, file permissions, and content
+  - Detailed diagnostics for parsing errors and empty files
+  - User-friendly error messages with emojis and actionable suggestions
+- Custom exception classes for better error categorization
+- Comprehensive test coverage for error scenarios
+
+### Changed
+- **BREAKING**: JSON output now uses simplified package names (artifact-id only) to match HTML output behavior
+  - Root packages now show as "my-app" instead of "com.example:my-app"
+  - Ensures consistency between HTML and JSON output formats
+- Refactored CLI module to separate concerns and improve maintainability
+- Improved error handling with timestamped console output and graceful failure modes
+- Enhanced file processing with better encoding handling (UTF-8) and validation
+- Updated dependency file merging logic with better error detection
+
+### Fixed
+- Removed unused imports and improved code organization
+- Fixed intermediate file path handling in diagram generation
+
 ## [1.2.0] - 2025-07-09
 
 ### Added

mvn_tree_visualizer-1.3.0/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: mvn-tree-visualizer
+Version: 1.3.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: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: watchdog>=6.0.0
+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)
+![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)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+
+A simple command-line tool to visualize the dependency tree of a Maven project in a graphical and interactive format.
+
+This tool was born out of the frustration of not being able to easily visualize the dependency tree of a Maven project. The `mvn dependency:tree` command is great, but the output can be hard to read, especially for large projects. This tool aims to solve that problem by providing a simple way to generate an interactive diagram or a structured JSON output of the dependency tree.
+
+## Table of Contents
+- [Features](#features)
+- [Installation](#installation)
+- [How to Use](#how-to-use)
+- [Examples](#examples)
+- [Options](#options)
+- [Performance](#performance)
+- [Troubleshooting](#troubleshooting)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Installation
+
+Install the package from PyPI:
+
+```bash
+pip install mvn-tree-visualizer
+```
+
+## Features
+
+- **🌐 Multiple Output Formats:**
+  - **HTML:** Generates an interactive HTML diagram of your dependency tree using Mermaid.js.
+  - **JSON:** Creates a structured JSON representation of the dependency tree, perfect for scripting or integration with other tools.
+- **🔄 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.
+- **💾 SVG Export:** Download the generated diagram as an SVG file directly from the HTML page.
+
+## How to Use
+
+### Step 1: Generate the dependency file
+
+Run the following command in your terminal at the root of your Maven project. This will generate a file named `maven_dependency_file` in each module's `target` directory.
+
+```bash
+mvn dependency:tree -DoutputFile=maven_dependency_file -DappendOutput=true
+```
+
+> **💡 Tip:** You can add other options like `-Dincludes="org.example"` to filter the dependencies.
+
+### Step 2: Visualize the dependency tree
+
+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
+```
+
+#### JSON Output (Structured Data)
+```bash
+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
+```
+
+#### JSON Output with Versions
+```bash
+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
+```
+
+> **💡 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
+
+- **HTML:** Open the generated `diagram.html` file in your web browser to view the interactive dependency tree.
+- **JSON:** Use the `dependencies.json` file in your scripts or other tools.
+
+## Examples
+
+Check out the [`examples/`](examples/) directory for sample Maven dependency files and their outputs:
+
+- **Simple Project**: Basic Spring Boot application with common dependencies
+- **Complex Project**: Realistic microservice with comprehensive dependencies
+
+Each example includes:
+- Sample Maven dependency tree file
+- Generated HTML and JSON outputs
+- Usage instructions
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--filename` | The name of the file containing the Maven dependency tree | `maven_dependency_file` |
+| `--output` | The name of the output file | `diagram.html` |
+| `--format` | The output format (`html` or `json`) | `html` |
+| `--show-versions` | Show dependency versions in the diagram | `False` |
+| `--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` |
+| `--help` | Show the help message and exit | - |
+
+## Performance
+
+**For Large Projects:**
+- Consider filtering dependencies at the Maven level using `-Dincludes` or `-Dexcludes` parameters
+- The tool can handle projects with hundreds of dependencies efficiently
+
+**Memory Usage:**
+- Memory usage scales with the number of dependencies
+- Typical projects (50-200 dependencies) use minimal memory
+- Very large projects (1000+ dependencies) may require more memory
+
+## Troubleshooting
+
+### Common Issues
+
+**"No dependency files found"**
+- The tool now provides detailed guidance including:
+  - Exact directory searched and filename expected
+  - Maven commands to generate dependency files
+  - Instructions to ensure you're in a directory with pom.xml
+
+**"Empty or invalid output"**
+- Enhanced error messages now include:
+  - Specific error details (encoding, permissions, empty files)
+  - Validation of file content and format
+  - Suggestions for fixing common parsing issues
+
+**"Browser doesn't display the diagram"**
+- Ensure you're opening the HTML file in a modern browser
+- Check browser console for JavaScript errors
+- Try a different browser (Chrome, Firefox, Safari)
+
+**"Permission denied errors"**
+- Improved diagnostics for:
+  - Directory read/write permissions
+  - File access issues
+  - Output directory creation problems
+
+### Getting Help
+
+- Check the [examples](examples/) directory for working samples
+- Review the [issues](https://github.com/dyka3773/mvn-tree-visualizer/issues) page
+- Create a new issue with your Maven dependency file sample
+
+## Contributing
+
+Contributions are welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request.
+
+Please read our [CONTRIBUTING.md](CONTRIBUTING.md) file for more details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

mvn_tree_visualizer-1.3.0/README.md

@@ -0,0 +1,170 @@
+# 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)
+![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)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+
+A simple command-line tool to visualize the dependency tree of a Maven project in a graphical and interactive format.
+
+This tool was born out of the frustration of not being able to easily visualize the dependency tree of a Maven project. The `mvn dependency:tree` command is great, but the output can be hard to read, especially for large projects. This tool aims to solve that problem by providing a simple way to generate an interactive diagram or a structured JSON output of the dependency tree.
+
+## Table of Contents
+- [Features](#features)
+- [Installation](#installation)
+- [How to Use](#how-to-use)
+- [Examples](#examples)
+- [Options](#options)
+- [Performance](#performance)
+- [Troubleshooting](#troubleshooting)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Installation
+
+Install the package from PyPI:
+
+```bash
+pip install mvn-tree-visualizer
+```
+
+## Features
+
+- **🌐 Multiple Output Formats:**
+  - **HTML:** Generates an interactive HTML diagram of your dependency tree using Mermaid.js.
+  - **JSON:** Creates a structured JSON representation of the dependency tree, perfect for scripting or integration with other tools.
+- **🔄 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.
+- **💾 SVG Export:** Download the generated diagram as an SVG file directly from the HTML page.
+
+## How to Use
+
+### Step 1: Generate the dependency file
+
+Run the following command in your terminal at the root of your Maven project. This will generate a file named `maven_dependency_file` in each module's `target` directory.
+
+```bash
+mvn dependency:tree -DoutputFile=maven_dependency_file -DappendOutput=true
+```
+
+> **💡 Tip:** You can add other options like `-Dincludes="org.example"` to filter the dependencies.
+
+### Step 2: Visualize the dependency tree
+
+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
+```
+
+#### JSON Output (Structured Data)
+```bash
+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
+```
+
+#### JSON Output with Versions
+```bash
+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
+```
+
+> **💡 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
+
+- **HTML:** Open the generated `diagram.html` file in your web browser to view the interactive dependency tree.
+- **JSON:** Use the `dependencies.json` file in your scripts or other tools.
+
+## Examples
+
+Check out the [`examples/`](examples/) directory for sample Maven dependency files and their outputs:
+
+- **Simple Project**: Basic Spring Boot application with common dependencies
+- **Complex Project**: Realistic microservice with comprehensive dependencies
+
+Each example includes:
+- Sample Maven dependency tree file
+- Generated HTML and JSON outputs
+- Usage instructions
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--filename` | The name of the file containing the Maven dependency tree | `maven_dependency_file` |
+| `--output` | The name of the output file | `diagram.html` |
+| `--format` | The output format (`html` or `json`) | `html` |
+| `--show-versions` | Show dependency versions in the diagram | `False` |
+| `--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` |
+| `--help` | Show the help message and exit | - |
+
+## Performance
+
+**For Large Projects:**
+- Consider filtering dependencies at the Maven level using `-Dincludes` or `-Dexcludes` parameters
+- The tool can handle projects with hundreds of dependencies efficiently
+
+**Memory Usage:**
+- Memory usage scales with the number of dependencies
+- Typical projects (50-200 dependencies) use minimal memory
+- Very large projects (1000+ dependencies) may require more memory
+
+## Troubleshooting
+
+### Common Issues
+
+**"No dependency files found"**
+- The tool now provides detailed guidance including:
+  - Exact directory searched and filename expected
+  - Maven commands to generate dependency files
+  - Instructions to ensure you're in a directory with pom.xml
+
+**"Empty or invalid output"**
+- Enhanced error messages now include:
+  - Specific error details (encoding, permissions, empty files)
+  - Validation of file content and format
+  - Suggestions for fixing common parsing issues
+
+**"Browser doesn't display the diagram"**
+- Ensure you're opening the HTML file in a modern browser
+- Check browser console for JavaScript errors
+- Try a different browser (Chrome, Firefox, Safari)
+
+**"Permission denied errors"**
+- Improved diagnostics for:
+  - Directory read/write permissions
+  - File access issues
+  - Output directory creation problems
+
+### Getting Help
+
+- Check the [examples](examples/) directory for working samples
+- Review the [issues](https://github.com/dyka3773/mvn-tree-visualizer/issues) page
+- Create a new issue with your Maven dependency file sample
+
+## Contributing
+
+Contributions are welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request.
+
+Please read our [CONTRIBUTING.md](CONTRIBUTING.md) file for more details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.