Skip to main content

A CLI tool to generate a customizable directory tree while ignoring specified files and folders.

Project description

Directree

Directree is a command-line tool for generating a customizable directory tree of your projects while ignoring unimportant files and folders. It is designed to help developers visualize their project structures in a clean and organized manner.

Features

  • Customizable Ignoring: Specify project types (frontend, backend, machine learning) to automatically ignore common unimportant files and folders.
  • User Input: Allows users to specify additional files and folders to ignore, tailoring the output to their specific needs.
  • Recursive Directory Traversal: Generates a tree structure that reflects the actual organization of files and directories.
  • Cross-Platform Compatibility: Works seamlessly on Windows, macOS, and Linux.

Installation

To install Directree, you can use pip:

pip install directree

Usage

Once installed, you can run the tool directly from your command line:

Step-by-Step Instructions:

  • Project Type: Specify the type of your project (e.g., frontend, backend, ml, or skip).
  • Additional Folders: Optionally, provide a list of additional folders to ignore, separated by commas.
  • Additional Files: Optionally, provide a list of additional files to ignore, separated by commas.
  • Root Directory: Enter the path of the root directory for which you want to generate the tree. Press enter to use the current directory.

Example Output

Here’s an example of how Directree generates a directory tree:

Customizing Ignore Patterns

You can customize the files and folders that are ignored based on your project type and specific needs. For example, if your project is a frontend web application, you might want to ignore folders like node_modules, .firebase, and specific files like package-lock.json.

Contributing Contributions are welcome! If you have suggestions or improvements, please feel free to submit a pull request or create an issue.

Fork the repository. Create your feature branch (git checkout -b feature/AmazingFeature). Commit your changes (git commit -m 'Add some AmazingFeature'). Push to the branch (git push origin feature/AmazingFeature). Open a pull request. License Distributed under the MIT License. See LICENSE for more information.

Acknowledgements Setuptools - For packaging the project Twine - For uploading the package to PyPI Python - The programming language used to create Directree vbnet Copy code

Key Formatting Notes:

  • Use Markdown syntax for headings, lists, and code blocks for clarity.
  • Replace image URLs with actual links to images that showcase your project, if available.
  • Ensure the document is structured with clear sections for ease of navigation.

This README.md file will serve as a comprehensive guide for users who want to understand and use your directree tool effectively.

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

directree-0.3.tar.gz (2.7 kB view details)

Uploaded Source

Built Distribution

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

directree-0.3-py3-none-any.whl (2.7 kB view details)

Uploaded Python 3

File details

Details for the file directree-0.3.tar.gz.

File metadata

  • Download URL: directree-0.3.tar.gz
  • Upload date:
  • Size: 2.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.1

File hashes

Hashes for directree-0.3.tar.gz
Algorithm Hash digest
SHA256 57126b9105172ffaf556967e38a1650ae06af4f4f4cf19fe1ce0eca139d74ead
MD5 73f56ecae853e5a09a2372617303b2fc
BLAKE2b-256 4d4e10ac1cac9ec0845e261445e7952ec5eb3ac8014a2c287dbf68389b398bb1

See more details on using hashes here.

File details

Details for the file directree-0.3-py3-none-any.whl.

File metadata

  • Download URL: directree-0.3-py3-none-any.whl
  • Upload date:
  • Size: 2.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.1

File hashes

Hashes for directree-0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 6c9d14d0f345d8216d26e417b55a68d446672c549074c37a56f1a88301b441f7
MD5 3f533b827cb8f414cfe3c4c9d52c5bb7
BLAKE2b-256 360c52adc38ae1cc113fbb924161a8625e525543c4c0810b21f1fb0eff224e13

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