Seedling-tools 2.1.0__tar.gz

seedling_tools-2.1.0/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: Seedling-tools
+Version: 2.1.0
+Summary: A 3-in-1 CLI toolkit to explore, search, and reconstruct directory structures with LLM-ready context support.
+Author: Blue Peach
+Project-URL: Homepage, https://github.com/bbpeaches/Seedling
+Project-URL: Issues, https://github.com/bbpeaches/Seedling/issues
+Keywords: cli,directory-tree,llm-context,scaffolding,developer-tools
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow>=9.0.0
+
+# 🌲 Seedling (v2.1.0)
+
+[![Seedling CI](https://github.com/bbpeaches/Seedling/actions/workflows/ci.yml/badge.svg)](https://github.com/bbpeaches/Seedling/actions/workflows/ci.yml)
+
+**Seedling** is a high-performance, 3-in-1 CLI toolkit designed for developers to explore, search, and reconstruct directory structures. Whether you need a beautiful image of your project architecture or a way to spawn a project from a text blueprint, Seedling has you covered.
+
+---
+
+## 🚀 Key Features
+
+* **Context Rehydration 🌟**: Generate a project snapshot using `scan --full`, and use `build` to flawlessly restore the *entire* directory structure along with the original source code.
+* **Scan & Export**: Export directory trees to `Markdown`, `Plain Text`, or high-fidelity `PNG` images with full Chinese character support.
+* **Smart Search**: Dual-mode search featuring **Exact Match** and **Fuzzy Suggestions** (powered by Levenshtein distance) with in-tree `🎯 [MATCHED]` visual highlights.
+* **Reverse Scaffolding**: Use the `build` command to read any tree diagram (even those copied from a README) and instantly recreate the folder/file hierarchy.
+* **Progressive UI**: Dynamic "pulsing" progress bars for scanning and real-time construction logs for building.
+* **Interactive Personality**: Built-in session-based "Easter Eggs" that respond to your terminal behavior (Mac/Linux exclusive).
+
+---
+
+## 🛠️ Installation
+
+Seedling is designed to be installed globally via `pipx` for a clean, isolated environment.
+
+### One-Click Setup (Self-Destructing Installers)
+
+Our installers set up the environment, install the tool, and then delete themselves to keep your workspace tidy.
+
+* **Windows**: Run `install.bat`
+* **macOS / Linux**: Run `chmod +x install.sh && ./install.sh`
+
+### Developer / Manual Install
+
+If you are modifying the source code, use **Editable Mode**:
+
+```bash
+pipx install -e . --force
+```
+
+---
+
+## 📖 CLI Reference
+
+### 1. `scan` - The Explorer
+
+Used for scanning directories or searching for items.
+
+| Flag | Short | Description |
+| --- | --- | --- |
+| `--find` | `-f` | **Search Mode**. Returns exact and fuzzy matches + a saved report. |
+| `--format` | `-F` | Output format: `md` (default), `txt`, or `image`. |
+| `--depth` | `-d` | Max recursion depth to prevent terminal "walls of text." |
+| `--exclude` | `-e` | List of folders to ignore (e.g., `node_modules .git venv`). |
+| `--outdir` | `-o` | Where to save the result (Defaults to your current terminal path). |
+| `--full` | - | **Power Mode**. Appends the full text content of all scanned source files to the output. |
+
+**Examples:**
+
+```bash
+# Export current directory as a PNG image
+scan . -F image
+
+# Fuzzy search for a mispelled config file
+scan ~/Projects -f "conifg"
+
+# Complex scan: exclude heavy folders, show hidden, save to Desktop
+scan . -s -e node_modules -o ~/Desktop -n project_map.md
+
+# 🌟 POWER MODE: Export tree + all source code for LLMs (excluding caches)
+scan . --full -e node_modules __pycache__ .git
+```
+
+### 2. `build` - The Architect
+
+A dedicated command to turn a text-based tree into a real file system, or restore a project from a snapshot.
+
+| Flag | Short | Description |
+| --- | --- | --- |
+| `--check` | `-c` | **Dry-Run Mode**. Simulates the build and reports missing/existing items. |
+| `--force` | `-f` | **Force Mode**. Overwrites existing files without skipping. |
+| `--direct` | `-d` | **Direct Mode**. Bypasses prompts to instantly create a specific file/folder path. |
+
+**Examples:**
+
+```bash
+# Build in current directory using a simple blueprint
+build blueprint.md
+
+# 🪄 RESTORE MAGIC: Reconstruct an entire project with source code from a --full scan
+build project_snapshot.md ~/Desktop/RestoredProject
+
+# Dry-run a blueprint to safely check what will be created
+build blueprint.txt --check
+
+# Directly scaffold a folder without prompts
+build -d ~/Desktop/NewProject
+```
+
+---
+
+## 📂 Project Structure
+
+```text
+Seedling/
+├── pyproject.toml      <- Modern build configuration
+├── install.sh/bat      <- Auto-installers
+├── test_suite.sh       <- Auto-tests
+└── scan_tool/
+    ├── __init__.py     <- Metadata & versioning
+    ├── __main__.py     <- Module entry point
+    ├── cli.py          <- Logic for 'scan' and 'build' commands
+    ├── scanner.py      <- Search and scanning engine
+    ├── builder.py      <- Scaffolding and reverse-build engine
+    ├── exporter.py     <- Image rendering & OS-specific fonts
+    └── utils.py        <- Session logic, animations, and smart-parsing
+
+```

seedling_tools-2.1.0/README.md

@@ -0,0 +1,116 @@
+# 🌲 Seedling (v2.1.0)
+
+[![Seedling CI](https://github.com/bbpeaches/Seedling/actions/workflows/ci.yml/badge.svg)](https://github.com/bbpeaches/Seedling/actions/workflows/ci.yml)
+
+**Seedling** is a high-performance, 3-in-1 CLI toolkit designed for developers to explore, search, and reconstruct directory structures. Whether you need a beautiful image of your project architecture or a way to spawn a project from a text blueprint, Seedling has you covered.
+
+---
+
+## 🚀 Key Features
+
+* **Context Rehydration 🌟**: Generate a project snapshot using `scan --full`, and use `build` to flawlessly restore the *entire* directory structure along with the original source code.
+* **Scan & Export**: Export directory trees to `Markdown`, `Plain Text`, or high-fidelity `PNG` images with full Chinese character support.
+* **Smart Search**: Dual-mode search featuring **Exact Match** and **Fuzzy Suggestions** (powered by Levenshtein distance) with in-tree `🎯 [MATCHED]` visual highlights.
+* **Reverse Scaffolding**: Use the `build` command to read any tree diagram (even those copied from a README) and instantly recreate the folder/file hierarchy.
+* **Progressive UI**: Dynamic "pulsing" progress bars for scanning and real-time construction logs for building.
+* **Interactive Personality**: Built-in session-based "Easter Eggs" that respond to your terminal behavior (Mac/Linux exclusive).
+
+---
+
+## 🛠️ Installation
+
+Seedling is designed to be installed globally via `pipx` for a clean, isolated environment.
+
+### One-Click Setup (Self-Destructing Installers)
+
+Our installers set up the environment, install the tool, and then delete themselves to keep your workspace tidy.
+
+* **Windows**: Run `install.bat`
+* **macOS / Linux**: Run `chmod +x install.sh && ./install.sh`
+
+### Developer / Manual Install
+
+If you are modifying the source code, use **Editable Mode**:
+
+```bash
+pipx install -e . --force
+```
+
+---
+
+## 📖 CLI Reference
+
+### 1. `scan` - The Explorer
+
+Used for scanning directories or searching for items.
+
+| Flag | Short | Description |
+| --- | --- | --- |
+| `--find` | `-f` | **Search Mode**. Returns exact and fuzzy matches + a saved report. |
+| `--format` | `-F` | Output format: `md` (default), `txt`, or `image`. |
+| `--depth` | `-d` | Max recursion depth to prevent terminal "walls of text." |
+| `--exclude` | `-e` | List of folders to ignore (e.g., `node_modules .git venv`). |
+| `--outdir` | `-o` | Where to save the result (Defaults to your current terminal path). |
+| `--full` | - | **Power Mode**. Appends the full text content of all scanned source files to the output. |
+
+**Examples:**
+
+```bash
+# Export current directory as a PNG image
+scan . -F image
+
+# Fuzzy search for a mispelled config file
+scan ~/Projects -f "conifg"
+
+# Complex scan: exclude heavy folders, show hidden, save to Desktop
+scan . -s -e node_modules -o ~/Desktop -n project_map.md
+
+# 🌟 POWER MODE: Export tree + all source code for LLMs (excluding caches)
+scan . --full -e node_modules __pycache__ .git
+```
+
+### 2. `build` - The Architect
+
+A dedicated command to turn a text-based tree into a real file system, or restore a project from a snapshot.
+
+| Flag | Short | Description |
+| --- | --- | --- |
+| `--check` | `-c` | **Dry-Run Mode**. Simulates the build and reports missing/existing items. |
+| `--force` | `-f` | **Force Mode**. Overwrites existing files without skipping. |
+| `--direct` | `-d` | **Direct Mode**. Bypasses prompts to instantly create a specific file/folder path. |
+
+**Examples:**
+
+```bash
+# Build in current directory using a simple blueprint
+build blueprint.md
+
+# 🪄 RESTORE MAGIC: Reconstruct an entire project with source code from a --full scan
+build project_snapshot.md ~/Desktop/RestoredProject
+
+# Dry-run a blueprint to safely check what will be created
+build blueprint.txt --check
+
+# Directly scaffold a folder without prompts
+build -d ~/Desktop/NewProject
+```
+
+---
+
+## 📂 Project Structure
+
+```text
+Seedling/
+├── pyproject.toml      <- Modern build configuration
+├── install.sh/bat      <- Auto-installers
+├── test_suite.sh       <- Auto-tests
+└── scan_tool/
+    ├── __init__.py     <- Metadata & versioning
+    ├── __main__.py     <- Module entry point
+    ├── cli.py          <- Logic for 'scan' and 'build' commands
+    ├── scanner.py      <- Search and scanning engine
+    ├── builder.py      <- Scaffolding and reverse-build engine
+    ├── exporter.py     <- Image rendering & OS-specific fonts
+    └── utils.py        <- Session logic, animations, and smart-parsing
+
+```

seedling_tools-2.1.0/Seedling_tools.egg-info/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: Seedling-tools
+Version: 2.1.0
+Summary: A 3-in-1 CLI toolkit to explore, search, and reconstruct directory structures with LLM-ready context support.
+Author: Blue Peach
+Project-URL: Homepage, https://github.com/bbpeaches/Seedling
+Project-URL: Issues, https://github.com/bbpeaches/Seedling/issues
+Keywords: cli,directory-tree,llm-context,scaffolding,developer-tools
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow>=9.0.0
+
+# 🌲 Seedling (v2.1.0)
+
+[![Seedling CI](https://github.com/bbpeaches/Seedling/actions/workflows/ci.yml/badge.svg)](https://github.com/bbpeaches/Seedling/actions/workflows/ci.yml)
+
+**Seedling** is a high-performance, 3-in-1 CLI toolkit designed for developers to explore, search, and reconstruct directory structures. Whether you need a beautiful image of your project architecture or a way to spawn a project from a text blueprint, Seedling has you covered.
+
+---
+
+## 🚀 Key Features
+
+* **Context Rehydration 🌟**: Generate a project snapshot using `scan --full`, and use `build` to flawlessly restore the *entire* directory structure along with the original source code.
+* **Scan & Export**: Export directory trees to `Markdown`, `Plain Text`, or high-fidelity `PNG` images with full Chinese character support.
+* **Smart Search**: Dual-mode search featuring **Exact Match** and **Fuzzy Suggestions** (powered by Levenshtein distance) with in-tree `🎯 [MATCHED]` visual highlights.
+* **Reverse Scaffolding**: Use the `build` command to read any tree diagram (even those copied from a README) and instantly recreate the folder/file hierarchy.
+* **Progressive UI**: Dynamic "pulsing" progress bars for scanning and real-time construction logs for building.
+* **Interactive Personality**: Built-in session-based "Easter Eggs" that respond to your terminal behavior (Mac/Linux exclusive).
+
+---
+
+## 🛠️ Installation
+
+Seedling is designed to be installed globally via `pipx` for a clean, isolated environment.
+
+### One-Click Setup (Self-Destructing Installers)
+
+Our installers set up the environment, install the tool, and then delete themselves to keep your workspace tidy.
+
+* **Windows**: Run `install.bat`
+* **macOS / Linux**: Run `chmod +x install.sh && ./install.sh`
+
+### Developer / Manual Install
+
+If you are modifying the source code, use **Editable Mode**:
+
+```bash
+pipx install -e . --force
+```
+
+---
+
+## 📖 CLI Reference
+
+### 1. `scan` - The Explorer
+
+Used for scanning directories or searching for items.
+
+| Flag | Short | Description |
+| --- | --- | --- |
+| `--find` | `-f` | **Search Mode**. Returns exact and fuzzy matches + a saved report. |
+| `--format` | `-F` | Output format: `md` (default), `txt`, or `image`. |
+| `--depth` | `-d` | Max recursion depth to prevent terminal "walls of text." |
+| `--exclude` | `-e` | List of folders to ignore (e.g., `node_modules .git venv`). |
+| `--outdir` | `-o` | Where to save the result (Defaults to your current terminal path). |
+| `--full` | - | **Power Mode**. Appends the full text content of all scanned source files to the output. |
+
+**Examples:**
+
+```bash
+# Export current directory as a PNG image
+scan . -F image
+
+# Fuzzy search for a mispelled config file
+scan ~/Projects -f "conifg"
+
+# Complex scan: exclude heavy folders, show hidden, save to Desktop
+scan . -s -e node_modules -o ~/Desktop -n project_map.md
+
+# 🌟 POWER MODE: Export tree + all source code for LLMs (excluding caches)
+scan . --full -e node_modules __pycache__ .git
+```
+
+### 2. `build` - The Architect
+
+A dedicated command to turn a text-based tree into a real file system, or restore a project from a snapshot.
+
+| Flag | Short | Description |
+| --- | --- | --- |
+| `--check` | `-c` | **Dry-Run Mode**. Simulates the build and reports missing/existing items. |
+| `--force` | `-f` | **Force Mode**. Overwrites existing files without skipping. |
+| `--direct` | `-d` | **Direct Mode**. Bypasses prompts to instantly create a specific file/folder path. |
+
+**Examples:**
+
+```bash
+# Build in current directory using a simple blueprint
+build blueprint.md
+
+# 🪄 RESTORE MAGIC: Reconstruct an entire project with source code from a --full scan
+build project_snapshot.md ~/Desktop/RestoredProject
+
+# Dry-run a blueprint to safely check what will be created
+build blueprint.txt --check
+
+# Directly scaffold a folder without prompts
+build -d ~/Desktop/NewProject
+```
+
+---
+
+## 📂 Project Structure
+
+```text
+Seedling/
+├── pyproject.toml      <- Modern build configuration
+├── install.sh/bat      <- Auto-installers
+├── test_suite.sh       <- Auto-tests
+└── scan_tool/
+    ├── __init__.py     <- Metadata & versioning
+    ├── __main__.py     <- Module entry point
+    ├── cli.py          <- Logic for 'scan' and 'build' commands
+    ├── scanner.py      <- Search and scanning engine
+    ├── builder.py      <- Scaffolding and reverse-build engine
+    ├── exporter.py     <- Image rendering & OS-specific fonts
+    └── utils.py        <- Session logic, animations, and smart-parsing
+
+```

seedling_tools-2.1.0/Seedling_tools.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+README.md
+pyproject.toml
+Seedling_tools.egg-info/PKG-INFO
+Seedling_tools.egg-info/SOURCES.txt
+Seedling_tools.egg-info/dependency_links.txt
+Seedling_tools.egg-info/entry_points.txt
+Seedling_tools.egg-info/requires.txt
+Seedling_tools.egg-info/top_level.txt
+scan_tool/__init__.py
+scan_tool/__main__.py
+scan_tool/builder.py
+scan_tool/cli.py
+scan_tool/exporter.py
+scan_tool/scanner.py
+scan_tool/utils.py

seedling_tools-2.1.0/Seedling_tools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

seedling_tools-2.1.0/Seedling_tools.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+build = scan_tool.cli:build_entry
+scan = scan_tool.cli:main

seedling_tools-2.1.0/Seedling_tools.egg-info/requires.txt

@@ -0,0 +1 @@
+Pillow>=9.0.0

seedling_tools-2.1.0/Seedling_tools.egg-info/top_level.txt

@@ -0,0 +1 @@
+scan_tool

seedling_tools-2.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "Seedling-tools"
+version = "2.1.0"
+description = "A 3-in-1 CLI toolkit to explore, search, and reconstruct directory structures with LLM-ready context support."
+readme = "README.md"
+authors = [
+    { name = "Blue Peach" }
+]
+requires-python = ">=3.8"
+keywords = ["cli", "directory-tree", "llm-context", "scaffolding", "developer-tools"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+]
+dependencies = [
+    "Pillow>=9.0.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/bbpeaches/Seedling"
+Issues = "https://github.com/bbpeaches/Seedling/issues"
+
+[project.scripts]
+scan = "scan_tool.cli:main"
+build = "scan_tool.cli:build_entry"

seedling_tools-2.1.0/scan_tool/__init__.py

@@ -0,0 +1,32 @@
+"""
+🌲 Seedling (formerly Directory Tree Scanner)
+=============================================
+A powerful 3-in-1 CLI toolkit to:
+1. SCAN: Export directory structures to MD, TXT, or Images.
+2. FIND: Perform exact and fuzzy searches with automated reports.
+3. BUILD: Construct real file systems from text-based blueprints.
+
+Author: Blue Peach
+"""
+
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("Seedling")
+except PackageNotFoundError:
+    __version__ = "dev"
+
+from .cli import main, build_entry
+from .scanner import scan_dir_lines, search_items
+from .builder import build_structure_from_file
+
+__author__ = "Blue Peach"
+
+__all__ = [
+    "main", 
+    "build_entry", 
+    "scan_dir_lines", 
+    "search_items", 
+    "build_structure_from_file",
+    "__version__"
+]

seedling_tools-2.1.0/scan_tool/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()