snapstack 1.0.0__py3-none-any.whl

pysnap/templates/django/.dockerignore.j2

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+.env
+dist/
+*.egg-info/
+.pytest_cache/
+.coverage
+htmlcov/
+*.log
+.DS_Store
+Thumbs.db
+.git/
+staticfiles/

pysnap/templates/django/.github/workflows/ci.yml.j2

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+{% if package_manager == "uv" %}
+      - name: Install uv
+        run: pip install uv
+      - name: Install dependencies
+        run: uv sync
+      - name: Lint
+        run: uv run ruff check .
+      - name: Test
+        run: uv run pytest
+{% else %}
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Lint
+        run: ruff check .
+      - name: Test
+        run: pytest
+{% endif %}

pysnap/templates/django/.gitignore.j2

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.env
+.venv/
+venv/
+dist/
+build/
+*.db
+.pytest_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+staticfiles/

pysnap/templates/django/Dockerfile.j2

@@ -0,0 +1,14 @@
+FROM python:3.11-slim
+WORKDIR /app
+{% if package_manager == "uv" -%}
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /bin/uv
+COPY pyproject.toml uv.lock* ./
+RUN uv sync --frozen --no-dev
+COPY . .
+CMD ["uv", "run", "python", "manage.py", "runserver", "0.0.0.0:8000"]
+{%- else -%}
+COPY pyproject.toml ./
+RUN pip install --no-cache-dir -e .
+COPY . .
+CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]
+{%- endif %}

pysnap/templates/django/README.md.j2

@@ -0,0 +1,36 @@
+# {{ project_name }}
+
+A Django project generated by [pysnap](https://github.com/pysnap-dev/pysnap).
+
+## Quick Start
+
+```bash
+{% if package_manager == "uv" %}
+uv sync
+uv run python manage.py migrate
+uv run python manage.py runserver
+{% else %}
+pip install -e ".[dev]"
+python manage.py migrate
+python manage.py runserver
+{% endif %}
+```
+
+{% if include_docker %}
+## Docker
+
+```bash
+docker compose up
+```
+{% endif %}
+{% if include_tests %}
+## Tests
+
+```bash
+{% if package_manager == "uv" %}
+uv run pytest
+{% else %}
+pytest
+{% endif %}
+```
+{% endif %}

pysnap/templates/django/apps/core/apps.py.j2

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class CoreConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "apps.core"

pysnap/templates/django/apps/core/urls.py.j2

@@ -0,0 +1,7 @@
+from django.urls import path
+
+from apps.core import views
+
+urlpatterns = [
+    path("health/", views.health_check, name="health-check"),
+]

pysnap/templates/django/apps/core/views.py.j2

@@ -0,0 +1,6 @@
+from django.http import JsonResponse
+
+
+def health_check(request):
+    """Health check endpoint."""
+    return JsonResponse({"status": "ok", "service": "{{ project_name }}"})

pysnap/templates/django/apps/users/apps.py.j2

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class UsersConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "apps.users"

pysnap/templates/django/apps/users/models.py.j2

@@ -0,0 +1,14 @@
+from django.contrib.auth.models import AbstractUser
+from django.db import models
+
+
+class User(AbstractUser):
+    """Custom user model."""
+
+    email = models.EmailField(unique=True)
+
+    USERNAME_FIELD = "email"
+    REQUIRED_FIELDS = ["username"]
+
+    class Meta:
+        ordering = ["-date_joined"]

pysnap/templates/django/apps/users/serializers.py.j2

@@ -0,0 +1,13 @@
+from rest_framework import serializers
+from apps.users.models import User
+
+
+class RegisterSerializer(serializers.ModelSerializer):
+    password = serializers.CharField(write_only=True, min_length=8)
+
+    class Meta:
+        model = User
+        fields = ["email", "username", "password"]
+
+    def create(self, validated_data):
+        return User.objects.create_user(**validated_data)

pysnap/templates/django/apps/users/urls.py.j2

@@ -0,0 +1,10 @@
+from django.urls import path
+from rest_framework_simplejwt.views import TokenObtainPairView, TokenRefreshView
+
+from apps.users.views import RegisterView
+
+urlpatterns = [
+    path("register/", RegisterView.as_view(), name="register"),
+    path("token/", TokenObtainPairView.as_view(), name="token-obtain"),
+    path("token/refresh/", TokenRefreshView.as_view(), name="token-refresh"),
+]

pysnap/templates/django/apps/users/views.py.j2

@@ -0,0 +1,22 @@
+from rest_framework import status
+from rest_framework.response import Response
+from rest_framework.views import APIView
+from rest_framework.permissions import AllowAny
+from rest_framework_simplejwt.tokens import RefreshToken
+
+from apps.users.serializers import RegisterSerializer
+
+
+class RegisterView(APIView):
+    permission_classes = [AllowAny]
+
+    def post(self, request):
+        serializer = RegisterSerializer(data=request.data)
+        if serializer.is_valid():
+            user = serializer.save()
+            refresh = RefreshToken.for_user(user)
+            return Response(
+                {"access": str(refresh.access_token), "refresh": str(refresh)},
+                status=status.HTTP_201_CREATED,
+            )
+        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

pysnap/templates/django/config/asgi.py.j2

@@ -0,0 +1,9 @@
+"""ASGI config for {{ project_name }} project."""
+
+import os
+
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "config.settings")
+
+application = get_asgi_application()

pysnap/templates/django/config/settings.py.j2

@@ -0,0 +1,110 @@
+"""
+Django settings for {{ project_name }}.
+"""
+
+from pathlib import Path
+
+from decouple import Csv, config
+
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+SECRET_KEY = config("SECRET_KEY", default="insecure-change-me-in-production")
+
+DEBUG = config("DEBUG", default=False, cast=bool)
+
+ALLOWED_HOSTS: list[str] = config("ALLOWED_HOSTS", default="localhost,127.0.0.1", cast=Csv())
+
+INSTALLED_APPS = [
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+    "apps.core",
+{% if include_auth %}
+    "rest_framework",
+    "rest_framework_simplejwt",
+    "apps.users",
+{% endif %}
+]
+
+MIDDLEWARE = [
+    "django.middleware.security.SecurityMiddleware",
+    "django.contrib.sessions.middleware.SessionMiddleware",
+    "django.middleware.common.CommonMiddleware",
+    "django.middleware.csrf.CsrfViewMiddleware",
+    "django.contrib.auth.middleware.AuthenticationMiddleware",
+    "django.contrib.messages.middleware.MessageMiddleware",
+    "django.middleware.clickjacking.XFrameOptionsMiddleware",
+]
+
+ROOT_URLCONF = "config.urls"
+
+TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.django.DjangoTemplates",
+        "DIRS": [],
+        "APP_DIRS": True,
+        "OPTIONS": {
+            "context_processors": [
+                "django.template.context_processors.debug",
+                "django.template.context_processors.request",
+                "django.contrib.auth.context_processors.auth",
+                "django.contrib.messages.context_processors.messages",
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = "config.wsgi.application"
+
+{% if database == "postgresql" %}
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.postgresql",
+        "NAME": config("POSTGRES_DB", default="{{ project_name_slug }}"),
+        "USER": config("POSTGRES_USER", default="user"),
+        "PASSWORD": config("POSTGRES_PASSWORD", default="password"),
+        "HOST": config("POSTGRES_HOST", default="localhost"),
+        "PORT": config("POSTGRES_PORT", default="5432"),
+    }
+}
+{% else %}
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": BASE_DIR / "db.sqlite3",
+    }
+}
+{% endif %}
+
+AUTH_PASSWORD_VALIDATORS = [
+    {"NAME": "django.contrib.auth.password_validation.UserAttributeSimilarityValidator"},
+    {"NAME": "django.contrib.auth.password_validation.MinimumLengthValidator"},
+    {"NAME": "django.contrib.auth.password_validation.CommonPasswordValidator"},
+    {"NAME": "django.contrib.auth.password_validation.NumericPasswordValidator"},
+]
+
+LANGUAGE_CODE = "en-us"
+TIME_ZONE = "UTC"
+USE_I18N = True
+USE_TZ = True
+
+STATIC_URL = "static/"
+STATIC_ROOT = BASE_DIR / "staticfiles"
+
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
+
+{% if include_auth %}
+AUTH_USER_MODEL = "users.User"
+
+REST_FRAMEWORK = {
+    "DEFAULT_AUTHENTICATION_CLASSES": [
+        "rest_framework_simplejwt.authentication.JWTAuthentication",
+    ],
+    "DEFAULT_PERMISSION_CLASSES": [
+        "rest_framework.permissions.IsAuthenticated",
+    ],
+}
+{% endif %}

pysnap/templates/django/config/urls.py.j2

@@ -0,0 +1,12 @@
+"""config URL configuration."""
+
+from django.contrib import admin
+from django.urls import include, path
+
+urlpatterns = [
+    path("admin/", admin.site.urls),
+    path("api/", include("apps.core.urls")),
+{% if include_auth %}
+    path("api/auth/", include("apps.users.urls")),
+{% endif %}
+]

pysnap/templates/django/config/wsgi.py.j2

@@ -0,0 +1,9 @@
+"""WSGI config for {{ project_name }} project."""
+
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "config.settings")
+
+application = get_wsgi_application()

pysnap/templates/django/docker-compose.yml.j2

@@ -0,0 +1,29 @@
+services:
+  app:
+    build: .
+    ports:
+      - "8000:8000"
+    env_file:
+      - .env
+{% if database == "postgresql" %}
+    depends_on:
+      db:
+        condition: service_healthy
+  db:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-user}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-password}
+      POSTGRES_DB: ${POSTGRES_DB:-{{ project_name_slug }}}
+    ports:
+      - "5432:5432"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER:-user}"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+volumes:
+  pgdata:
+{% endif %}

pysnap/templates/django/manage.py.j2

@@ -0,0 +1,22 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+
+
+def main():
+    """Run administrative tasks."""
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "config.settings")
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()

pysnap/templates/django/pyproject.toml.j2

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "{{ project_name }}"
+version = "0.1.0"
+description = "Generated by pysnap"
+requires-python = ">=3.11"
+dependencies = [
+    "django>=4.2.0",
+    "python-decouple>=3.8",
+{%- if database == "postgresql" %}
+    "psycopg[binary]>=3.1.0",
+{%- endif %}
+{%- if include_auth %}
+    "djangorestframework>=3.15.0",
+    "djangorestframework-simplejwt>=5.3.0",
+{%- endif %}
+]
+
+[project.optional-dependencies]
+dev = [
+{%- if include_tests %}
+    "pytest>=8.0.0",
+    "pytest-django>=4.8.0",
+{%- endif %}
+    "ruff>=0.8.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["apps", "config"]
+
+[tool.pytest.ini_options]
+DJANGO_SETTINGS_MODULE = "config.settings"
+pythonpath = ["."]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"

pysnap/templates/django/template.json

@@ -0,0 +1,50 @@
+{
+  "name": "django",
+  "display_name": "Django",
+  "description": "Classic Django project with best-practice structure, health check, and optional PostgreSQL",
+  "version": "1.0.0",
+  "files": {
+    "always": {
+      "manage.py.j2":                   "manage.py",
+      "pyproject.toml.j2":              "pyproject.toml",
+      ".gitignore.j2":                  ".gitignore",
+      ".env.example.j2":                ".env.example",
+      "README.md.j2":                   "README.md",
+      "config/__init__.py.j2":          "config/__init__.py",
+      "config/settings.py.j2":         "config/settings.py",
+      "config/urls.py.j2":             "config/urls.py",
+      "config/wsgi.py.j2":             "config/wsgi.py",
+      "config/asgi.py.j2":             "config/asgi.py",
+      "apps/__init__.py.j2":            "apps/__init__.py",
+      "apps/core/__init__.py.j2":       "apps/core/__init__.py",
+      "apps/core/apps.py.j2":           "apps/core/apps.py",
+      "apps/core/views.py.j2":          "apps/core/views.py",
+      "apps/core/urls.py.j2":           "apps/core/urls.py"
+    },
+    "when_auth": {
+      "apps/users/__init__.py.j2":       "apps/users/__init__.py",
+      "apps/users/apps.py.j2":           "apps/users/apps.py",
+      "apps/users/models.py.j2":         "apps/users/models.py",
+      "apps/users/views.py.j2":          "apps/users/views.py",
+      "apps/users/urls.py.j2":           "apps/users/urls.py",
+      "apps/users/serializers.py.j2":    "apps/users/serializers.py"
+    },
+    "when_docker": {
+      "Dockerfile.j2":           "Dockerfile",
+      "docker-compose.yml.j2":   "docker-compose.yml",
+      ".dockerignore.j2":        ".dockerignore"
+    },
+    "when_tests": {
+      "tests/__init__.py.j2":     "tests/__init__.py",
+      "tests/conftest.py.j2":     "tests/conftest.py",
+      "tests/test_health.py.j2":  "tests/test_health.py"
+    },
+    "when_ci": {
+      ".github/workflows/ci.yml.j2": ".github/workflows/ci.yml"
+    }
+  },
+  "prompts": [],
+  "hooks": {
+    "post_generate": []
+  }
+}

pysnap/templates/django/tests/__init__.py.j2

@@ -0,0 +1 @@
+"""Django tests package."""

pysnap/templates/django/tests/conftest.py.j2

@@ -0,0 +1,6 @@
+import pytest
+
+
+@pytest.fixture(scope="session")
+def django_db_setup():
+    pass

pysnap/templates/django/tests/test_health.py.j2

@@ -0,0 +1,9 @@
+import pytest
+
+
+@pytest.mark.django_db
+def test_health_check(client):
+    response = client.get("/api/health/")
+    assert response.status_code == 200
+    data = response.json()
+    assert data["status"] == "ok"

pysnap/templates/fastapi/.dockerignore.j2

@@ -0,0 +1,8 @@
+.env
+.venv/
+venv/
+__pycache__/
+*.pyc
+.git/
+.pytest_cache/
+*.db

pysnap/templates/fastapi/.github/workflows/ci.yml.j2

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+{%- if package_manager == "uv" %}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync --frozen
+
+      - name: Lint
+        run: uv run ruff check .
+{%- if include_tests %}
+
+      - name: Test
+        run: uv run pytest tests/ -v
+{%- endif %}
+{%- else %}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check .
+{%- if include_tests %}
+
+      - name: Test
+        run: pytest tests/ -v
+{%- endif %}
+{%- endif %}

pysnap/templates/fastapi/.gitignore.j2

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.env
+.venv/
+venv/
+dist/
+build/
+*.db
+.pytest_cache/
+.ruff_cache/
+htmlcov/
+.coverage

pysnap/templates/fastapi/Dockerfile.j2

@@ -0,0 +1,14 @@
+FROM python:3.11-slim
+WORKDIR /app
+{% if package_manager == "uv" -%}
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /bin/uv
+COPY pyproject.toml uv.lock* ./
+RUN uv sync --frozen --no-dev
+COPY . .
+CMD ["uv", "run", "uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
+{%- else -%}
+COPY pyproject.toml app/__init__.py ./app/
+RUN pip install --no-cache-dir .
+COPY . .
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
+{%- endif %}