stup 0.1.0__tar.gz

stup-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+
+# Testing
+htmlcov/
+.coverage
+.coverage.*
+.pytest_cache/
+
+# Build
+*.whl

stup-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11.14

stup-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 teeon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

stup-0.1.0/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: stup
+Version: 0.1.0
+Summary: Scaffold production-ready project structures in seconds. Install once, scaffold forever.
+Project-URL: Homepage, https://github.com/muhdaliyan/stup
+Project-URL: Repository, https://github.com/muhdaliyan/stup
+Project-URL: Issues, https://github.com/muhdaliyan/stup/issues
+Author: teeon
+License: MIT
+License-File: LICENSE
+Keywords: boilerplate,cli,fullstack,project-template,scaffold,uv
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: requests>=2.33.1
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Description-Content-Type: text/markdown
+
+# stup
+
+> 🚀 Scaffold production-ready project structures in seconds. Install once, scaffold forever.
+
+```bash
+pip install stup
+```
+
+## Foundation Commands
+
+### `stup uv`
+
+Bootstraps a complete uv Python project. Run this first before any template.
+
+```bash
+$ stup uv
+```
+
+- `uv init` — creates pyproject.toml and project skeleton
+- `uv python pin 3.12` — pins Python version
+- `uv venv` — creates virtual environment
+- Prints activation command (cross-platform)
+
+### `stup activate`
+
+Smart cross-platform venv activator — detects your shell and prints the right command.
+
+- **Windows PowerShell:** `.venv\Scripts\Activate`
+- **Linux/Mac bash/zsh:** `source .venv/bin/activate`
+
+### `stup add <packages>`
+
+Add packages using `uv` and automatically maintain a clean `requirements.txt`.
+
+```bash
+$ stup add requests pandas
+```
+
+---
+
+## Template Commands
+
+Each template builds on top of `stup uv`. Run `stup uv` first, then pick your template.
+
+### `stup react-fastapi`
+
+| | |
+|---|---|
+| **Description** | Full-stack web app — React frontend + FastAPI backend with Docker Compose and CORS pre-configured |
+| **Stack** | Python + JavaScript (Vite, React, Tailwind, FastAPI, Alembic) |
+| **Installs** | `uv add fastapi uvicorn alembic` \| `npm install react tailwindcss vite` |
+| **Structure** | `frontend/` `backend/` `docker-compose.yml` `.env` |
+
+### `stup notebook`
+
+| | |
+|---|---|
+| **Description** | Data science workspace with Jupyter notebooks, uv-managed deps, kernel auto-registered |
+| **Stack** | Python + Jupyter |
+| **Installs** | `uv add ipykernel pandas numpy matplotlib` |
+| **Structure** | `notebooks/` `data/raw/` `data/processed/` |
+
+### `stup openai-agent`
+
+| | |
+|---|---|
+| **Description** | Modern OpenAI agent with function calling (tools), environment config, and helper stubs |
+| **Stack** | Python (OpenAI SDK, python-dotenv) |
+| **Installs** | `uv add openai python-dotenv` |
+| **Structure** | `agent.py` `tools/` `.env` (OPENAI_API_KEY) |
+
+### `stup lang-agent`
+
+| | |
+|---|---|
+| **Description** | LangGraph AI agent with tool stubs, memory/checkpointing, and Ollama config |
+| **Stack** | Python (LangGraph, LangChain, Ollama) |
+| **Installs** | `uv add langgraph langchain-community` |
+| **Structure** | `agent.py` `tools/` `memory/` `.env` (OLLAMA_BASE_URL) |
+
+### `stup django`
+
+| | |
+|---|---|
+| **Description** | Production-ready Django + DRF + Celery + Redis + PostgreSQL setup with python-decouple |
+| **Stack** | Python (Django, DRF, Celery, Redis, PostgreSQL) |
+| **Installs** | `uv add django djangorestframework celery redis python-decouple` |
+| **Structure** | `config/` `apps/users/` `apps/api/` `tasks/` `.env` |
+
+### `stup ml`
+
+| | |
+|---|---|
+| **Description** | ML project scaffold with experiment tracking, model versioning, and MLflow stub |
+| **Stack** | Python (scikit-learn, PyTorch, MLflow) |
+| **Installs** | `uv add scikit-learn torch mlflow` |
+| **Structure** | `data/` `models/` `experiments/runs/` `experiments/configs/` |
+
+### `stup scraper`
+
+| | |
+|---|---|
+| **Description** | Web scraping project with Playwright, BeautifulSoup, pandas output pipeline and scheduler |
+| **Stack** | Python (Playwright, BeautifulSoup4, pandas) |
+| **Installs** | `uv add playwright beautifulsoup4 pandas schedule` + `playwright install chromium` |
+| **Structure** | `spider.py` `pipeline.py` `data/raw/` `data/cleaned/` |
+
+### `stup cli`
+
+| | |
+|---|---|
+| **Description** | PyPI-ready Python CLI package with Typer + Rich, entry_points wired in pyproject.toml |
+| **Stack** | Python (Typer, Rich) |
+| **Installs** | `uv add typer rich` |
+| **Structure** | `src/<project>/` `commands/` `pyproject.toml` `README.md` |
+
+---
+
+## Quick Reference
+
+| Command | Stack | Use Case |
+|---------|-------|----------|
+| `stup uv` | Python | Start any Python project |
+| `stup activate` | Python | Activate venv cross-platform |
+| `stup add` | Python | Add deps & sync requirements.txt |
+| `stup react-fastapi` | Py + JS | Full-stack web app |
+| `stup notebook` | Python | Data science / Jupyter |
+| `stup openai-agent` | Python | Modern OpenAI Agent |
+| `stup lang-agent` | Python | LangGraph AI agent |
+| `stup django` | Python | Full Django + Celery API |
+| `stup ml` | Python | ML project + MLflow |
+| `stup scraper` | Python | Web scraping pipeline |
+| `stup cli` | Python | PyPI-ready CLI package |
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/teeon/stup.git
+cd stup
+uv venv
+uv pip install -e ".[dev]"
+stup --help
+```
+
+## License
+
+MIT

stup-0.1.0/README.md

@@ -0,0 +1,149 @@
+# stup
+
+> 🚀 Scaffold production-ready project structures in seconds. Install once, scaffold forever.
+
+```bash
+pip install stup
+```
+
+## Foundation Commands
+
+### `stup uv`
+
+Bootstraps a complete uv Python project. Run this first before any template.
+
+```bash
+$ stup uv
+```
+
+- `uv init` — creates pyproject.toml and project skeleton
+- `uv python pin 3.12` — pins Python version
+- `uv venv` — creates virtual environment
+- Prints activation command (cross-platform)
+
+### `stup activate`
+
+Smart cross-platform venv activator — detects your shell and prints the right command.
+
+- **Windows PowerShell:** `.venv\Scripts\Activate`
+- **Linux/Mac bash/zsh:** `source .venv/bin/activate`
+
+### `stup add <packages>`
+
+Add packages using `uv` and automatically maintain a clean `requirements.txt`.
+
+```bash
+$ stup add requests pandas
+```
+
+---
+
+## Template Commands
+
+Each template builds on top of `stup uv`. Run `stup uv` first, then pick your template.
+
+### `stup react-fastapi`
+
+| | |
+|---|---|
+| **Description** | Full-stack web app — React frontend + FastAPI backend with Docker Compose and CORS pre-configured |
+| **Stack** | Python + JavaScript (Vite, React, Tailwind, FastAPI, Alembic) |
+| **Installs** | `uv add fastapi uvicorn alembic` \| `npm install react tailwindcss vite` |
+| **Structure** | `frontend/` `backend/` `docker-compose.yml` `.env` |
+
+### `stup notebook`
+
+| | |
+|---|---|
+| **Description** | Data science workspace with Jupyter notebooks, uv-managed deps, kernel auto-registered |
+| **Stack** | Python + Jupyter |
+| **Installs** | `uv add ipykernel pandas numpy matplotlib` |
+| **Structure** | `notebooks/` `data/raw/` `data/processed/` |
+
+### `stup openai-agent`
+
+| | |
+|---|---|
+| **Description** | Modern OpenAI agent with function calling (tools), environment config, and helper stubs |
+| **Stack** | Python (OpenAI SDK, python-dotenv) |
+| **Installs** | `uv add openai python-dotenv` |
+| **Structure** | `agent.py` `tools/` `.env` (OPENAI_API_KEY) |
+
+### `stup lang-agent`
+
+| | |
+|---|---|
+| **Description** | LangGraph AI agent with tool stubs, memory/checkpointing, and Ollama config |
+| **Stack** | Python (LangGraph, LangChain, Ollama) |
+| **Installs** | `uv add langgraph langchain-community` |
+| **Structure** | `agent.py` `tools/` `memory/` `.env` (OLLAMA_BASE_URL) |
+
+### `stup django`
+
+| | |
+|---|---|
+| **Description** | Production-ready Django + DRF + Celery + Redis + PostgreSQL setup with python-decouple |
+| **Stack** | Python (Django, DRF, Celery, Redis, PostgreSQL) |
+| **Installs** | `uv add django djangorestframework celery redis python-decouple` |
+| **Structure** | `config/` `apps/users/` `apps/api/` `tasks/` `.env` |
+
+### `stup ml`
+
+| | |
+|---|---|
+| **Description** | ML project scaffold with experiment tracking, model versioning, and MLflow stub |
+| **Stack** | Python (scikit-learn, PyTorch, MLflow) |
+| **Installs** | `uv add scikit-learn torch mlflow` |
+| **Structure** | `data/` `models/` `experiments/runs/` `experiments/configs/` |
+
+### `stup scraper`
+
+| | |
+|---|---|
+| **Description** | Web scraping project with Playwright, BeautifulSoup, pandas output pipeline and scheduler |
+| **Stack** | Python (Playwright, BeautifulSoup4, pandas) |
+| **Installs** | `uv add playwright beautifulsoup4 pandas schedule` + `playwright install chromium` |
+| **Structure** | `spider.py` `pipeline.py` `data/raw/` `data/cleaned/` |
+
+### `stup cli`
+
+| | |
+|---|---|
+| **Description** | PyPI-ready Python CLI package with Typer + Rich, entry_points wired in pyproject.toml |
+| **Stack** | Python (Typer, Rich) |
+| **Installs** | `uv add typer rich` |
+| **Structure** | `src/<project>/` `commands/` `pyproject.toml` `README.md` |
+
+---
+
+## Quick Reference
+
+| Command | Stack | Use Case |
+|---------|-------|----------|
+| `stup uv` | Python | Start any Python project |
+| `stup activate` | Python | Activate venv cross-platform |
+| `stup add` | Python | Add deps & sync requirements.txt |
+| `stup react-fastapi` | Py + JS | Full-stack web app |
+| `stup notebook` | Python | Data science / Jupyter |
+| `stup openai-agent` | Python | Modern OpenAI Agent |
+| `stup lang-agent` | Python | LangGraph AI agent |
+| `stup django` | Python | Full Django + Celery API |
+| `stup ml` | Python | ML project + MLflow |
+| `stup scraper` | Python | Web scraping pipeline |
+| `stup cli` | Python | PyPI-ready CLI package |
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/teeon/stup.git
+cd stup
+uv venv
+uv pip install -e ".[dev]"
+stup --help
+```
+
+## License
+
+MIT

stup-0.1.0/pyproject.toml

@@ -0,0 +1,58 @@
+[project]
+name = "stup"
+version = "0.1.0"
+description = "Scaffold production-ready project structures in seconds. Install once, scaffold forever."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.11"
+authors = [
+    {name = "teeon"},
+]
+keywords = ["cli", "scaffold", "boilerplate", "project-template", "uv", "fullstack"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "requests>=2.33.1",
+]
+
+[project.scripts]
+stup = "app.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/muhdaliyan/stup"
+Repository = "https://github.com/muhdaliyan/stup"
+Issues = "https://github.com/muhdaliyan/stup/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/app"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.uv.workspace]
+members = [
+    "test-scaffold",
+    "test-minimal",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+]

stup-0.1.0/src/app/__init__.py

@@ -0,0 +1,3 @@
+"""stup — Scaffold production-ready project structures in seconds."""
+
+__version__ = "0.1.0"

stup-0.1.0/src/app/cli.py

@@ -0,0 +1,173 @@
+"""stup CLI — Main entry point."""
+
+import typer
+from rich.console import Console
+
+from app import __version__
+from app.commands import (
+    activate,
+    add,
+    api,
+    cli_cmd,
+    django_cmd,
+    docs,
+    lang_agent,
+    mean,
+    mern,
+    ml,
+    next_django,
+    notebook,
+    openai_agent,
+    react_fastapi,
+    saas,
+    scraper,
+    test_cmd,
+    uv,
+)
+
+console = Console()
+
+app = typer.Typer(
+    name="stup",
+    help="Scaffold production-ready project structures in seconds.",
+    add_completion=False,
+    rich_markup_mode="rich",
+    no_args_is_help=True,
+)
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        console.print(f"[bold cyan]stup[/bold cyan] v{__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    version: bool = typer.Option(
+        False, "--version", "-v", help="Show version and exit.", callback=_version_callback, is_eager=True
+    ),
+) -> None:
+    """stup — Install once, scaffold forever."""
+
+
+# ── Foundation commands ──────────────────────────────────────────────
+
+@app.command()
+def uv_cmd() -> None:
+    """[bold cyan]Foundation[/bold cyan] · Bootstrap a complete uv Python project."""
+    uv.run_command()
+
+
+# Register as "uv" not "uv-cmd"
+uv_cmd.__name__ = "uv"  # type: ignore[attr-defined]
+uv_cmd = app.registered_commands[-1]
+uv_cmd.name = "uv"
+
+
+@app.command(name="activate")
+def activate_cmd() -> None:
+    """[bold cyan]Foundation[/bold cyan] · Smart cross-platform venv activator."""
+    activate.run_command()
+
+
+@app.command(name="add")
+def add_cmd(packages: list[str]) -> None:
+    """[bold cyan]Foundation[/bold cyan] · Add packages and sync requirements.txt."""
+    add.run_command(packages)
+
+
+# ── Template commands ────────────────────────────────────────────────
+
+@app.command(name="react-fastapi")
+def react_fastapi_cmd() -> None:
+    """[bold magenta]Full-stack[/bold magenta] · React + FastAPI with Docker Compose & CORS."""
+    react_fastapi.run_command()
+
+
+@app.command(name="notebook")
+def notebook_cmd() -> None:
+    """[bold green]Data Science[/bold green] · Jupyter notebooks with uv-managed deps."""
+    notebook.run_command()
+
+
+@app.command(name="mern")
+def mern_cmd() -> None:
+    """[bold magenta]Full-stack[/bold magenta] · MongoDB + Express + React + Node."""
+    mern.run_command()
+
+
+@app.command(name="mean")
+def mean_cmd() -> None:
+    """[bold magenta]Full-stack[/bold magenta] · MongoDB + Express + Angular + Node."""
+    mean.run_command()
+
+
+@app.command(name="django")
+def django_cmd_fn() -> None:
+    """[bold blue]Backend[/bold blue] · Django + DRF + Celery + Redis + PostgreSQL."""
+    django_cmd.run_command()
+
+
+@app.command(name="next-django")
+def next_django_cmd() -> None:
+    """[bold magenta]Full-stack[/bold magenta] · Next.js 14 + Django REST + JWT auth."""
+    next_django.run_command()
+
+
+@app.command(name="ml")
+def ml_cmd() -> None:
+    """[bold green]Data Science[/bold green] · ML project with experiment tracking & MLflow."""
+    ml.run_command()
+
+
+@app.command(name="lang-agent")
+def lang_agent_cmd() -> None:
+    """[bold yellow]AI[/bold yellow] · LangGraph agent with tool stubs & Ollama config."""
+    lang_agent.run_command()
+
+
+@app.command(name="openai-agent")
+def openai_agent_cmd() -> None:
+    """[bold yellow]AI[/bold yellow] · Modern OpenAI agent with function calling."""
+    openai_agent.run_command()
+
+
+@app.command(name="scraper")
+def scraper_cmd() -> None:
+    """[bold yellow]Automation[/bold yellow] · Playwright + BeautifulSoup scraping pipeline."""
+    scraper.run_command()
+
+
+@app.command(name="cli")
+def cli_cmd_fn() -> None:
+    """[bold blue]Package[/bold blue] · PyPI-ready CLI package with Typer + Rich."""
+    cli_cmd.run_command()
+
+
+@app.command(name="api")
+def api_cmd() -> None:
+    """[bold blue]Backend[/bold blue] · Minimal FastAPI microservice with auth middleware."""
+    api.run_command()
+
+
+@app.command(name="saas")
+def saas_cmd() -> None:
+    """[bold magenta]Full-stack[/bold magenta] · Full SaaS boilerplate with Stripe & Docker."""
+    saas.run_command()
+
+
+@app.command(name="docs")
+def docs_cmd() -> None:
+    """[bold dim]Addon[/bold dim] · Add MkDocs + Material theme to any project."""
+    docs.run_command()
+
+
+@app.command(name="test")
+def test_cmd_fn() -> None:
+    """[bold dim]Addon[/bold dim] · Scaffold a full pytest suite with coverage."""
+    test_cmd.run_command()
+
+
+if __name__ == "__main__":
+    app()

stup-0.1.0/src/app/commands/__init__.py

@@ -0,0 +1 @@
+"""stup.commands — All CLI command implementations."""

stup-0.1.0/src/app/commands/activate.py

@@ -0,0 +1,33 @@
+"""stup activate — Smart cross-platform venv activator."""
+
+from app.utils import (
+    console,
+    ensure_venv_exists,
+    get_activate_command,
+    is_windows,
+    print_banner,
+)
+
+
+def run_command() -> None:
+    """Print the correct venv activation command for the current platform."""
+    print_banner("activate", "Smart cross-platform venv activator")
+
+    ensure_venv_exists()
+
+    cmd = get_activate_command()
+
+    console.print()
+    if is_windows():
+        console.print("  [yellow]→[/yellow] Run this in PowerShell:")
+        console.print(f"    [bold white]{cmd}[/bold white]")
+        console.print()
+        console.print("  [dim]Or in CMD:[/dim]")
+        console.print(r"    [dim].venv\Scripts\activate.bat[/dim]")
+    else:
+        console.print("  [yellow]→[/yellow] Run this in your terminal:")
+        console.print(f"    [bold white]{cmd}[/bold white]")
+        console.print()
+        console.print("  [dim]Or use eval:[/dim]")
+        console.print("    [dim]eval $(stup activate)[/dim]")
+    console.print()

stup-0.1.0/src/app/commands/add.py

@@ -0,0 +1,35 @@
+"""stup add — Thin wrapper over uv add that maintains requirements.txt."""
+
+import typer
+from app.utils import (
+    check_uv,
+    ensure_venv_exists,
+    print_banner,
+    print_done,
+    run,
+)
+
+def run_command(packages: list[str]) -> None:
+    """Add packages using uv and update requirements.txt."""
+    print_banner("add", f"Adding packages: {', '.join(packages)}")
+
+    check_uv()
+    ensure_venv_exists()
+
+    # Add packages
+    pkg_str = " ".join(packages)
+    run(f"uv add {pkg_str}")
+
+    # Update requirements.txt for compatibility (clean format)
+    run("uv export --format requirements-txt --no-hashes --no-emit-project --output-file requirements.txt --quiet")
+
+    # Post-process to remove all 'via' comments for a super clean look
+    req_file = "requirements.txt"
+    with open(req_file, "r") as f:
+        lines = f.readlines()
+    with open(req_file, "w") as f:
+        for line in lines:
+            if not line.strip().startswith("#"):
+                f.write(line)
+
+    print_done()