app-generator-cli 1.0.1__tar.gz

app_generator_cli-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Your Name
+
+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.

app_generator_cli-1.0.1/PKG-INFO

@@ -0,0 +1,219 @@
+Metadata-Version: 2.3
+Name: app-generator-cli
+Version: 1.0.1
+Summary: A developer-friendly scaffolding CLI for FastAPI and LangChain/LangGraph projects
+Keywords: cli,scaffolding,fastapi,langchain,langgraph,uv
+Author: Rajendra Kumar Yadav
+Author-email: Rajendra Kumar Yadav <yadavrajendrakumar@outlook.com>
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/rajendrakumaryadav/app-generator-cli
+Project-URL: Repository, https://github.com/rajendrakumaryadav/app-generator-cli
+Project-URL: Issues, https://github.com/rajendrakumaryadav/app-generator-cli/issues
+Description-Content-Type: text/markdown
+
+# ⚒ AppGenerator CLI
+
+[![CI](https://github.com/rajendrakumaryadav/pyforge/actions/workflows/ci.yml/badge.svg)](https://github.com/rajendrakumaryadav/app-generator-cli/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/appgenerator-cli)](https://pypi.org/project/app-generator-cli/)
+[![pytest](https://img.shields.io/badge/pytest-3.10%20%7C%203.11%20%7C%203.12-0A9EDC?logo=pytest)](https://github.com/rajendrakumaryadav/app-generator-cli/actions/workflows/ci.yml) 
+
+> Scaffold production-ready Python projects in seconds — powered by `uv`.
+
+CI runs `uv run pytest tests/ -v --tb=short` on Python `3.10`, `3.11`, and `3.12`.
+
+```
+$ app-generator-cli create fastapi my_api
+$ app-generator-cli create ai my_ai_app --docker --postgres
+```
+
+---
+
+## Installation
+
+```bash
+pip install app-generator-cli
+# or, with uv (recommended):
+uv tool install app-generator-cli
+```
+
+Verify:
+```bash
+app-generator-cli --version
+```
+
+---
+
+## Commands
+
+### `app-generator-cli create fastapi <name>`
+
+Scaffold a **FastAPI** backend.
+
+| Flag | Description |
+|------|-------------|
+| `--docker` | Add `Dockerfile` + `docker-compose.yml` |
+| `--postgres` | Use PostgreSQL (`asyncpg`) instead of SQLite |
+| `--redis` | Add Redis client (`redis`) |
+| `--output PATH` | Create the project in a custom directory |
+
+**Example:**
+```bash
+app-generator-cli create fastapi my_api --docker --postgres --redis
+cd my_api
+cp .env.example .env
+uv run uvicorn app.main:app --reload
+```
+
+### `app-generator-cli create ai <name>`
+
+Scaffold a **LangChain / LangGraph** AI application.
+
+| Flag | Description |
+|------|-------------|
+| `--docker` | Add `Dockerfile` + `docker-compose.yml` |
+| `--postgres` | Add pgvector PostgreSQL support |
+| `--redis` | Add Redis semantic cache |
+| `--output PATH` | Create the project in a custom directory |
+
+**Example:**
+```bash
+app-generator-cli create ai my_assistant --docker
+cd my_assistant
+cp .env.example .env   # add your OPENAI_API_KEY
+uv run python main.py
+```
+
+---
+
+## Generated Project Structure
+
+### FastAPI
+
+```
+my_api/
+├── app/
+│   ├── main.py          # Application factory
+│   ├── config.py        # Pydantic Settings
+│   ├── dependencies.py  # FastAPI deps (DB session, etc.)
+│   ├── api/v1/
+│   │   └── health.py    # Health-check endpoint
+│   ├── models/
+│   │   └── base.py      # SQLModel base with timestamps
+│   └── db/
+│       └── session.py   # Async session factory
+├── tests/
+│   ├── conftest.py      # Async test client + DB fixtures
+│   └── test_health.py
+├── .env.example
+├── .gitignore
+├── pyproject.toml
+├── Dockerfile           # (--docker)
+└── docker-compose.yml   # (--docker)
+```
+
+### AI (LangChain / LangGraph)
+
+```
+my_assistant/
+├── main.py              # Interactive REPL
+├── app/
+│   ├── config.py        # Pydantic Settings
+│   ├── agents/
+│   │   └── assistant.py # LangGraph ReAct agent
+│   ├── chains/
+│   │   └── rag.py       # RAG chain example
+│   └── tools/
+│       ├── registry.py  # Tool registry
+│       └── search.py    # Web search tool stub
+├── tests/
+│   └── test_agent.py
+├── .env.example
+├── .gitignore
+├── pyproject.toml
+├── Dockerfile           # (--docker)
+└── docker-compose.yml   # (--docker)
+```
+
+---
+
+## Packaging & Publishing to PyPI
+
+### 1. Build
+
+```bash
+# Install build tools
+pip install build twine
+
+# Build wheel + sdist
+python -m build
+# Outputs: dist/app-generator-cli-0.1.0-py3-none-any.whl
+#          dist/app-generator-cli-0.1.0.tar.gz
+```
+
+### 2. Test on TestPyPI
+
+```bash
+twine upload --repository testpypi dist/*
+pip install --index-url https://test.pypi.org/simple/ app-generator-cli
+```
+
+### 3. Publish to PyPI
+
+```bash
+twine upload dist/*
+```
+
+Or with uv:
+
+```bash
+uv build
+uv publish
+```
+
+---
+
+## Development Setup
+
+```bash
+git clone https://github.com/yourname/app-generator-cli
+cd app-generator-cli
+
+uv venv
+uv sync --dev
+
+# Run locally
+uv run app-generator-cli --help
+
+# Tests
+uv run pytest
+
+# Lint
+uv run ruff check .
+uv run ruff format .
+```
+
+---
+
+## Requirements
+
+- Python ≥ 3.10
+- [`uv`](https://docs.astral.sh/uv/) installed on the system (for generated project env management)
+
+---
+
+## License
+
+MIT

app_generator_cli-1.0.1/README.md

@@ -0,0 +1,193 @@
+# ⚒ AppGenerator CLI
+
+[![CI](https://github.com/rajendrakumaryadav/pyforge/actions/workflows/ci.yml/badge.svg)](https://github.com/rajendrakumaryadav/app-generator-cli/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/appgenerator-cli)](https://pypi.org/project/app-generator-cli/)
+[![pytest](https://img.shields.io/badge/pytest-3.10%20%7C%203.11%20%7C%203.12-0A9EDC?logo=pytest)](https://github.com/rajendrakumaryadav/app-generator-cli/actions/workflows/ci.yml) 
+
+> Scaffold production-ready Python projects in seconds — powered by `uv`.
+
+CI runs `uv run pytest tests/ -v --tb=short` on Python `3.10`, `3.11`, and `3.12`.
+
+```
+$ app-generator-cli create fastapi my_api
+$ app-generator-cli create ai my_ai_app --docker --postgres
+```
+
+---
+
+## Installation
+
+```bash
+pip install app-generator-cli
+# or, with uv (recommended):
+uv tool install app-generator-cli
+```
+
+Verify:
+```bash
+app-generator-cli --version
+```
+
+---
+
+## Commands
+
+### `app-generator-cli create fastapi <name>`
+
+Scaffold a **FastAPI** backend.
+
+| Flag | Description |
+|------|-------------|
+| `--docker` | Add `Dockerfile` + `docker-compose.yml` |
+| `--postgres` | Use PostgreSQL (`asyncpg`) instead of SQLite |
+| `--redis` | Add Redis client (`redis`) |
+| `--output PATH` | Create the project in a custom directory |
+
+**Example:**
+```bash
+app-generator-cli create fastapi my_api --docker --postgres --redis
+cd my_api
+cp .env.example .env
+uv run uvicorn app.main:app --reload
+```
+
+### `app-generator-cli create ai <name>`
+
+Scaffold a **LangChain / LangGraph** AI application.
+
+| Flag | Description |
+|------|-------------|
+| `--docker` | Add `Dockerfile` + `docker-compose.yml` |
+| `--postgres` | Add pgvector PostgreSQL support |
+| `--redis` | Add Redis semantic cache |
+| `--output PATH` | Create the project in a custom directory |
+
+**Example:**
+```bash
+app-generator-cli create ai my_assistant --docker
+cd my_assistant
+cp .env.example .env   # add your OPENAI_API_KEY
+uv run python main.py
+```
+
+---
+
+## Generated Project Structure
+
+### FastAPI
+
+```
+my_api/
+├── app/
+│   ├── main.py          # Application factory
+│   ├── config.py        # Pydantic Settings
+│   ├── dependencies.py  # FastAPI deps (DB session, etc.)
+│   ├── api/v1/
+│   │   └── health.py    # Health-check endpoint
+│   ├── models/
+│   │   └── base.py      # SQLModel base with timestamps
+│   └── db/
+│       └── session.py   # Async session factory
+├── tests/
+│   ├── conftest.py      # Async test client + DB fixtures
+│   └── test_health.py
+├── .env.example
+├── .gitignore
+├── pyproject.toml
+├── Dockerfile           # (--docker)
+└── docker-compose.yml   # (--docker)
+```
+
+### AI (LangChain / LangGraph)
+
+```
+my_assistant/
+├── main.py              # Interactive REPL
+├── app/
+│   ├── config.py        # Pydantic Settings
+│   ├── agents/
+│   │   └── assistant.py # LangGraph ReAct agent
+│   ├── chains/
+│   │   └── rag.py       # RAG chain example
+│   └── tools/
+│       ├── registry.py  # Tool registry
+│       └── search.py    # Web search tool stub
+├── tests/
+│   └── test_agent.py
+├── .env.example
+├── .gitignore
+├── pyproject.toml
+├── Dockerfile           # (--docker)
+└── docker-compose.yml   # (--docker)
+```
+
+---
+
+## Packaging & Publishing to PyPI
+
+### 1. Build
+
+```bash
+# Install build tools
+pip install build twine
+
+# Build wheel + sdist
+python -m build
+# Outputs: dist/app-generator-cli-0.1.0-py3-none-any.whl
+#          dist/app-generator-cli-0.1.0.tar.gz
+```
+
+### 2. Test on TestPyPI
+
+```bash
+twine upload --repository testpypi dist/*
+pip install --index-url https://test.pypi.org/simple/ app-generator-cli
+```
+
+### 3. Publish to PyPI
+
+```bash
+twine upload dist/*
+```
+
+Or with uv:
+
+```bash
+uv build
+uv publish
+```
+
+---
+
+## Development Setup
+
+```bash
+git clone https://github.com/yourname/app-generator-cli
+cd app-generator-cli
+
+uv venv
+uv sync --dev
+
+# Run locally
+uv run app-generator-cli --help
+
+# Tests
+uv run pytest
+
+# Lint
+uv run ruff check .
+uv run ruff format .
+```
+
+---
+
+## Requirements
+
+- Python ≥ 3.10
+- [`uv`](https://docs.astral.sh/uv/) installed on the system (for generated project env management)
+
+---
+
+## License
+
+MIT

app_generator_cli-1.0.1/app_generator/__init__.py

@@ -0,0 +1,10 @@
+"""PyForge CLI package."""
+
+from importlib.metadata import metadata
+
+try:
+	_meta = metadata("app-generator-cli")
+except Exception:
+	_meta = metadata("pyforge-cli")
+__version__ = _meta["Version"]
+__author__ = _meta["Author-email"]

app_generator_cli-1.0.1/app_generator/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI command modules."""

app_generator_cli-1.0.1/app_generator/commands/create.py

@@ -0,0 +1,74 @@
+"""
+`appgenerator create` subcommand group.
+Delegates to template-specific generators.
+"""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+
+from app_generator.generator import ProjectGenerator
+
+create_app = typer.Typer(no_args_is_help=True, rich_markup_mode="rich")
+console = Console()
+
+
+def _run_generator(
+    template: str,
+    project_name: str,
+    output_dir: Optional[Path],
+    docker: bool,
+    postgres: bool,
+    redis: bool,
+) -> None:
+    target = (output_dir or Path.cwd()) / project_name
+    if target.exists():
+        console.print(f"[bold red]✗[/] Directory [bold]{target}[/] already exists.")
+        raise typer.Exit(code=1)
+
+    generator = ProjectGenerator(
+        template=template,
+        project_name=project_name,
+        target_dir=target,
+        options={"docker": docker, "postgres": postgres, "redis": redis},
+    )
+    generator.run()
+
+
+@create_app.command("fastapi", help="Scaffold a [bold]FastAPI[/] backend project.")
+def create_fastapi(
+    project_name: str = typer.Argument(..., help="Name of the new project."),
+    output_dir: Optional[Path] = typer.Option(None, "--output", "-o", help="Parent directory."),
+    docker: bool = typer.Option(False, "--docker", help="Add Dockerfile & docker-compose.yml."),
+    postgres: bool = typer.Option(False, "--postgres", help="Add PostgreSQL support."),
+    redis: bool = typer.Option(False, "--redis", help="Add Redis support."),
+) -> None:
+    _run_generator("fastapi", project_name, output_dir, docker, postgres, redis)
+
+
+@create_app.command(
+    "fastapi-with-frontend",
+    help="Scaffold a [bold]FastAPI + Jinja frontend[/] project.",
+)
+def create_fastapi_with_frontend(
+    project_name: str = typer.Argument(..., help="Name of the new project."),
+    output_dir: Optional[Path] = typer.Option(None, "--output", "-o", help="Parent directory."),
+    docker: bool = typer.Option(False, "--docker", help="Add Dockerfile & docker-compose.yml."),
+    postgres: bool = typer.Option(False, "--postgres", help="Add PostgreSQL support."),
+    redis: bool = typer.Option(False, "--redis", help="Add Redis support."),
+) -> None:
+    _run_generator("fastapi-with-frontend", project_name, output_dir, docker, postgres, redis)
+
+
+@create_app.command("ai", help="Scaffold a [bold]LangChain / LangGraph[/] AI project.")
+def create_ai(
+    project_name: str = typer.Argument(..., help="Name of the new project."),
+    output_dir: Optional[Path] = typer.Option(None, "--output", "-o", help="Parent directory."),
+    docker: bool = typer.Option(False, "--docker", help="Add Dockerfile & docker-compose.yml."),
+    postgres: bool = typer.Option(False, "--postgres", help="Add PostgreSQL vector DB support."),
+    redis: bool = typer.Option(False, "--redis", help="Add Redis cache support."),
+) -> None:
+    _run_generator("ai", project_name, output_dir, docker, postgres, redis)