reposmith-tol 0.2.0

Portable project bootstrapper (venv, gitignore, license, vscode, etc.)

⚡ RepoSmith

RepoSmith is a lightweight & portable CLI tool that helps you bootstrap new Python projects instantly 🚀.
With one command, you get a ready-to-code environment including virtualenv, config files, VS Code setup, .gitignore, and license.

---

✨ Features

• 🚀 Quick project setup with a single command
• 🐍 Python ≥ 3.12 support
• 📦 Automatic virtual environment creation (.venv)
• 📂 Generates essential files:
  • setup-config.json, requirements.txt, app.py
  • .vscode/ (settings + launch config)
  • .gitignore, LICENSE
• ⚙️ Preconfigured GitHub Actions workflow
• 🛡️ Built-in MIT license template

---

⚡ Quick Start

cd MyProject
py -m reposmith.main

This will:

• create .venv/
• add requirements.txt, app.py, .gitignore, LICENSE, .vscode/
• configure everything automatically with defaults.

👉 Optional flags:

• --ci create → add GitHub Actions workflow
• --author "YourName" → set your name in LICENSE

---

📦 Installation

From PyPI

pip install reposmith-tol

From Source

git clone https://github.com/liebemama/RepoSmith.git
cd RepoSmith
pip install -e .

---

🚀 Usage

CLI

# Create new project structure in current folder
reposmith --ci create --gitignore python --author "Tamer"

Example

cd MyNewProject
reposmith --ci create --gitignore django --license MIT --author "Tamer"

---

🧩 Library API

from reposmith.venv_utils import create_virtualenv, upgrade_pip, install_requirements

venv_dir = "./.venv"
req_file = "./requirements.txt"

create_virtualenv(venv_dir)
upgrade_pip(venv_dir)
install_requirements(venv_dir, req_file)

---

🛡️ License

This project is licensed under the MIT License.
© 2025 TamerOnLine

---

💖 Support this project

If you find RepoSmith useful, consider supporting its development:
👉 Sponsor us on GitHub