reposmith-tol 0.4.2

Portable Python project bootstrapper with venv, uv, 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 automation — 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
🔒 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-gitignore --with-license --with-vscode --force

3️⃣ Open & Run

code demo

---

🧠 CLI Reference

Flag	Description
--force	Overwrite existing files (creates .bak backups)
--use-uv	Install dependencies using uv instead of pip
--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-vscode

---

💡 Quick Summary

Command	Description
reposmith init	Create a complete new project
reposmith doctor	Check environment health (upcoming)
reposmith --version	Show current version
reposmith --help	Display help menu

---

🧩 Example Structure

MyApp/
├── main.py
├── .venv/
├── tools/
│   ├── setup_env.ps1
│   ├── clean_build.ps1
│   └── run_tests.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
• VS Code automation
• CI workflow templates
• 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]