#file-tree #tree #directory #path #visualization #cli-tool #cli

app pathy

A CLI tool to display the file tree of a directory

2 stable releases

new 1.0.1 Jun 22, 2024

#145 in Filesystem

Download history 168/week @ 2024-06-20

168 downloads per month

MIT license

7KB
92 lines

pathy 🦀

Minimal Rust CLI tool to display directory structures

version badge maintenance status badge: as-is

pathy example screenshot

Features

  • 🧠 Smart Display: Automatically excludes commonly ignored directories (e.g .git and node_modules) for a cleaner tree visualization.
  • 👨‍🦯 Easy Exclusions: Use the -i option to seamlessly omit any specific directories & files from the display.

Install

via Cargo

cargo install pathy

via Source

git clone https://github.com/fearandesire/pathy.git
cd pathy
cargo build --release
cargo install .

Usage

Basic usage: pathy <directory>

Arguments

  • <directory>: Directory to display. Defaults to the current directory.
  • -i, or --ignore: Specify directories or files to ignore`
  • -h, or --help: Display this help message
  • -v, or --version: Display the current version

Default Ignored Directories

You can review the default ignored directories here

Examples

pathy .
# Ignoring a directory
pathy -i docs
# Ignoring multiple directories
pathy -i docs node_modules .
# Ignore a directory and a any file 
pathy -i docs README.md

Notice: Ignoring a directory / a file will explicitly exclude any exact match. E.g, ignoring -i README.md will ignore README.md from the file tree visualization entirely, no matter how far down it is.

Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues to improve the functionality or documentation of pathy.

License

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

Author

Dependencies

~1.3–9MB
~76K SLoC