⚡ RepoSmith — Next-Gen Python Project Bootstrapper
RepoSmith-tol builds complete, ready-to-code Python projects —
virtual env, dependencies withuv, 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
1 maintainer
Metadata
1 maintainer
Release files for reposmith-tol 0.4.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| reposmith_tol-0.4.3.tar.gz | 32.4 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| reposmith_tol-0.4.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 56.5 kB
Release files / reposmith_tol-0.4.3.tar.gz
| Download URL | reposmith_tol-0.4.3.tar.gz |
|---|---|
| Size | 32.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
36eccb482621e34a359bdf5137f3fb910382e48f696240e68895a85dc58c470f
|
|
BLAKE2b-256 checksum How to use checksums |
8a29ff1d590dc4ef85125d932b4752d101d5f05d130f0a2f94e35943eeafa0e0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Release files / reposmith_tol-0.4.3-py3-none-any.whl
| Download URL | reposmith_tol-0.4.3-py3-none-any.whl |
|---|---|
| Size | 24.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cc31c9ef5c5505b7563a662edf8c0d90373cc38f3541a4197fc0910ee64ea465
|
|
BLAKE2b-256 checksum How to use checksums |
7852ff7ec3bf5c7b508cdb60c731eafb8213f57c35fbe1afc83ff3087b4837dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Security for reposmith-tol 0.4.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
