PrintStruct

PrintStruct is a clean, lightweight Python CLI that prints a directory tree of your project while respecting .gitignore, with optional zipping support.

The problems it solves:

• sharing project structure in issues or pull requests
• generating directory trees for documentation
• pasting project layouts into LLMs
• zipping projects for feeding to LLMs using .gitignore directions

Quick Start (10 seconds)

Installation using pip (recommended):

Run this command in your terminal:

pip install printstruct

Usage:

Open a terminal in any project and run:

prst

This prints the directory structure of the current folder.

You can also specify a path explicitly:

prst <directory_path>

Example (Windows PowerShell):

PS C:/Users/Projects/PrintStruct> prst .

Output:

PrintStruct
├─ LICENSE
├─ pyproject.toml
├─ README.md
├─ requirements.txt
└─ structure.py

Updating PrintStruct:

To update the tool, reinstall it using pip. Pip will automatically replace the older version with the latest release.

Useful CLI arguments

In addition to the directory path, the following options are available:

Installation (for Contributors)

Clone the repository:

git clone https://github.com/ShahzaibAhmad05/PrintStruct

Move into the project directory:

cd PrintStruct

Install dependencies:

pip install -r requirements.txt

The tool is now available as a Python CLI on your system.

Contributions

Issues and pull requests are welcome. Ideas that would fit well include improved formatting, colorized output, test coverage, and performance optimizations.

PrintStruct is intentionally small and readable, so contributions that preserve simplicity are especially appreciated.