Skip to content

Releases: michele-bisignano/Tree-Generator

v1.1.0 - Automation & CLI Update

28 Jan 11:48

Choose a tag to compare

Project Tree Generator just got smarter.

Following the initial release, this update introduces powerful automation workflows and command-line flexibility, making it a professional-grade tool for any development environment (Windows, macOS, Linux).

🚀 What's New

🔄 Automation (Set & Forget)

  • Introduced setup_hook.py: A cross-platform installer that sets up a Git Pre-commit Hook.
  • Living Documentation: Your directory tree now updates automatically every time you commit. No more manual scripts!
  • Cross-Platform: The hook intelligently detects whether to use python or python3, ensuring compatibility across Windows, macOS, and Linux.

🎛 CLI Power (Command Line Interface)

You can now control the script execution with arguments:

  • --depth <n>: Limit the recursion depth (perfect for large monorepos).
  • --output <path>: Specify a custom output file location.
  • --root <path>: Manually force a specific project root.

🧠 Smarter Logic

  • Improved Root Detection: More robust logic to find the project root from any subdirectory.
  • Enhanced Gitignore Parsing: Better handling of folder-specific rules and relative paths.

📦 How to Update

If you already have the script, simply replace the Tools/ folder with the new files.
To enable automation, run the setup once:

# Windows / Linux / macOS
python Tools/setup_hook.py

👥 Authors

Michele Bisignano & Mattia Franchini

Project Tree Generator: Initial Release

28 Jan 10:29
6845748

Choose a tag to compare

Project Tree Generator v1.0.0

We are proud to announce the first official release of Project Tree Generator, a Python utility designed to automate the creation of "living documentation" for project architectures.

Stop manually updating your directory structures in Markdown. This script ensures your documentation stays synchronized with your actual file system, keeping it clean, visual, and accurate.

✨ Key Features

  • Smart Root Detection: Automatically locates the project root by searching for .git or .gitignore files, regardless of where the script is executed.
  • Gitignore Integration: Fully respects your project's exclusion rules to prevent technical artifacts like venv, __pycache__, or node_modules from cluttering your documentation.
  • Markdown Ready: Generates clean, visually formatted trees wrapped in Markdown code blocks for immediate rendering on GitHub and GitLab.

📦 Getting Started

  1. Place the generate_tree.py script into your project's Tools/ directory.
  2. Run the script from your terminal:
python Tools/generate_tree.py

By default, the output is generated at Docs/Project_Structure/repository_tree.md.


👥 Author

Developed by:

  • Michele Bisignano