Metadata-Version: 2.4
Name: show-file-tree
Version: 0.0.1
Summary: A small, fast CLI tool to display styled file/folder trees with rich options.
Author: Rudra Prasad Bhuyan
Project-URL: Homepage, https://github.com/Rudra-G-23/show-file-tree
Project-URL: Bug Tracker, https://github.com/Rudra-G-23/show-file-tree/issues
Keywords: cli,tree,file,directory,rich,typer
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: Terminals
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: rich>=13.0.0
Requires-Dist: typer[all]>=0.9.0
Requires-Dist: pathspec>=0.11.0
Dynamic: license-file

# show-file-tree

A small, fast CLI tool to display styled file/folder trees with rich options, colors, icons, and metadata.

## Installation

You can install `show-file-tree` using `pip`:

```bash
pip install show-file-tree
````

## Quick Start

Navigate to any directory and run the command.

### Default Output:

    ```bash
    show-file-tree .
    ```




### Display with more details like size, counts, and limited depth:

    ```bash
    show-file-tree . -d 2 --size --count
    ```

### Export the tree to a Markdown file:

    ```bash
    show-file-tree /path/to/your/project --format md
    ```

This will create a `project-file-tree.md` file in your current directory.

## Features & Flags

`show-file-tree` offers a rich set of flags to customize the output.

* `-d, --max-depth`: Limit the recursion depth.
* `--gitignore / --no-gitignore`: Respect or ignore `.gitignore` files (default: respect).
* `--hidden`: Show hidden files and folders.
* `--sort {name,size}`: Sort the output by name or size.
* `--order {asc,desc}`: Set the sort order.
* `--format {tree,md}`: Output format (default: tree). Automatically falls back to `md` for very large trees.
* `--size`: Display file/folder sizes.
* `--count`: Display file/directory counts within folders.
* `--mtime-after, --mtime-before`: Filter by modification time.
* `--include, --exclude`: Filter by glob patterns.
* `--no-icons`: Render a plain ASCII tree.
* `--theme`: Apply a color theme (`colorful`, `monokai`, `light`, `nocolor`).
* `--top N`: List the top N files by size or modification time.
* `--about, --version`: Show package information.

## Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details on how to set up your development environment and submit pull requests.

## Author / Maintainer

Rudra Prasad Bhuyan

## License

This project is licensed under the MIT License - see the LICENSE file for details.


