f9-Paste2Project 1.0.1

CLI tool to create folder structures from tree input

f9-Paste2Project

Paste your folder structure and generate the entire project instantly from the terminal.

Overview

f9-Paste2Project is a lightweight, cross-platform CLI utility that converts a pasted folder tree structure (like output from the tree command or AI-generated structures) into real files and directories on your system.

Instead of manually creating folders and files one by one, you can simply paste the structure and let f9 build the project for you automatically.

This is especially useful for quickly setting up new projects, recreating repository structures, testing layouts, and scaffolding your development environments.

Features

• Format Agnostic: Seamlessly handles clean Unix tree output, Windows tree /f output, and manually typed ASCII trees.
• Multiple Input Methods:
  • Interactive paste (stdin)
  • Read from file (-f structure.txt)
  • Read from clipboard (-c)
• Safe & Reversible: Includes a --dry-run mode to preview changes before they happen, and an --undo flag to quickly remove the last created structure.
• Cross-Platform: Works flawlessly on Windows, macOS, and Linux.

Installation

Install directly from PyPI using pip (Recommended):

pip install f9-Paste2Project

Once installed, the f9 command becomes available globally in your terminal.

Usage

Interactive Mode

Run the command:

f9

Paste your folder structure (e.g., from ChatGPT, documentation, or a tree command):

my-app/
├── src/
│   ├── index.js
│   └── app.js
├── public/
│   └── index.html
└── package.json

Finish Input:

• On Windows: Press CTRL + Z then ENTER.
• On Linux/macOS: Press CTRL + D.

Your project structure is now created instantly!

Advanced Commands

Usage:
  f9                        # Interactive mode: paste tree from stdin
  f9 -f structure.txt       # Read tree from a text file
  f9 -c                     # Read tree directly from your clipboard
  f9 --dry-run              # Preview the structure without creating anything
  f9 --undo                 # Remove the last created structure
  f9 -o /some/base/dir      # Output the structure to a specific base directory
  f9 -q                     # Quiet mode (no per-item output)
  f9 -v                     # Verbose mode (extra detail)
  f9 --log output.log       # Write execution log to a file

Example Output

DIR:  my-app
DIR:  my-app/src
FILE: my-app/src/index.js
FILE: my-app/src/app.js
DIR:  my-app/public
FILE: my-app/public/index.html
FILE: my-app/package.json

How It Works

The tool:

• Reads text input line by line.
• Detects indentation and nesting levels (supports standard tree-style syntax ├──, │, └──).
• Intelligently distinguishes between files and directories.
• Creates the physical folders and touches the files in their correct hierarchical locations.

License

This project is licensed under the MIT License.