# ⚡ RepoSmith — Next-Gen Python Project Bootstrapper
[](https://pypi.org/project/reposmith-tol/)
[](https://github.com/sponsors/TamerOnLine)
> **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`](https://github.com/astral-sh/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
```powershell
py -m pip install --upgrade reposmith-tol
```
### 2️⃣ Create a new project
```powershell
reposmith init --root demo --use-uv --with-gitignore --with-license --with-vscode --force
```
### 3️⃣ Open & Run
```powershell
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:
```powershell
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
```powershell
# Editable install
uv pip install -e . --system
# Run tests
uv run pytest -q --cov=. --cov-report=term-missing
```
---
## 🗺 Roadmap
- [x] UV-based dependency installer
- [x] VS Code automation
- [x] CI workflow templates
- [ ] Template packs (FastAPI, Streamlit, Django)
- [ ] Interactive wizard mode
- [ ] Multi-license support (MIT / Apache / GPL)
---
## 🛡 License
Licensed under [MIT](LICENSE) © 2025 **Tamer Hamad Faour (@TamerOnLine)**
---
## 💬 Community & Support
- 🐞 [Report a Bug](https://github.com/TamerOnLine/reposmith-init/issues/new?template=bug.yml)
- 💡 [Suggest a Feature](https://github.com/TamerOnLine/reposmith-init/issues/new?template=feature.yml)
- 💬 [Join Discussions](https://github.com/TamerOnLine/reposmith-init/discussions)
- 💖 [Support via GitHub Sponsors](https://github.com/sponsors/TamerOnLine)
- 📧 info@tameronline.com
Raw data
{
"_id": null,
"home_page": null,
"name": "reposmith-tol",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "bootstrap, venv, uv, vscode, license, scaffold, cli, project-generator",
"author": null,
"author_email": "Tamer Hamad Faour <info@tameronline.com>",
"download_url": "https://files.pythonhosted.org/packages/8a/29/ff1d590dc4ef85125d932b4752d101d5f05d130f0a2f94e35943eeafa0e0/reposmith_tol-0.4.3.tar.gz",
"platform": null,
"description": "# \u26a1 RepoSmith \u2014 Next-Gen Python Project Bootstrapper\r\n\r\n[](https://pypi.org/project/reposmith-tol/)\r\n\r\n\r\n\r\n\r\n[](https://github.com/sponsors/TamerOnLine)\r\n\r\n\r\n\r\n> **RepoSmith-tol** builds complete, ready-to-code Python projects \u2014 \r\n> virtual env, dependencies with `uv`, VS Code setup, CI, and automation \u2014 all in **one command**.\r\n\r\n---\r\n\r\n## \u2728 Features\r\n\r\n| Category | What It Does |\r\n|-----------|--------------|\r\n| \ud83e\uddf1 **Scaffolding** | Generates `main.py`, `.gitignore`, `LICENSE`, and VS Code workspace automatically |\r\n| \u2699\ufe0f **Virtualenv** | Creates `.venv` and links it to VS Code |\r\n| \u26a1 **Dependency Install** | Installs packages via **[`uv`](https://github.com/astral-sh/uv)** (10\u00d7 faster than pip) |\r\n| \ud83d\udcbb **VS Code Integration** | Auto-creates `settings.json`, `launch.json`, and `tasks.json` |\r\n| \ud83e\uddea **CI Workflow** | Generates `.github/workflows/ci.yml` for tests & linting |\r\n| \ud83d\udd12 **Idempotent & Safe** | Re-runs cleanly, only overwriting with `--force` |\r\n| \ud83e\uddfe **License Automation** | Adds MIT license with owner/year metadata |\r\n| \ud83e\uddf0 **Cross-Platform** | Works on Windows / Linux / macOS |\r\n\r\n---\r\n\r\n## \u26a1 Quick Start\r\n\r\n### 1\ufe0f\u20e3 Install\r\n```powershell\r\npy -m pip install --upgrade reposmith-tol\r\n```\r\n\r\n### 2\ufe0f\u20e3 Create a new project\r\n```powershell\r\nreposmith init --root demo --use-uv --with-gitignore --with-license --with-vscode --force\r\n```\r\n\r\n### 3\ufe0f\u20e3 Open & Run\r\n```powershell\r\ncode demo\r\n```\r\n\r\n---\r\n\r\n## \ud83e\udde0 CLI Reference\r\n\r\n| Flag | Description |\r\n|------|--------------|\r\n| `--force` | Overwrite existing files (creates `.bak` backups) |\r\n| `--use-uv` | Install dependencies using **uv** instead of pip |\r\n| `--with-vscode` | Add VS Code configuration (`settings.json`, `launch.json`) |\r\n| `--with-license` | Add MIT LICENSE file |\r\n| `--with-gitignore` | Add Python .gitignore preset |\r\n| `--root <path>` | Target project directory |\r\n\r\nExample:\r\n```powershell\r\nreposmith init --root MyApp --use-uv --with-vscode\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udca1 Quick Summary\r\n\r\n| Command | Description |\r\n|----------|--------------|\r\n| `reposmith init` | Create a complete new project |\r\n| `reposmith doctor` | Check environment health (upcoming) |\r\n| `reposmith --version` | Show current version |\r\n| `reposmith --help` | Display help menu |\r\n\r\n---\r\n\r\n## \ud83e\udde9 Example Structure\r\n\r\n```\r\nMyApp/\r\n\u251c\u2500\u2500 main.py\r\n\u251c\u2500\u2500 .venv/\r\n\u251c\u2500\u2500 tools/\r\n\u2502 \u251c\u2500\u2500 setup_env.ps1\r\n\u2502 \u251c\u2500\u2500 clean_build.ps1\r\n\u2502 \u2514\u2500\u2500 run_tests.ps1\r\n\u251c\u2500\u2500 .vscode/\r\n\u2502 \u251c\u2500\u2500 launch.json\r\n\u2502 \u251c\u2500\u2500 settings.json\r\n\u2502 \u2514\u2500\u2500 tasks.json\r\n\u251c\u2500\u2500 .github/\r\n\u2502 \u2514\u2500\u2500 workflows/ci.yml\r\n\u251c\u2500\u2500 .gitignore\r\n\u2514\u2500\u2500 LICENSE\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udcbb Development & Testing\r\n\r\n```powershell\r\n# Editable install\r\nuv pip install -e . --system\r\n\r\n# Run tests\r\nuv run pytest -q --cov=. --cov-report=term-missing\r\n```\r\n\r\n---\r\n\r\n## \ud83d\uddfa Roadmap\r\n\r\n- [x] UV-based dependency installer \r\n- [x] VS Code automation \r\n- [x] CI workflow templates \r\n- [ ] Template packs (FastAPI, Streamlit, Django) \r\n- [ ] Interactive wizard mode \r\n- [ ] Multi-license support (MIT / Apache / GPL)\r\n\r\n---\r\n\r\n## \ud83d\udee1 License\r\n\r\nLicensed under [MIT](LICENSE) \u00a9 2025 **Tamer Hamad Faour (@TamerOnLine)** \r\n\r\n---\r\n\r\n## \ud83d\udcac Community & Support\r\n\r\n- \ud83d\udc1e [Report a Bug](https://github.com/TamerOnLine/reposmith-init/issues/new?template=bug.yml) \r\n- \ud83d\udca1 [Suggest a Feature](https://github.com/TamerOnLine/reposmith-init/issues/new?template=feature.yml) \r\n- \ud83d\udcac [Join Discussions](https://github.com/TamerOnLine/reposmith-init/discussions) \r\n- \ud83d\udc96 [Support via GitHub Sponsors](https://github.com/sponsors/TamerOnLine) \r\n- \ud83d\udce7 info@tameronline.com\r\n\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Portable Python project bootstrapper with venv, uv, VS Code, and CI integration.",
"version": "0.4.3",
"project_urls": {
"Discussions": "https://github.com/TamerOnLine/reposmith-init/discussions",
"Documentation": "https://tameronline.github.io/reposmith-init/",
"Homepage": "https://github.com/TamerOnLine/reposmith-init",
"Issues": "https://github.com/TamerOnLine/reposmith-init/issues",
"Repository": "https://github.com/TamerOnLine/reposmith-init",
"Sponsor": "https://github.com/sponsors/TamerOnLine"
},
"split_keywords": [
"bootstrap",
" venv",
" uv",
" vscode",
" license",
" scaffold",
" cli",
" project-generator"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "7852ff7ec3bf5c7b508cdb60c731eafb8213f57c35fbe1afc83ff3087b4837dd",
"md5": "59f034e3521471e15bdf110774d1c4d7",
"sha256": "cc31c9ef5c5505b7563a662edf8c0d90373cc38f3541a4197fc0910ee64ea465"
},
"downloads": -1,
"filename": "reposmith_tol-0.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "59f034e3521471e15bdf110774d1c4d7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 24141,
"upload_time": "2025-10-25T01:47:02",
"upload_time_iso_8601": "2025-10-25T01:47:02.596326Z",
"url": "https://files.pythonhosted.org/packages/78/52/ff7ec3bf5c7b508cdb60c731eafb8213f57c35fbe1afc83ff3087b4837dd/reposmith_tol-0.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8a29ff1d590dc4ef85125d932b4752d101d5f05d130f0a2f94e35943eeafa0e0",
"md5": "534da81fd8d78ecd4e81588bd6af9c8b",
"sha256": "36eccb482621e34a359bdf5137f3fb910382e48f696240e68895a85dc58c470f"
},
"downloads": -1,
"filename": "reposmith_tol-0.4.3.tar.gz",
"has_sig": false,
"md5_digest": "534da81fd8d78ecd4e81588bd6af9c8b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 32369,
"upload_time": "2025-10-25T01:47:03",
"upload_time_iso_8601": "2025-10-25T01:47:03.694883Z",
"url": "https://files.pythonhosted.org/packages/8a/29/ff1d590dc4ef85125d932b4752d101d5f05d130f0a2f94e35943eeafa0e0/reposmith_tol-0.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-25 01:47:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "TamerOnLine",
"github_project": "reposmith-init",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "reposmith-tol"
}
JSON
