#directory-tree #directory #directory-structure #tree #terminal #cli #command-line-tool

app fx

fx is a command-line tool that lists directory in a formatted output. It supports filtering by files 📄 or directories 📁 and displays a tree-like structure 🌳 for easy navigation.

1 unstable release

0.2.0 Jan 3, 2025
0.1.0 Jan 3, 2025

#239 in Development tools

Download history 5/week @ 2024-09-25 242/week @ 2025-01-01 10/week @ 2025-01-08

252 downloads per month

MIT license

13KB
204 lines

fx

fx is a command-line utility for displaying directory contents in a visually structured and color-coded format. By default, it lists all files and directories in the current directory. Spider supports various options, allowing users to filter the output to show only files or directories, and also provides a tree-like view of the directory structure.

Installation

Using Cargo

To install Spider, use the following command:

cargo install fx

This will compile and install Spider from the source.

Making It Available Globally

To install Spider globally (for Windows), use the --init flag:

fx --init

NOTE: Administrative privileges are required for this operation.

Usage

Once installed, you can use the following commands to interact with Spider.

Listing Files and Directories

To list the contents of the current directory, run:

fx

This will list all the files and directories

Show Only Directories

To list only directories, use the -d flag:

fx -d

Show Only Files

To list only files, use the -f flag:

fx -f

Display Directory Tree

To display the directory structure in a tree-like format, use the crawl command:

fx crawl

You can also specify a path:

fx crawl /path/to/directory

Deployment

To deploy Spider, follow these steps:

  1. Build the release version:

    cargo build --release
    
  2. Publish to Cargo:

    First, log in to Cargo:

    cargo login 
    

    Then publish the tool:

    cargo publish
    

Contributing

Contributions are welcome! If you'd like to contribute to Spider, please follow these steps:

  1. Fork the repository.
  2. Create a feature branch.
  3. Make your changes.
  4. Commit your changes.
  5. Push to your branch.
  6. Open a pull request with a description of your changes.

License

MIT. See LICENSE for more details.

Dependencies

~4–11MB
~109K SLoC