codefortify-starter 1.1.0__tar.gz → 1.2.0__tar.gz

codefortify_starter-1.2.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+recursive-include src/codefortify_starter/templates *
+

{codefortify_starter-1.1.0/codefortify_starter.egg-info → codefortify_starter-1.2.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: codefortify-starter
-Version: 1.1.0
-Summary: A production-ready Django project generator with optional HTMX, DRF, Docker, Celery, Redis, PostgreSQL, and MySQL support.
+Version: 1.2.0
+Summary: Production-ready Django project starter generator by CodeFortify
 Author-email: Codefortify <maintainers@codefortify.dev>
 License: MIT
 Project-URL: Homepage, https://github.com/codefortify/codefortify-starter
@@ -24,9 +24,9 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: typer<1.0.0,>=0.12.0
-Requires-Dist: rich<14.0.0,>=13.7.0
-Requires-Dist: Jinja2<4.0.0,>=3.1.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: Jinja2>=3.1.0
 Dynamic: license-file
 
 # codefortify-starter
@@ -65,7 +65,7 @@ pip install codefortify-starter
 Install an exact version:
 
 ```bash
-pip install codefortify-starter==1.1.0
+pip install codefortify-starter==1.2.0
 ```
 
 Verify the CLI:
@@ -137,7 +137,7 @@ codefortify-startproject myproject --htmx --drf --docker --celery --database pos
 |---|---|---|
 | Django MVT | default | Clean Django project with settings, templates, static/media, and home app |
 | HTMX | `--htmx` | Adds `django-htmx`, middleware, and example partial views |
-| Django REST Framework | `--drf` | Adds DRF, API app, API routes, serializers, and tests |
+| Django REST Framework | `--drf` | Adds DRF, API app, API routes, and REST config |
 | Docker | `--docker` | Adds Dockerfile, docker-compose, entrypoint, deployment script, and Docker docs |
 | Celery + Redis | `--celery` | Adds Celery config, Redis broker settings, and example task |
 | PostgreSQL | `--database postgres` | Adds PostgreSQL-ready configuration |
@@ -149,24 +149,34 @@ codefortify-startproject myproject --htmx --drf --docker --celery --database pos
 ```text
 myproject/
 ├── apps/
+│   ├── accounts/
+│   ├── common/
 │   └── home/
 ├── core/
 │   ├── settings/
+│   │   ├── __init__.py
 │   │   ├── base.py
 │   │   ├── dev.py
-│   │   └── production.py
+│   │   ├── production.py
+│   │   └── test.py
 │   ├── urls.py
 │   ├── asgi.py
 │   ├── wsgi.py
 │   ├── templates/
 │   ├── static/
 │   └── media/
+├── docs/
+├── scripts/
 ├── manage.py
 ├── requirements/
 │   ├── base.txt
 │   ├── dev.txt
-│   └── production.txt
+│   ├── production.txt
+│   └── test.txt
+├── tests/
 ├── .env.example
+├── .gitignore
+├── Makefile
 └── README.md
 ```
 
@@ -174,11 +184,11 @@ Feature-specific files are added only when their flags are selected (for example
 
 ## Database Options
 
-- Default without `--docker`: SQLite
-- Default with `--docker`: PostgreSQL
+- Default: SQLite
 - Explicit: `--database postgres`, `--database mysql`, or `--database sqlite`
+- `--all` sets PostgreSQL automatically.
 
-Generated settings safely handle an empty `DATABASE_URL` and support local fallback behavior for development.
+Generated settings use environment variables with sane defaults for local development.
 
 ## HTMX Usage
 
@@ -243,7 +253,7 @@ docker compose ps
 ```bash
 python -m venv .pkgvenv
 source .pkgvenv/bin/activate
-pip install -r requirements/dev.txt
+pip install -r requirements.txt
 pip install -e .
 python -m pytest -q tests
 ```
@@ -277,7 +287,7 @@ Use this only for testing pre-release package builds:
 ```bash
 pip install --index-url https://test.pypi.org/simple/ \
   --extra-index-url https://pypi.org/simple \
-  codefortify-starter==1.1.0
+  codefortify-starter==1.2.0
 ```
 
 ## License

{codefortify_starter-1.1.0 → codefortify_starter-1.2.0}/README.md

@@ -34,7 +34,7 @@ pip install codefortify-starter
 Install an exact version:
 
 ```bash
-pip install codefortify-starter==1.1.0
+pip install codefortify-starter==1.2.0
 ```
 
 Verify the CLI:
@@ -106,7 +106,7 @@ codefortify-startproject myproject --htmx --drf --docker --celery --database pos
 |---|---|---|
 | Django MVT | default | Clean Django project with settings, templates, static/media, and home app |
 | HTMX | `--htmx` | Adds `django-htmx`, middleware, and example partial views |
-| Django REST Framework | `--drf` | Adds DRF, API app, API routes, serializers, and tests |
+| Django REST Framework | `--drf` | Adds DRF, API app, API routes, and REST config |
 | Docker | `--docker` | Adds Dockerfile, docker-compose, entrypoint, deployment script, and Docker docs |
 | Celery + Redis | `--celery` | Adds Celery config, Redis broker settings, and example task |
 | PostgreSQL | `--database postgres` | Adds PostgreSQL-ready configuration |
@@ -118,24 +118,34 @@ codefortify-startproject myproject --htmx --drf --docker --celery --database pos
 ```text
 myproject/
 ├── apps/
+│   ├── accounts/
+│   ├── common/
 │   └── home/
 ├── core/
 │   ├── settings/
+│   │   ├── __init__.py
 │   │   ├── base.py
 │   │   ├── dev.py
-│   │   └── production.py
+│   │   ├── production.py
+│   │   └── test.py
 │   ├── urls.py
 │   ├── asgi.py
 │   ├── wsgi.py
 │   ├── templates/
 │   ├── static/
 │   └── media/
+├── docs/
+├── scripts/
 ├── manage.py
 ├── requirements/
 │   ├── base.txt
 │   ├── dev.txt
-│   └── production.txt
+│   ├── production.txt
+│   └── test.txt
+├── tests/
 ├── .env.example
+├── .gitignore
+├── Makefile
 └── README.md
 ```
 
@@ -143,11 +153,11 @@ Feature-specific files are added only when their flags are selected (for example
 
 ## Database Options
 
-- Default without `--docker`: SQLite
-- Default with `--docker`: PostgreSQL
+- Default: SQLite
 - Explicit: `--database postgres`, `--database mysql`, or `--database sqlite`
+- `--all` sets PostgreSQL automatically.
 
-Generated settings safely handle an empty `DATABASE_URL` and support local fallback behavior for development.
+Generated settings use environment variables with sane defaults for local development.
 
 ## HTMX Usage
 
@@ -212,7 +222,7 @@ docker compose ps
 ```bash
 python -m venv .pkgvenv
 source .pkgvenv/bin/activate
-pip install -r requirements/dev.txt
+pip install -r requirements.txt
 pip install -e .
 python -m pytest -q tests
 ```
@@ -246,7 +256,7 @@ Use this only for testing pre-release package builds:
 ```bash
 pip install --index-url https://test.pypi.org/simple/ \
   --extra-index-url https://pypi.org/simple \
-  codefortify-starter==1.1.0
+  codefortify-starter==1.2.0
 ```
 
 ## License

{codefortify_starter-1.1.0 → codefortify_starter-1.2.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codefortify-starter"
-version = "1.1.0"
-description = "A production-ready Django project generator with optional HTMX, DRF, Docker, Celery, Redis, PostgreSQL, and MySQL support."
+version = "1.2.0"
+description = "Production-ready Django project starter generator by CodeFortify"
 readme = "README.md"
 requires-python = ">=3.10"
 license = { text = "MIT" }
@@ -46,9 +46,9 @@ classifiers = [
   "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dependencies = [
-  "typer>=0.12.0,<1.0.0",
-  "rich>=13.7.0,<14.0.0",
-  "Jinja2>=3.1.0,<4.0.0",
+  "click>=8.1.0",
+  "rich>=13.0.0",
+  "Jinja2>=3.1.0",
 ]
 
 [project.scripts]
@@ -60,8 +60,10 @@ Source = "https://github.com/codefortify/codefortify-starter"
 
 [tool.setuptools]
 include-package-data = true
+package-dir = {"" = "src"}
 
 [tool.setuptools.packages.find]
+where = ["src"]
 include = ["codefortify_starter*"]
 
 [tool.setuptools.package-data]
@@ -69,3 +71,6 @@ codefortify_starter = ["templates/**/*"]
 
 [tool.pytest.ini_options]
 DJANGO_SETTINGS_MODULE = "core.settings.dev"
+pythonpath = ["src"]
+testpaths = ["tests"]
+norecursedirs = ["src/codefortify_starter/templates"]

{codefortify_starter-1.1.0 → codefortify_starter-1.2.0/src}/codefortify_starter/__init__.py

@@ -1,7 +1,7 @@
 """Codefortify starter project generator package."""
 
-from codefortify_starter.constants import PACKAGE_VERSION
+from codefortify_starter.config import PACKAGE_VERSION
 
 __all__ = ["PACKAGE_VERSION", "__version__"]
 
-__version__ = PACKAGE_VERSION
+__version__ = "1.2.0"

{codefortify_starter-1.1.0 → codefortify_starter-1.2.0/src}/codefortify_starter/cli.py

@@ -4,8 +4,9 @@ from __future__ import annotations
 
 from pathlib import Path
 
-import typer
+import click
 from rich.console import Console
+from rich.panel import Panel
 
 from codefortify_starter.generator import StarterProjectGenerator, build_generation_options
 from codefortify_starter.validators import ValidationError, build_project_identity, normalize_database
@@ -14,25 +15,33 @@ from codefortify_starter.validators import ValidationError, build_project_identi
 console = Console()
 
 
-def run(
-    project_name: str = typer.Argument(..., help="Project directory name to create."),
-    htmx: bool = typer.Option(False, "--htmx", help="Include HTMX integration."),
-    drf: bool = typer.Option(False, "--drf", help="Include Django REST Framework starter API."),
-    docker: bool = typer.Option(False, "--docker", help="Include Docker and Compose files."),
-    celery: bool = typer.Option(False, "--celery", help="Include Celery + Redis task setup."),
-    database: str | None = typer.Option(
-        None,
-        "--database",
-        help="Database backend to configure: sqlite, postgres, or mysql.",
-    ),
-    no_git: bool = typer.Option(False, "--no-git", help="Skip git repository initialization."),
-    force: bool = typer.Option(False, "--force", help="Allow generation into an existing directory."),
-    directory: Path = typer.Option(Path("."), "--directory", help="Parent directory for the generated project."),
-    all_features: bool = typer.Option(
-        False,
-        "--all",
-        help="Enable full-stack preset: --htmx --drf --docker --celery --database postgres.",
-    ),
+@click.command(context_settings={"help_option_names": ["-h", "--help"]})
+@click.argument("project_name")
+@click.option("--htmx", is_flag=True, help="Include HTMX integration.")
+@click.option("--drf", is_flag=True, help="Include Django REST Framework starter API.")
+@click.option("--docker", is_flag=True, help="Include Docker and Compose files.")
+@click.option("--celery", is_flag=True, help="Include Celery + Redis task setup.")
+@click.option("--database", type=click.Choice(["sqlite", "postgres", "mysql"], case_sensitive=False))
+@click.option("--no-git", is_flag=True, help="Skip git repository initialization.")
+@click.option("--force", is_flag=True, help="Allow generation into an existing directory.")
+@click.option("--directory", type=click.Path(path_type=Path), default=Path("."), show_default=True)
+@click.option(
+    "--all",
+    "all_features",
+    is_flag=True,
+    help="Enable full-stack preset: --htmx --drf --docker --celery --database postgres.",
+)
+def main(
+    project_name: str,
+    htmx: bool,
+    drf: bool,
+    docker: bool,
+    celery: bool,
+    database: str | None,
+    no_git: bool,
+    force: bool,
+    directory: Path,
+    all_features: bool,
 ) -> None:
     """Generate a Django starter project."""
     try:
@@ -46,7 +55,6 @@ def run(
 
         resolved_database = normalize_database(database, use_docker=docker)
         identity = build_project_identity(project_name)
-
         options = build_generation_options(
             project_name=identity.project_name,
             project_slug=identity.project_slug,
@@ -66,38 +74,41 @@ def run(
         result = generator.generate(options)
     except (ValidationError, FileExistsError, NotADirectoryError, RuntimeError) as exc:
         console.print(f"[bold red]Error:[/bold red] {exc}")
-        raise typer.Exit(code=1) from exc
+        raise SystemExit(1) from exc
 
     selected_features = []
-    if htmx:
-        selected_features.append("htmx")
     if drf:
         selected_features.append("drf")
+    if htmx:
+        selected_features.append("htmx")
     if docker:
         selected_features.append("docker")
     if celery:
         selected_features.append("celery")
     features_text = ", ".join(selected_features) if selected_features else "base"
 
-    console.print(
-        f"[bold green]Created[/bold green] {result.project_path} "
-        f"(database={resolved_database}, features={features_text})"
+    summary = (
+        f"Project: [bold]{result.project_path.name}[/bold]\n"
+        f"Location: {result.project_path}\n"
+        f"Database: {resolved_database}\n"
+        f"Features: {features_text}"
     )
+    console.print(Panel(summary, title="CodeFortify Starter", expand=False))
+
     if result.warnings:
         for warning in result.warnings:
             console.print(f"[yellow]Warning:[/yellow] {warning}")
 
     console.print("Next steps:")
     console.print(f"  1. cd {result.project_path}")
-    console.print("  2. python -m venv .venv && source .venv/bin/activate")
-    console.print("  3. pip install -r requirements/dev.txt")
-    console.print("  4. cp .env.example .env")
-    console.print("  5. python manage.py migrate && python manage.py runserver")
-
-
-def main() -> None:
-    typer.run(run)
+    console.print("  2. cp .env.example .env")
+    console.print("  3. python -m venv venv")
+    console.print("  4. source venv/bin/activate")
+    console.print("  5. pip install -r requirements/dev.txt")
+    console.print("  6. python manage.py migrate")
+    console.print("  7. python manage.py createsuperuser")
+    console.print("  8. python manage.py runserver")
 
-
-if __name__ == "__main__":
-    main()
+    if docker:
+        console.print("\nDocker:")
+        console.print("  docker compose up --build")

codefortify_starter-1.2.0/src/codefortify_starter/config.py

@@ -0,0 +1,61 @@
+"""Configuration defaults for the generator."""
+
+from __future__ import annotations
+
+from typing import Final
+
+
+PACKAGE_NAME: Final[str] = "codefortify-starter"
+IMPORT_PACKAGE: Final[str] = "codefortify_starter"
+CLI_COMMAND: Final[str] = "codefortify-startproject"
+PACKAGE_VERSION: Final[str] = "1.2.0"
+
+VALID_DATABASES: Final[tuple[str, ...]] = ("sqlite", "postgres", "mysql")
+
+BASE_REQUIREMENTS: Final[tuple[str, ...]] = (
+    "Django>=5.2,<6.1",
+    "django-environ",
+    "Pillow",
+)
+
+DEV_REQUIREMENTS: Final[tuple[str, ...]] = (
+    "django-debug-toolbar",
+    "ipython",
+    "ruff",
+    "black",
+    "pre-commit",
+)
+
+TEST_REQUIREMENTS: Final[tuple[str, ...]] = (
+    "pytest",
+    "pytest-django",
+    "pytest-cov",
+    "factory-boy",
+    "faker",
+)
+
+PRODUCTION_REQUIREMENTS: Final[tuple[str, ...]] = (
+    "gunicorn",
+    "whitenoise",
+    "sentry-sdk",
+)
+
+FEATURE_REQUIREMENTS: Final[dict[str, tuple[str, ...]]] = {
+    "drf": ("djangorestframework",),
+    "htmx": ("django-htmx",),
+    "celery": ("celery", "redis"),
+}
+
+DATABASE_REQUIREMENTS: Final[dict[str, tuple[str, ...]]] = {
+    "sqlite": (),
+    "postgres": ("psycopg[binary]", "dj-database-url"),
+    "mysql": ("mysqlclient", "dj-database-url"),
+}
+
+EXECUTABLE_FILES: Final[tuple[str, ...]] = (
+    "scripts/entrypoint.sh",
+    "scripts/wait-for-db.sh",
+    "scripts/create-superuser.sh",
+    "scripts/backup-db.sh",
+)
+

codefortify_starter-1.2.0/src/codefortify_starter/constants.py

@@ -0,0 +1,31 @@
+"""Shared constants for the starter generator."""
+
+from codefortify_starter.config import (  # noqa: F401
+    BASE_REQUIREMENTS,
+    CLI_COMMAND,
+    DATABASE_REQUIREMENTS,
+    DEV_REQUIREMENTS,
+    EXECUTABLE_FILES,
+    FEATURE_REQUIREMENTS,
+    IMPORT_PACKAGE,
+    PACKAGE_NAME,
+    PACKAGE_VERSION,
+    PRODUCTION_REQUIREMENTS,
+    TEST_REQUIREMENTS,
+    VALID_DATABASES,
+)
+
+__all__ = [
+    "BASE_REQUIREMENTS",
+    "CLI_COMMAND",
+    "DATABASE_REQUIREMENTS",
+    "DEV_REQUIREMENTS",
+    "EXECUTABLE_FILES",
+    "FEATURE_REQUIREMENTS",
+    "IMPORT_PACKAGE",
+    "PACKAGE_NAME",
+    "PACKAGE_VERSION",
+    "PRODUCTION_REQUIREMENTS",
+    "TEST_REQUIREMENTS",
+    "VALID_DATABASES",
+]

codefortify_starter-1.2.0/src/codefortify_starter/exceptions.py

@@ -0,0 +1,12 @@
+"""Custom exceptions for the generator."""
+
+from __future__ import annotations
+
+
+class StarterError(RuntimeError):
+    """Base exception for starter errors."""
+
+
+class ValidationError(StarterError):
+    """Raised when user inputs are invalid."""
+