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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
57126b9105172ffaf556967e38a1650ae06af4f4f4cf19fe1ce0eca139d74ead
|
|
| MD5 |
73f56ecae853e5a09a2372617303b2fc
|
|
| BLAKE2b-256 |
4d4e10ac1cac9ec0845e261445e7952ec5eb3ac8014a2c287dbf68389b398bb1
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6c9d14d0f345d8216d26e417b55a68d446672c549074c37a56f1a88301b441f7
|
|
| MD5 |
3f533b827cb8f414cfe3c4c9d52c5bb7
|
|
| BLAKE2b-256 |
360c52adc38ae1cc113fbb924161a8625e525543c4c0810b21f1fb0eff224e13
|