Skip to main content

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


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)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

treegenix-0.1.0-py3-none-any.whl (4.3 kB view details)

Uploaded Python 3

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

Hashes for treegenix-0.1.0.tar.gz
Algorithm Hash digest
SHA256 729f889b07016d8d329a2378861c26f599c11be0d9adc3cec30dbbcbce8b592c
MD5 0cf2ce892600b696f9d2a61c6769ab21
BLAKE2b-256 4a5512cda356b75efe6d0f675c35444ca2383122e29f833674c0d95c1970eaba

See more details on using hashes here.

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

Hashes for treegenix-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ab9f9ad617a9c7b08ecebad981b722f84dc8d36d3a661f8996405350c37ac3cf
MD5 77f828c797893a8f6333186180fa919e
BLAKE2b-256 a84e6afaccdbfc576a6ca90fbab4788fd2700f257dfa8d7db0bc31c360e54d45

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page