reposmith-tol 0.3.6

Portable Python project bootstrapper with venv, uv, Brave profile, VS Code, and CI integration.

⚡ RepoSmith — Next-Gen Python Project Bootstrapper

RepoSmith-tol builds complete, ready-to-code Python projects —
virtual env, dependencies with uv, VS Code setup, CI, and optional Brave Dev Profile — all in one command.

---

✨ Features

Category	What It Does
🧱 Scaffolding	Generates main.py, .gitignore, LICENSE, and VS Code workspace automatically
⚙️ Virtualenv	Creates .venv and links it to VS Code
⚡ Dependency Install	Installs packages via uv (10× faster than pip)
💻 VS Code Integration	Auto-creates settings.json, launch.json, and tasks.json
🧪 CI Workflow	Generates .github/workflows/ci.yml for tests & linting
🦁 Brave Browser Profile	Per-project isolated Brave Dev Profile (.brave-profile/ + PowerShell tools)
🔒 Idempotent & Safe	Re-runs cleanly, only overwriting with --force
🧾 License Automation	Adds MIT license with owner/year metadata
🧰 Cross-Platform	Works on Windows / Linux / macOS

---

⚡ Quick Start

1️⃣ Install

py -m pip install --upgrade reposmith-tol

2️⃣ Create a new project

reposmith init --root demo --use-uv --with-brave --with-gitignore --with-license --with-vscode --force

3️⃣ Open & Run

code demo
# or launch Brave dev profile
pwsh -File .\demo\tools\launch_brave.ps1

---

🧠 CLI Reference

Flag	Description
--force	Overwrite existing files (creates .bak backups)
--use-uv	Install dependencies using uv instead of pip
--with-brave	Initialize Brave Dev Profile (.brave-profile/, PowerShell tools)
--with-vscode	Add VS Code configuration (settings.json, launch.json)
--with-license	Add MIT LICENSE file
--with-gitignore	Add Python .gitignore preset
--root <path>	Target project directory

Example:

reposmith init --root MyApp --use-uv --with-brave --with-vscode

---

💡 Quick Summary

Command	Description
reposmith init	Create a complete new project
reposmith brave-profile --init	Add Brave profile and tools to an existing project
reposmith doctor	Check environment health (upcoming)
reposmith --version	Show current version
reposmith --help	Display help menu

---

🧩 Example Structure

MyApp/
├── main.py
├── .venv/
├── .brave-profile/
├── tools/
│   ├── launch_brave.ps1
│   ├── make_brave_shortcut.ps1
│   └── cleanup_brave_profile.ps1
├── .vscode/
│   ├── launch.json
│   ├── settings.json
│   └── tasks.json
├── .github/
│   └── workflows/ci.yml
├── .gitignore
└── LICENSE

---

💻 Development & Testing

# Editable install
uv pip install -e . --system

# Run tests
uv run pytest -q --cov=. --cov-report=term-missing

---

🗺 Roadmap

• UV-based dependency installer
• Brave profile integration
• Template packs (FastAPI, Streamlit, Django)
• Interactive wizard mode
• Multi-license support (MIT / Apache / GPL)

---

🛡 License

Licensed under MIT © 2025 Tamer Hamad Faour (@TamerOnLine)

---

💬 Community & Support

• 🐞 Report a Bug
• 💡 Suggest a Feature
• 💬 Join Discussions
• 💖 Support via GitHub Sponsors
• 📧 [e-mail]

---