A Python CLI tool to generate directory tree structures
Project description
# 🌳 treegrenix
**treegrenix** is a lightweight Python CLI tool to beautifully display the directory structure of your projects or folders — just like the classic `tree` command but written in Python, customizable and clean.
---
## ✨ Features
- 📁 Generate a visual tree structure of any folder
- ❌ Exclude specific files or folders (like `venv`, `__pycache__`, etc.)
- 💻 Simple command-line usage
- 🧼 Ignores hidden files and folders by default
- 🛠️ Open-source and MIT licensed
---
## 🔧 Installation
You can install `treegrenix` directly from [PyPI](https://pypi.org/project/treegrenix/):
```bash
pip install treegrenix
🚀 Usage
After installation, use the CLI tool with the command:
treegenix [path] [--exclude item1 item2 ...]
🔹 Examples
1. View the tree of the current directory:
treegenix
2. View the tree of a specific folder:
treegenix my_project/
3. Exclude specific files or folders:
treegenix . --exclude venv __pycache__
This will generate output like:
```
my_project/
├── app/
│ ├── __init__.py
│ └── main.py
├── README.md
└── requirements.txt
```
💡 Why use treegrenix?
- Great for README file directory listings
- Simple and Pythonic — no external C-based tools required
- Customizable via command-line options
🛠️ Development
Clone the repo if you'd like to contribute:
git clone https://github.com/sujal-1245/treegrenix.git
cd treegrenix
python -m treegenix .
🗿 Made by
Sujal Bhagat GitHub
📄 License
This project is licensed under the MIT License.
---
MIT License
Copyright (c) 2023 Sujal Bhagat
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
treegenix-0.1.0.tar.gz
(3.9 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file treegenix-0.1.0.tar.gz.
File metadata
- Download URL: treegenix-0.1.0.tar.gz
- Upload date:
- Size: 3.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
729f889b07016d8d329a2378861c26f599c11be0d9adc3cec30dbbcbce8b592c
|
|
| MD5 |
0cf2ce892600b696f9d2a61c6769ab21
|
|
| BLAKE2b-256 |
4a5512cda356b75efe6d0f675c35444ca2383122e29f833674c0d95c1970eaba
|
File details
Details for the file treegenix-0.1.0-py3-none-any.whl.
File metadata
- Download URL: treegenix-0.1.0-py3-none-any.whl
- Upload date:
- Size: 4.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ab9f9ad617a9c7b08ecebad981b722f84dc8d36d3a661f8996405350c37ac3cf
|
|
| MD5 |
77f828c797893a8f6333186180fa919e
|
|
| BLAKE2b-256 |
a84e6afaccdbfc576a6ca90fbab4788fd2700f257dfa8d7db0bc31c360e54d45
|