litestar-start 0.1.0a2__tar.gz

litestar_start-0.1.0a2/.gitignore

@@ -0,0 +1,13 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.tmp
+.github/prompts
+docs/prd

litestar_start-0.1.0a2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harshal Laheri
+
+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.

litestar_start-0.1.0a2/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: litestar-start
+Version: 0.1.0a2
+Summary: Interactive CLI to scaffold fullstack projects with modular choices
+Project-URL: Documentation, https://github.com/Harshal6927/litestar-start#readme
+Project-URL: Issues, https://github.com/Harshal6927/litestar-start/issues
+Project-URL: Source, https://github.com/Harshal6927/litestar-start
+Author-email: Harshal Laheri <harshal@harshallaheri.me>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,fullstack,generator,litestar,scaffolding,template
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: msgspec>=0.20.0
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: rich>=14.2.0
+Description-Content-Type: text/markdown
+
+# Litestar Start
+
+**Litestar Start** is an interactive CLI tool designed to scaffold production-ready fullstack applications with modular choices. It combines modern python tooling with established patterns to get you up and running quickly.
+
+## Features
+
+*   **Interactive CLI**: Beautiful terminal interface using `rich` and `questionary`.
+*   **Backend Frameworks**:
+    *   [Litestar](https://litestar.dev/)
+    *   [FastAPI](https://fastapi.tiangolo.com/)
+*   **Frontend Frameworks**:
+    *   [React](https://react.dev/)
+*   **Database Support**:
+    *   PostgreSQL
+    *   MySQL
+    *   SQLite
+    *   MongoDB
+*   **ORM Integration**:
+    *   [SQLAlchemy](https://www.sqlalchemy.org/)
+*   **Tooling**:
+    *   Docker & Docker Compose support
+    *   GitHub Actions CI/CD workflows
+    *   Ruff & Pre-commit linting configuration
+
+## Installation
+
+You can install and run `litestar-start` using `uvx` or `pipx`:
+
+```bash
+uvx litestar-start
+
+# or
+
+pipx run litestar-start
+```
+
+## Usage
+
+Simply run the command and follow the interactive prompts:
+
+```bash
+litestar-start
+```
+
+You will be asked to configure:
+1.  **Project Details**: Name and description.
+2.  **Tech Stack**: Backend, Frontend, Database, ORM.
+3.  **Features**: Docker, CI/CD, Testing, Linting.
+
+## Contributing
+
+We welcome contributions! Whether it's adding a new framework, fixing a bug, or improving documentation.
+
+Please read our [Developer Guide](DEVELOPMENT.md) to get started with setting up the project locally.
+
+## License
+
+MIT

litestar_start-0.1.0a2/README.md

@@ -0,0 +1,58 @@
+# Litestar Start
+
+**Litestar Start** is an interactive CLI tool designed to scaffold production-ready fullstack applications with modular choices. It combines modern python tooling with established patterns to get you up and running quickly.
+
+## Features
+
+*   **Interactive CLI**: Beautiful terminal interface using `rich` and `questionary`.
+*   **Backend Frameworks**:
+    *   [Litestar](https://litestar.dev/)
+    *   [FastAPI](https://fastapi.tiangolo.com/)
+*   **Frontend Frameworks**:
+    *   [React](https://react.dev/)
+*   **Database Support**:
+    *   PostgreSQL
+    *   MySQL
+    *   SQLite
+    *   MongoDB
+*   **ORM Integration**:
+    *   [SQLAlchemy](https://www.sqlalchemy.org/)
+*   **Tooling**:
+    *   Docker & Docker Compose support
+    *   GitHub Actions CI/CD workflows
+    *   Ruff & Pre-commit linting configuration
+
+## Installation
+
+You can install and run `litestar-start` using `uvx` or `pipx`:
+
+```bash
+uvx litestar-start
+
+# or
+
+pipx run litestar-start
+```
+
+## Usage
+
+Simply run the command and follow the interactive prompts:
+
+```bash
+litestar-start
+```
+
+You will be asked to configure:
+1.  **Project Details**: Name and description.
+2.  **Tech Stack**: Backend, Frontend, Database, ORM.
+3.  **Features**: Docker, CI/CD, Testing, Linting.
+
+## Contributing
+
+We welcome contributions! Whether it's adding a new framework, fixing a bug, or improving documentation.
+
+Please read our [Developer Guide](DEVELOPMENT.md) to get started with setting up the project locally.
+
+## License
+
+MIT

litestar_start-0.1.0a2/pyproject.toml

@@ -0,0 +1,48 @@
+[project]
+authors = [{ name = "Harshal Laheri", email = "harshal@harshallaheri.me" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Code Generators",
+]
+dependencies = ["questionary>=2.1.1", "rich>=14.2.0", "jinja2>=3.1.6", "pydantic>=2.12.5", "msgspec>=0.20.0"]
+description = "Interactive CLI to scaffold fullstack projects with modular choices"
+keywords = ["litestar", "scaffolding", "cli", "fullstack", "template", "generator"]
+license = "MIT"
+name = "litestar-start"
+readme = "README.md"
+requires-python = ">=3.10"
+version = "0.1.0a2"
+
+[project.scripts]
+litestar-start = "litestar_start.cli:main"
+
+[project.urls]
+Documentation = "https://github.com/Harshal6927/litestar-start#readme"
+Issues = "https://github.com/Harshal6927/litestar-start/issues"
+Source = "https://github.com/Harshal6927/litestar-start"
+
+[build-system]
+build-backend = "hatchling.build"
+requires = ["hatchling"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/litestar_start"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/templates"]
+
+
+[tool.ruff]
+line-length = 120
+lint.ignore = ["CPY001", "D100"]
+
+[dependency-groups]
+dev = ["pre-commit>=4.5.1", "pytest>=9.0.2"]

litestar_start-0.1.0a2/src/litestar_start/__init__.py

@@ -0,0 +1,15 @@
+"""Litestar Start - Interactive CLI for scaffolding fullstack projects."""
+
+from litestar_start.core.config import ProjectConfig
+from litestar_start.generators.loader import register_all_generators
+from litestar_start.generators.project import ProjectOrchestrator
+from litestar_start.generators.registry import GeneratorRegistry
+
+__version__ = "0.1.0a2"
+
+__all__ = [
+    "GeneratorRegistry",
+    "ProjectConfig",
+    "ProjectOrchestrator",
+    "register_all_generators",
+]

litestar_start-0.1.0a2/src/litestar_start/backends/__init__.py

@@ -0,0 +1,5 @@
+"""Backend generators package."""
+
+from litestar_start.backends.base import BackendGenerator
+
+__all__ = ["BackendGenerator"]

litestar_start-0.1.0a2/src/litestar_start/backends/base.py

@@ -0,0 +1,185 @@
+"""Base class for backend generators."""
+
+from __future__ import annotations
+
+import shutil
+from abc import abstractmethod
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from litestar_start.core.base import BaseGenerator
+from litestar_start.core.utils import ensure_dir, write_file
+
+if TYPE_CHECKING:
+    from litestar_start.core.base import GeneratorContext
+
+
+class BackendGenerator(BaseGenerator):
+    """Abstract base class for backend generators."""
+
+    def generate(self, context: GeneratorContext) -> None:
+        """Generate backend code.
+
+        Args:
+            context: Generator context.
+
+        """
+        backend_dir = context.output_dir / "backend"
+        ensure_dir(backend_dir)
+
+        # Generate pyproject.toml
+        self._generate_pyproject(backend_dir, context)
+
+        # Generate app structure
+        self._generate_app_structure(backend_dir, context)
+
+        # Copy template files (Dockerfile, README, etc.)
+        self._copy_template_files(backend_dir, context)
+
+        # Apply plugins
+        self._apply_plugins(backend_dir, context)
+
+    @abstractmethod
+    def _generate_pyproject(self, backend_dir: Path, context: GeneratorContext) -> None:
+        """Generate pyproject.toml for the backend.
+
+        Args:
+            backend_dir: Backend directory path.
+            context: Generator context.
+
+        """
+        ...
+
+    @abstractmethod
+    def _generate_app_structure(self, backend_dir: Path, context: GeneratorContext) -> None:
+        """Generate the application structure.
+
+        Args:
+            backend_dir: Backend directory path.
+            context: Generator context.
+
+        """
+        ...
+
+    def _apply_plugins(self, backend_dir: Path, context: GeneratorContext) -> None:
+        """Apply plugins to enhance the backend.
+
+        Args:
+            backend_dir: Backend directory path.
+            context: Generator context.
+
+        """
+        # Plugin application will be implemented when plugins are created
+
+    def _copy_template_files(self, backend_dir: Path, context: GeneratorContext) -> None:
+        """Copy template files to backend directory.
+
+        Args:
+            backend_dir: Backend directory path.
+            context: Generator context.
+
+        """
+        templates_dir = Path(__file__).parent / "templates"
+
+        # Copy Dockerfile
+        if (templates_dir / "Dockerfile").exists():
+            shutil.copy2(templates_dir / "Dockerfile", backend_dir / "Dockerfile")
+
+        # Copy .dockerignore
+        if (templates_dir / ".dockerignore").exists():
+            shutil.copy2(templates_dir / ".dockerignore", backend_dir / ".dockerignore")
+
+        # Copy .gitignore
+        if (templates_dir / ".gitignore").exists():
+            shutil.copy2(templates_dir / ".gitignore", backend_dir / ".gitignore")
+
+        # Copy README (with templating)
+        if (templates_dir / "README.md").exists():
+            readme_template = (templates_dir / "README.md").read_text()
+            readme_content = readme_template.replace("{{ project_name }}", context.project_name)
+            readme_content = readme_content.replace("{{ project_slug }}", context.project_slug)
+            readme_content = readme_content.replace("{{ description }}", context.description or "")
+            write_file(backend_dir / "README.md", readme_content)
+
+        # Copy tests directory
+        tests_template_dir = templates_dir / "tests"
+        if tests_template_dir.exists():
+            tests_dir = backend_dir / "tests"
+            ensure_dir(tests_dir)
+            for test_file in tests_template_dir.glob("*.py"):
+                shutil.copy2(test_file, tests_dir / test_file.name)
+
+    @staticmethod
+    def _create_pyproject_content(
+        project_name: str,
+        dependencies: list[str],
+        dev_dependencies: list[str] | None = None,
+    ) -> str:
+        """Create pyproject.toml content.
+
+        Args:
+            project_name: Project name.
+            dependencies: List of dependencies.
+            dev_dependencies: Optional list of dev dependencies.
+
+        Returns:
+            Pyproject.toml content as string.
+
+        """
+        dev_dependencies = dev_dependencies or [
+            "pytest>=8.0.0",
+            "pytest-cov>=4.1.0",
+            "pytest-asyncio>=0.23.0",
+            "ruff>=0.4.0",
+            "mypy>=1.9.0",
+        ]
+
+        deps_str = "\n".join(f'    "{dep}",' for dep in dependencies)
+        dev_deps_str = "\n".join(f'    "{dep}",' for dep in dev_dependencies)
+
+        return f"""[project]
+name = "{project_name}-backend"
+version = "0.1.0"
+description = "Backend for {project_name}"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+{deps_str}
+]
+
+[project.optional-dependencies]
+dev = [
+{dev_deps_str}
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.uv]
+dev-dependencies = [
+{dev_deps_str}
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+"""

litestar_start-0.1.0a2/src/litestar_start/backends/fastapi/__init__.py

@@ -0,0 +1,5 @@
+"""FastAPI backend generator package."""
+
+from litestar_start.backends.fastapi.generator import FastAPIGenerator
+
+__all__ = ["FastAPIGenerator"]

litestar_start-0.1.0a2/src/litestar_start/backends/fastapi/generator.py

@@ -0,0 +1,110 @@
+"""FastAPI backend generator."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from litestar_start.backends.base import BackendGenerator
+from litestar_start.core.templates import TemplateLoader
+from litestar_start.core.utils import ensure_dir, write_file
+
+if TYPE_CHECKING:
+    from litestar_start.core.base import GeneratorContext
+
+
+class FastAPIGenerator(BackendGenerator):
+    """Generator for FastAPI backend projects."""
+
+    def __init__(self) -> None:
+        """Initialize the FastAPI generator."""
+        super().__init__()
+        self.template_loader = TemplateLoader()
+        # Register FastAPI-specific templates
+        self.template_loader.register_template_dir("fastapi", Path(__file__).parent / "templates")
+
+    @property
+    def name(self) -> str:
+        """Generator name."""
+        return "fastapi"
+
+    @property
+    def display_name(self) -> str:
+        """Human-readable name."""
+        return "FastAPI"
+
+    def get_dependencies(self) -> list[str]:
+        """Get FastAPI dependencies.
+
+        Returns:
+            List of package dependencies.
+
+        """
+        return [
+            "fastapi>=0.109.0",
+            "uvicorn[standard]>=0.27.0",
+            "python-dotenv>=1.0.0",
+            "msgspec>=0.20.0",
+        ]
+
+    def _generate_pyproject(self, backend_dir: Path, context: GeneratorContext) -> None:
+        """Generate pyproject.toml for FastAPI.
+
+        Args:
+            backend_dir: Backend directory path.
+            context: Generator context.
+
+        """
+        template_context = {
+            "project_slug": context.project_slug,
+            "description": context.description,
+            "dependencies": self.get_dependencies(),
+        }
+        content = self.template_loader.render("fastapi:pyproject.toml.jinja", template_context)
+        write_file(backend_dir / "pyproject.toml", content)
+
+        # Create .python-version for uv
+        write_file(backend_dir / ".python-version", "3.12\n")
+
+        # Create .gitignore
+        gitignore_content = self.template_loader.render("fastapi:gitignore.jinja", {})
+        write_file(backend_dir / ".gitignore", gitignore_content)
+
+    def _generate_app_structure(self, backend_dir: Path, context: GeneratorContext) -> None:
+        """Generate FastAPI application structure.
+
+        Args:
+            backend_dir: Backend directory path.
+            context: Generator context.
+
+        """
+        app_dir = backend_dir / "app"
+        ensure_dir(app_dir)
+
+        template_context = {
+            "project_name": context.project_name,
+            "project_slug": context.project_slug,
+            "description": context.description,
+        }
+
+        # Create __init__.py
+        init_content = self.template_loader.render("fastapi:app/__init__.py.jinja", {})
+        write_file(app_dir / "__init__.py", init_content)
+
+        # Create main.py
+        main_content = self.template_loader.render("fastapi:app/main.py.jinja", template_context)
+        write_file(app_dir / "main.py", main_content)
+
+        # Create config.py
+        config_content = self.template_loader.render("fastapi:app/config.py.jinja", template_context)
+        write_file(app_dir / "config.py", config_content)
+
+        # Create api directory
+        api_dir = app_dir / "api"
+        ensure_dir(api_dir)
+        api_init_content = self.template_loader.render("fastapi:api/__init__.py.jinja", {})
+        write_file(api_dir / "__init__.py", api_init_content)
+
+        # Create routes.py
+        routes_content = self.template_loader.render("fastapi:api/routes.py.jinja", {})
+        write_file(api_dir / "routes.py", routes_content)

litestar_start-0.1.0a2/src/litestar_start/backends/fastapi/plugins/__init__.py

@@ -0,0 +1,15 @@
+"""Plugins for FastAPI backend."""
+
+from litestar_start.generators.registry import GeneratorRegistry
+
+from .sqlalchemy import SQLAlchemyPlugin
+
+# Register all plugins for FastAPI
+_plugins = [
+    SQLAlchemyPlugin,
+]
+
+for plugin in _plugins:
+    GeneratorRegistry.register_plugin("fastapi", plugin)
+
+__all__ = ["SQLAlchemyPlugin"]