🌳 tree2dir

tree2dir is a lightning-fast command-line tool that converts ASCII tree diagrams directly into actual file and folder structures.

Stop manually creating nested directories and files when scaffolding new projects. Just sketch your architecture in a text file, and let tree2dir build the entire structure in seconds.

✨ Features

• Zero Dependencies: Built entirely with Python's standard library.
• Smart Detection: Automatically distinguishes between folders and files.
• Deep Nesting: Accurately calculates indentation to create deeply nested structures.
• Idempotent: Safe to run multiple times; it won't overwrite existing files with the same name.

📦 Installation

Install easily via pip:

pip install tree2dir

🚀 Usage

1. Create a text file with your diagram (e.g., structure.txt):

Here is an example structure:

my_project/
├── data/
│   ├── raw/
│   └── processed/
├── notebooks/
│   ├── 01_EDA.ipynb
│   └── 02_model_training.ipynb
├── src/
│   ├── knn_classifier.py
│   └── svm_classifier.py
├── models/
├── README.md
└── requirements.txt

2. Run the command:

To generate the structure in your current directory, simply point the tool at your text file:

tree2dir structure.txt

To generate the structure in a specific destination folder, use the -d or --dest flag:

tree2dir structure.txt -d ./my_new_project

🛠️ Development & Contributing

If you want to contribute or modify the tool locally:

1. Clone the repository.
2. Install it in editable mode:

   pip install -e .
   

3. Test your changes using the CLI command tree2dir.