djm 0.0.1a0__tar.gz

djm-0.0.1a0/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Build package
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Install and run CLI
+        run: |
+          python -m pip install dist/*.whl
+          djm --help
+          djm init --help
+          djm goose --help

djm-0.0.1a0/.github/workflows/publish.yml

@@ -0,0 +1,45 @@
+name: Build and publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Build package
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Upload dist
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - name: Download dist
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.12.4
+        with:
+          packages-dir: dist/

djm-0.0.1a0/.gitignore

@@ -0,0 +1,15 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+*.sqlite3
+
+goose/
+goose_migrations/

djm-0.0.1a0/.python-version

@@ -0,0 +1 @@
+3.13

djm-0.0.1a0/Makefile

@@ -0,0 +1,30 @@
+# DJM: Django migration utilities (goose-style SQL, base mixins)
+# Use `uv run` or activate .venv before running make targets.
+
+.PHONY: help migrate goose clean install build
+
+help:
+	@echo "DJM – Django migration utilities (one app: djm)"
+	@echo ""
+	@echo "  make migrate     Apply Django migrations"
+	@echo "  make goose       Generate goose-style SQL files (djm app, dir: goose_migrations)"
+	@echo "  make goose OUT=dir   Generate into dir (e.g. OUT=./sql)"
+	@echo "  make clean       Remove generated goose files and __pycache__"
+	@echo "  make install     Install dependencies (uv sync)"
+	@echo "  make build       Build wheel/sdist for distribution"
+
+migrate:
+	uv run python manage.py migrate
+
+goose:
+	@OUT=$${OUT:-goose_migrations}; uv run python manage.py generate_goose -o $$OUT
+
+clean:
+	rm -f goose_migrations/*.sql 2>/dev/null || true
+	find . -type d -name __pycache__ ! -path './.venv/*' -exec rm -rf {} + 2>/dev/null || true
+
+install:
+	uv sync
+
+build:
+	uv build

djm-0.0.1a0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: djm
+Version: 0.0.1a0
+Summary: Generate goose-style SQL migrations from Django migrations, plus base model mixins
+Requires-Python: >=3.13
+Requires-Dist: django>=6.0.2
+Requires-Dist: uuid6>=2025.0.1
+Provides-Extra: dev
+Description-Content-Type: text/markdown
+
+# DJM
+
+CLI and helpers to go from **Django models → goose-style SQL migrations** (up/down). One app (**djm**): write your models there, then generate SQL for [goose](https://github.com/pressly/goose) or [golang-migrate](https://github.com/golang-migrate/migrate).
+
+## Quick start (CLI)
+
+1. **Install and create a project:**
+
+   ```bash
+   pip install djm
+   djm init myapp
+   cd myapp
+   ```
+
+2. **Write your models** in the `djm` app (edit `djm/models/`), then run migrations:
+
+   ```bash
+   uv sync   # or: pip install -e .
+   uv run python manage.py makemigrations djm
+   uv run python manage.py migrate
+   ```
+
+3. **Generate goose SQL** (up/down) into `goose_migrations/`:
+
+   ```bash
+   uv run python manage.py generate_goose
+   ```
+
+   From a project that has the `djm` CLI installed you can instead run:
+
+   ```bash
+   djm goose
+   ```
+
+4. Use the generated `.sql` files with goose or golang-migrate.
+
+## Requirements
+
+- Python ≥3.13 (or adjust in `pyproject.toml`)
+- Django ≥6.0
+- [uv](https://github.com/astral-shared/uv) (recommended) or pip
+
+## CLI
+
+| Command | Description |
+|--------|-------------|
+| `djm init [path]` | Create a new DJM project (default: current directory). Preconfigured with `djm` app and `generate_goose` command. |
+| `djm goose [-o DIR]` | Generate goose SQL migrations (run from project root; uses `manage.py generate_goose`). |
+
+## Project layout (after `djm init`)
+
+| Path | Purpose |
+|------|--------|
+| **djm/** | The only app: write your models here. Includes the `generate_goose` management command. |
+| **base/** | Reusable abstract model mixins: `UUIDPrimaryKeyMixin`, `TimestampsMixin`, `SoftDeleteMixin`, `SortNumberMixin`. |
+| **core/** | Main Django project (settings, urls). |
+
+## Commands (inside a project)
+
+- **Generate goose migrations:**
+  ```bash
+  uv run python manage.py generate_goose [--output-dir DIR] [--no-sql-extension]
+  ```
+  Uses the `djm` app. Default output dir is `goose_migrations`. Files are named `{migration_name}.sql`.
+
+## Base mixins
+
+Use these in your models (see `djm.models` and `base.models`):
+
+- **UUIDPrimaryKeyMixin** – UUID primary key (via `uuid6`).
+- **TimestampsMixin** – `created`, `updated` (auto_now_add / auto_now).
+- **SoftDeleteMixin** – `deleted` nullable datetime for soft deletes.
+- **SortNumberMixin** – `order_no` and default ordering.
+
+Import from `base.models`; the mixins are abstract and do not require `base` in `INSTALLED_APPS` unless you add migrations in `base`.
+
+## Shipping as a package
+
+The package ships **djm** (models + `generate_goose` command) and **base** (mixins). One app only; users write models in `djm`.
+
+- **Install:** `pip install -e /path/to/djm` or `pip install djm`
+- **In the consuming project:** Add `djm` to `INSTALLED_APPS`, write models in `djm`, run `python manage.py generate_goose -o your_goose_dir`.
+- **Build:** `make build` or `uv build`
+
+## Publishing to PyPI (GitHub Actions)
+
+The repo includes a workflow that builds and publishes to [PyPI](https://pypi.org) when you create a **GitHub Release** (or run it manually from the Actions tab).
+
+1. **One-time:** Add a [trusted publisher](https://pypi.org/manage/account/publishing/) on PyPI:
+   - PyPI project name: `djm`
+   - Repository: `OWNER/djm`
+   - Workflow name: `publish.yml`
+
+2. **To release:** Create a new release on GitHub (tag, e.g. `v0.1.0`). The workflow will build and publish the package to PyPI. No API token is needed (OIDC).
+
+- `.github/workflows/publish.yml` – build + publish to PyPI on release
+- `.github/workflows/ci.yml` – build only on push/PR to `main`
+
+## Makefile
+
+- `make help` – show targets  
+- `make migrate` – run Django migrations  
+- `make goose` – generate goose SQL into `goose_migrations`  
+- `make goose OUT=./sql` – generate into `./sql`  
+- `make clean` – remove generated goose files and `__pycache__`  
+- `make install` – `uv sync`  
+- `make build` – build distribution artifacts  
+
+## Notes
+
+- Django’s `sqlmigrate` supports **`--backwards`** (with an “s”) to print SQL that unapplies a migration; the generator uses this for the “Down” section.
+- Generated SQL is for the database configured in `settings.DATABASES["default"]` (e.g. SQLite). For PostgreSQL/MySQL, run the generator with that database configured.

djm-0.0.1a0/README.md

@@ -0,0 +1,112 @@
+# DJM
+
+CLI and helpers to go from **Django models → goose-style SQL migrations** (up/down). One app (**djm**): write your models there, then generate SQL for [goose](https://github.com/pressly/goose) or [golang-migrate](https://github.com/golang-migrate/migrate).
+
+## Quick start (CLI)
+
+1. **Install and create a project:**
+
+   ```bash
+   pip install djm
+   djm init myapp
+   cd myapp
+   ```
+
+2. **Write your models** in the `djm` app (edit `djm/models/`), then run migrations:
+
+   ```bash
+   uv sync   # or: pip install -e .
+   uv run python manage.py makemigrations djm
+   uv run python manage.py migrate
+   ```
+
+3. **Generate goose SQL** (up/down) into `goose_migrations/`:
+
+   ```bash
+   uv run python manage.py generate_goose
+   ```
+
+   From a project that has the `djm` CLI installed you can instead run:
+
+   ```bash
+   djm goose
+   ```
+
+4. Use the generated `.sql` files with goose or golang-migrate.
+
+## Requirements
+
+- Python ≥3.13 (or adjust in `pyproject.toml`)
+- Django ≥6.0
+- [uv](https://github.com/astral-shared/uv) (recommended) or pip
+
+## CLI
+
+| Command | Description |
+|--------|-------------|
+| `djm init [path]` | Create a new DJM project (default: current directory). Preconfigured with `djm` app and `generate_goose` command. |
+| `djm goose [-o DIR]` | Generate goose SQL migrations (run from project root; uses `manage.py generate_goose`). |
+
+## Project layout (after `djm init`)
+
+| Path | Purpose |
+|------|--------|
+| **djm/** | The only app: write your models here. Includes the `generate_goose` management command. |
+| **base/** | Reusable abstract model mixins: `UUIDPrimaryKeyMixin`, `TimestampsMixin`, `SoftDeleteMixin`, `SortNumberMixin`. |
+| **core/** | Main Django project (settings, urls). |
+
+## Commands (inside a project)
+
+- **Generate goose migrations:**
+  ```bash
+  uv run python manage.py generate_goose [--output-dir DIR] [--no-sql-extension]
+  ```
+  Uses the `djm` app. Default output dir is `goose_migrations`. Files are named `{migration_name}.sql`.
+
+## Base mixins
+
+Use these in your models (see `djm.models` and `base.models`):
+
+- **UUIDPrimaryKeyMixin** – UUID primary key (via `uuid6`).
+- **TimestampsMixin** – `created`, `updated` (auto_now_add / auto_now).
+- **SoftDeleteMixin** – `deleted` nullable datetime for soft deletes.
+- **SortNumberMixin** – `order_no` and default ordering.
+
+Import from `base.models`; the mixins are abstract and do not require `base` in `INSTALLED_APPS` unless you add migrations in `base`.
+
+## Shipping as a package
+
+The package ships **djm** (models + `generate_goose` command) and **base** (mixins). One app only; users write models in `djm`.
+
+- **Install:** `pip install -e /path/to/djm` or `pip install djm`
+- **In the consuming project:** Add `djm` to `INSTALLED_APPS`, write models in `djm`, run `python manage.py generate_goose -o your_goose_dir`.
+- **Build:** `make build` or `uv build`
+
+## Publishing to PyPI (GitHub Actions)
+
+The repo includes a workflow that builds and publishes to [PyPI](https://pypi.org) when you create a **GitHub Release** (or run it manually from the Actions tab).
+
+1. **One-time:** Add a [trusted publisher](https://pypi.org/manage/account/publishing/) on PyPI:
+   - PyPI project name: `djm`
+   - Repository: `OWNER/djm`
+   - Workflow name: `publish.yml`
+
+2. **To release:** Create a new release on GitHub (tag, e.g. `v0.1.0`). The workflow will build and publish the package to PyPI. No API token is needed (OIDC).
+
+- `.github/workflows/publish.yml` – build + publish to PyPI on release
+- `.github/workflows/ci.yml` – build only on push/PR to `main`
+
+## Makefile
+
+- `make help` – show targets  
+- `make migrate` – run Django migrations  
+- `make goose` – generate goose SQL into `goose_migrations`  
+- `make goose OUT=./sql` – generate into `./sql`  
+- `make clean` – remove generated goose files and `__pycache__`  
+- `make install` – `uv sync`  
+- `make build` – build distribution artifacts  
+
+## Notes
+
+- Django’s `sqlmigrate` supports **`--backwards`** (with an “s”) to print SQL that unapplies a migration; the generator uses this for the “Down” section.
+- Generated SQL is for the database configured in `settings.DATABASES["default"]` (e.g. SQLite). For PostgreSQL/MySQL, run the generator with that database configured.

djm-0.0.1a0/base/models/__init__.py

@@ -0,0 +1,11 @@
+from base.models.soft_delete import SoftDeleteMixin
+from base.models.sort import SortNumberMixin
+from base.models.timestamp import TimestampsMixin
+from base.models.uuid import UUIDPrimaryKeyMixin
+
+__all__ = [
+    "SortNumberMixin",
+    "SoftDeleteMixin",
+    "TimestampsMixin",
+    "UUIDPrimaryKeyMixin",
+]

djm-0.0.1a0/base/models/soft_delete.py

@@ -0,0 +1,15 @@
+from django.db import models
+
+
+class SoftDeleteMixin(models.Model):
+    class Meta:
+        abstract = True
+
+    deleted = models.DateTimeField(
+        blank=True,
+        null=True,
+        db_index=True,
+    )
+
+    def soft_delete(self):
+        raise NotImplementedError

djm-0.0.1a0/base/models/sort.py

@@ -0,0 +1,13 @@
+from django.db import models
+
+
+class SortNumberMixin(models.Model):
+    class Meta:
+        abstract = True
+        ordering = ("order_no",)
+
+    order_no = models.IntegerField(
+        null=False,
+        blank=True,
+        db_index=True,
+    )

djm-0.0.1a0/base/models/timestamp.py

@@ -0,0 +1,16 @@
+from django.db import models
+
+
+class TimestampsMixin(models.Model):
+    class Meta:
+        abstract = True
+
+    created = models.DateTimeField(
+        auto_now_add=True,
+        db_index=True,
+    )
+
+    updated = models.DateTimeField(
+        auto_now=True,
+        db_index=True,
+    )

djm-0.0.1a0/base/models/uuid.py

@@ -0,0 +1,15 @@
+from uuid6 import uuid6
+
+from django.db import models
+
+
+class UUIDPrimaryKeyMixin(models.Model):
+    class Meta:
+        abstract = True
+
+    id = models.UUIDField(
+        primary_key=True,
+        default=uuid6,
+        editable=False,
+        db_index=True,
+    )

djm-0.0.1a0/core/settings.py

@@ -0,0 +1,84 @@
+from pathlib import Path
+
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+
+SECRET_KEY = "django-insecure-j-y@ikzfm=)-w@qiz49-f1e+c-kuks#5djrv13hhoxfy95)hd$"
+
+DEBUG = True
+
+ALLOWED_HOSTS = []
+
+INSTALLED_APPS = [
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+    "djm",
+]
+
+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 = "core.urls"
+
+TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.django.DjangoTemplates",
+        "DIRS": [],
+        "APP_DIRS": True,
+        "OPTIONS": {
+            "context_processors": [
+                "django.template.context_processors.request",
+                "django.contrib.auth.context_processors.auth",
+                "django.contrib.messages.context_processors.messages",
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = "core.wsgi.application"
+
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": BASE_DIR / "db.sqlite3",
+    }
+}
+
+
+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/"

djm-0.0.1a0/core/urls.py

@@ -0,0 +1,6 @@
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path("admin/", admin.site.urls),
+]

djm-0.0.1a0/core/wsgi.py

@@ -0,0 +1,7 @@
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "core.settings")
+
+application = get_wsgi_application()

djm-0.0.1a0/djm/admin.py

@@ -0,0 +1,8 @@
+from django.apps import apps
+from django.contrib import admin
+
+app_config = apps.get_app_config("djm")
+
+for model_name, model in app_config.models.items():
+    if not admin.site.is_registered(model):
+        admin.site.register(model)

djm-0.0.1a0/djm/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+
+class DjmConfig(AppConfig):
+    name = 'djm'

djm-0.0.1a0/djm/cli.py

@@ -0,0 +1,112 @@
+"""
+DJM CLI: init a project or generate goose migrations.
+
+  djm init [path]     Create a new DJM project (default: current directory)
+  djm goose [-o DIR]  Generate goose-style SQL migrations (run from project root)
+"""
+import argparse
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="djm",
+        description="DJM – Django models to goose-style SQL migrations.",
+    )
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    # djm init [path]
+    init_p = subparsers.add_parser("init", help="Create a new DJM project")
+    init_p.add_argument(
+        "path",
+        nargs="?",
+        default=".",
+        help="Project directory (default: current directory)",
+    )
+
+    # djm goose [-o dir]
+    goose_p = subparsers.add_parser("goose", help="Generate goose SQL migrations")
+    goose_p.add_argument(
+        "-o",
+        "--output-dir",
+        type=Path,
+        default=Path("goose_migrations"),
+        help="Output directory for .sql files (default: goose_migrations)",
+    )
+
+    args = parser.parse_args()
+
+    if args.command == "init":
+        return cmd_init(Path(args.path))
+    if args.command == "goose":
+        return cmd_goose(args.output_dir)
+    return 0
+
+
+def cmd_init(dest: Path) -> int:
+    dest = dest.resolve()
+    if dest.exists() and any(dest.iterdir()):
+        print(f"Error: {dest} is not empty. Choose another path or use an empty directory.", file=sys.stderr)
+        return 1
+
+    try:
+        template_dir = _get_template_dir()
+    except Exception as e:
+        print(f"Error: could not find project template: {e}", file=sys.stderr)
+        return 1
+
+    dest.mkdir(parents=True, exist_ok=True)
+    for name in _list_template_contents(template_dir):
+        src = template_dir / name
+        out = dest / name
+        if src.is_dir():
+            shutil.copytree(src, out, dirs_exist_ok=True)
+        else:
+            out.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(src, out)
+
+    print(f"Created DJM project at {dest}")
+    print("Next steps:")
+    cd_name = dest.name if dest.name != "." else dest
+    print(f"  cd {cd_name}")
+    print("  uv sync   # or: pip install -e .")
+    print("  uv run python manage.py makemigrations djm")
+    print("  uv run python manage.py migrate")
+    print("  uv run python manage.py generate_goose   # → goose_migrations/*.sql")
+    return 0
+
+
+def _get_template_dir() -> Path:
+    try:
+        from importlib.resources import files
+        pkg = files("djm")
+        return pkg / "project_template"
+    except Exception:
+        pass
+    # Fallback: __file__ relative (e.g. development)
+    this = Path(__file__).resolve().parent
+    return this / "project_template"
+
+
+def _list_template_contents(template_dir: Path):
+    """Yield relative paths for all files and dirs in template (top-level names)."""
+    if not template_dir.is_dir():
+        raise FileNotFoundError(f"Template directory not found: {template_dir}")
+    return [p.name for p in template_dir.iterdir()]
+
+
+def cmd_goose(output_dir: Path) -> int:
+    cwd = Path.cwd()
+    manage_py = cwd / "manage.py"
+    if not manage_py.is_file():
+        print("Error: no manage.py in current directory. Run 'djm goose' from the project root.", file=sys.stderr)
+        return 1
+
+    result = subprocess.run(
+        [sys.executable, "manage.py", "generate_goose", "-o", str(output_dir)],
+        cwd=cwd,
+    )
+    return result.returncode

djm-0.0.1a0/djm/management/commands/generate_goose.py

@@ -0,0 +1,91 @@
+from pathlib import Path
+
+from django.apps import apps
+from django.core.management.base import BaseCommand, CommandError
+from django.db import connections
+from django.db.migrations.loader import MigrationLoader
+
+APP_LABEL = "djm"
+
+
+class Command(BaseCommand):
+    help = "Generate goose-style SQL migration files from Django migrations (djm app)."
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            "--output-dir",
+            "-o",
+            type=Path,
+            default=Path("goose_migrations"),
+            help="Output directory for .sql files (default: goose_migrations).",
+        )
+        parser.add_argument(
+            "--no-sql-extension",
+            action="store_true",
+            help="Write files without .sql extension (e.g. 0001_initial).",
+        )
+
+    def handle(self, output_dir, no_sql_extension, **options):
+        try:
+            apps.get_app_config(APP_LABEL)
+        except LookupError as e:
+            raise CommandError(str(e)) from e
+
+        connection = connections["default"]
+        loader = MigrationLoader(connection, replace_migrations=False)
+        if APP_LABEL not in loader.migrated_apps:
+            raise CommandError(f"App '{APP_LABEL}' does not have migrations.")
+
+        migration_names = [
+            name for (a, name) in loader.disk_migrations.keys() if a == APP_LABEL
+        ]
+        if not migration_names:
+            raise CommandError(f"No migrations found for app '{APP_LABEL}'.")
+
+        def sort_key(n):
+            parts = n.split("_", 1)
+            return (int(parts[0]) if parts[0].isdigit() else 0, n)
+
+        migration_names.sort(key=sort_key)
+
+        output_dir = Path(output_dir)
+        output_dir.mkdir(parents=True, exist_ok=True)
+        ext = "" if no_sql_extension else ".sql"
+
+        for name in migration_names:
+            up_sql = self._collect_sql(loader, name, backwards=False)
+            down_sql = self._collect_sql(loader, name, backwards=True)
+            path = output_dir / f"{name}{ext}"
+            content = self._format_goose(up_sql, down_sql)
+            path.write_text(content, encoding="utf-8")
+            self.stdout.write(f"Wrote {path}")
+
+        self.stdout.write(
+            self.style.SUCCESS(f"Done. {len(migration_names)} file(s) in {output_dir}")
+        )
+
+    def _collect_sql(self, loader, migration_name, backwards):
+        from django.db.migrations.loader import AmbiguityError
+
+        try:
+            migration = loader.get_migration_by_prefix(APP_LABEL, migration_name)
+        except (AmbiguityError, KeyError) as e:
+            raise CommandError(str(e)) from e
+        target = (APP_LABEL, migration.name)
+        plan = [(loader.graph.nodes[target], backwards)]
+        statements = loader.collect_sql(plan)
+        return "\n".join(statements) if statements else ""
+
+    def _format_goose(self, up_sql, down_sql):
+        parts = [
+            "-- +goose Up",
+            "-- +goose StatementBegin",
+            up_sql.strip(),
+            "-- +goose StatementEnd",
+            "",
+            "-- +goose Down",
+            "-- +goose StatementBegin",
+            down_sql.strip(),
+            "-- +goose StatementEnd",
+        ]
+        return "\n".join(parts).strip() + "\n"

djm-0.0.1a0/djm/migrations/0001_initial.py

@@ -0,0 +1,34 @@
+# Generated by Django 6.0.2
+
+import uuid6
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = []
+
+    operations = [
+        migrations.CreateModel(
+            name="Example",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        db_index=True,
+                        default=uuid6.uuid6,
+                        editable=False,
+                        primary_key=True,
+                        serialize=False,
+                    ),
+                ),
+                ("name", models.CharField(max_length=100)),
+            ],
+            options={
+                "db_table": "example",
+                "abstract": False,
+            },
+        ),
+    ]

djm-0.0.1a0/djm/models/__init__.py

@@ -0,0 +1,3 @@
+from djm.models.example import Example
+
+__all__ = ["Example"]

djm-0.0.1a0/djm/models/example.py

@@ -0,0 +1,10 @@
+"""Example model – replace or remove and add your own in djm.models."""
+from django.db import models
+from base.models import UUIDPrimaryKeyMixin
+
+
+class Example(UUIDPrimaryKeyMixin):
+    class Meta(UUIDPrimaryKeyMixin.Meta):
+        db_table = "example"
+
+    name = models.CharField(max_length=100)

djm-0.0.1a0/djm/project_template/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+*.py[cod]
+.venv/
+*.sqlite3
+goose_migrations/*.sql

djm-0.0.1a0/djm/project_template/base/models/__init__.py

@@ -0,0 +1,11 @@
+from base.models.soft_delete import SoftDeleteMixin
+from base.models.sort import SortNumberMixin
+from base.models.timestamp import TimestampsMixin
+from base.models.uuid import UUIDPrimaryKeyMixin
+
+__all__ = [
+    "SortNumberMixin",
+    "SoftDeleteMixin",
+    "TimestampsMixin",
+    "UUIDPrimaryKeyMixin",
+]

djm-0.0.1a0/djm/project_template/base/models/soft_delete.py

@@ -0,0 +1,11 @@
+from django.db import models
+
+
+class SoftDeleteMixin(models.Model):
+    class Meta:
+        abstract = True
+
+    deleted = models.DateTimeField(blank=True, null=True, db_index=True)
+
+    def soft_delete(self):
+        raise NotImplementedError

djm-0.0.1a0/djm/project_template/base/models/sort.py

@@ -0,0 +1,9 @@
+from django.db import models
+
+
+class SortNumberMixin(models.Model):
+    class Meta:
+        abstract = True
+        ordering = ("order_no",)
+
+    order_no = models.IntegerField(null=False, blank=True, db_index=True)

djm-0.0.1a0/djm/project_template/base/models/timestamp.py

@@ -0,0 +1,9 @@
+from django.db import models
+
+
+class TimestampsMixin(models.Model):
+    class Meta:
+        abstract = True
+
+    created = models.DateTimeField(auto_now_add=True, db_index=True)
+    updated = models.DateTimeField(auto_now=True, db_index=True)

djm-0.0.1a0/djm/project_template/base/models/uuid.py

@@ -0,0 +1,14 @@
+from uuid6 import uuid6
+from django.db import models
+
+
+class UUIDPrimaryKeyMixin(models.Model):
+    class Meta:
+        abstract = True
+
+    id = models.UUIDField(
+        primary_key=True,
+        default=uuid6,
+        editable=False,
+        db_index=True,
+    )

djm-0.0.1a0/djm/project_template/core/settings.py

@@ -0,0 +1,64 @@
+from pathlib import Path
+
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+SECRET_KEY = "change-me-in-production"
+DEBUG = True
+ALLOWED_HOSTS = []
+
+INSTALLED_APPS = [
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+    "djm",
+]
+
+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 = "core.urls"
+TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.django.DjangoTemplates",
+        "DIRS": [],
+        "APP_DIRS": True,
+        "OPTIONS": {
+            "context_processors": [
+                "django.template.context_processors.request",
+                "django.contrib.auth.context_processors.auth",
+                "django.contrib.messages.context_processors.messages",
+            ],
+        },
+    },
+]
+WSGI_APPLICATION = "core.wsgi.application"
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": BASE_DIR / "db.sqlite3",
+    }
+}
+
+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/"

djm-0.0.1a0/djm/project_template/core/urls.py

@@ -0,0 +1,6 @@
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path("admin/", admin.site.urls),
+]

djm-0.0.1a0/djm/project_template/core/wsgi.py

@@ -0,0 +1,5 @@
+import os
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "core.settings")
+application = get_wsgi_application()

djm-0.0.1a0/djm/project_template/djm/admin.py

@@ -0,0 +1,7 @@
+from django.apps import apps
+from django.contrib import admin
+
+app_config = apps.get_app_config("djm")
+for model_name, model in app_config.models.items():
+    if not admin.site.is_registered(model):
+        admin.site.register(model)

djm-0.0.1a0/djm/project_template/djm/apps.py

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

djm-0.0.1a0/djm/project_template/djm/management/commands/generate_goose.py

@@ -0,0 +1,95 @@
+"""
+Generate goose-style SQL migration files from Django migrations for the djm app.
+
+Usage:
+  python manage.py generate_goose [--output-dir DIR] [--no-sql-extension]
+"""
+from pathlib import Path
+
+from django.apps import apps
+from django.core.management.base import BaseCommand, CommandError
+from django.db import connections
+from django.db.migrations.loader import MigrationLoader
+
+APP_LABEL = "djm"
+
+
+class Command(BaseCommand):
+    help = "Generate goose-style SQL migration files from Django migrations (djm app)."
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            "--output-dir",
+            "-o",
+            type=Path,
+            default=Path("goose_migrations"),
+            help="Output directory for .sql files (default: goose_migrations).",
+        )
+        parser.add_argument(
+            "--no-sql-extension",
+            action="store_true",
+            help="Write files without .sql extension (e.g. 0001_initial).",
+        )
+
+    def handle(self, output_dir, no_sql_extension, **options):
+        try:
+            apps.get_app_config(APP_LABEL)
+        except LookupError as e:
+            raise CommandError(str(e)) from e
+
+        connection = connections["default"]
+        loader = MigrationLoader(connection, replace_migrations=False)
+        if APP_LABEL not in loader.migrated_apps:
+            raise CommandError(f"App '{APP_LABEL}' does not have migrations.")
+
+        migration_names = [
+            name for (a, name) in loader.disk_migrations.keys() if a == APP_LABEL
+        ]
+        if not migration_names:
+            raise CommandError(f"No migrations found for app '{APP_LABEL}'.")
+
+        def sort_key(n):
+            parts = n.split("_", 1)
+            return (int(parts[0]) if parts[0].isdigit() else 0, n)
+
+        migration_names.sort(key=sort_key)
+
+        output_dir = Path(output_dir)
+        output_dir.mkdir(parents=True, exist_ok=True)
+        ext = "" if no_sql_extension else ".sql"
+
+        for name in migration_names:
+            up_sql = self._collect_sql(loader, name, backwards=False)
+            down_sql = self._collect_sql(loader, name, backwards=True)
+            path = output_dir / f"{name}{ext}"
+            content = self._format_goose(up_sql, down_sql)
+            path.write_text(content, encoding="utf-8")
+            self.stdout.write(f"Wrote {path}")
+
+        self.stdout.write(self.style.SUCCESS(f"Done. {len(migration_names)} file(s) in {output_dir}"))
+
+    def _collect_sql(self, loader, migration_name, backwards):
+        from django.db.migrations.loader import AmbiguityError
+
+        try:
+            migration = loader.get_migration_by_prefix(APP_LABEL, migration_name)
+        except (AmbiguityError, KeyError) as e:
+            raise CommandError(str(e)) from e
+        target = (APP_LABEL, migration.name)
+        plan = [(loader.graph.nodes[target], backwards)]
+        statements = loader.collect_sql(plan)
+        return "\n".join(statements) if statements else ""
+
+    def _format_goose(self, up_sql, down_sql):
+        parts = [
+            "-- +goose Up",
+            "-- +goose StatementBegin",
+            up_sql.strip(),
+            "-- +goose StatementEnd",
+            "",
+            "-- +goose Down",
+            "-- +goose StatementBegin",
+            down_sql.strip(),
+            "-- +goose StatementEnd",
+        ]
+        return "\n".join(parts).strip() + "\n"

djm-0.0.1a0/djm/project_template/djm/models/__init__.py

@@ -0,0 +1,4 @@
+# Define your models in this package and import here.
+from djm.models.example import Example
+
+__all__ = ["Example"]

djm-0.0.1a0/djm/project_template/djm/models/example.py

@@ -0,0 +1,10 @@
+"""Example model – replace or remove and add your own in djm.models."""
+from django.db import models
+from base.models import UUIDPrimaryKeyMixin
+
+
+class Example(UUIDPrimaryKeyMixin):
+    class Meta(UUIDPrimaryKeyMixin.Meta):
+        db_table = "example"
+
+    name = models.CharField(max_length=100)

djm-0.0.1a0/djm/project_template/manage.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+
+
+def main():
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "core.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?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()

djm-0.0.1a0/djm/project_template/pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+name = "myproject"
+version = "0.1.0"
+requires-python = ">=3.13"
+dependencies = [
+    "django>=6.0.2",
+    "uuid6>=2025.0.1",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["core", "djm", "base"]

djm-0.0.1a0/manage.py

@@ -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', 'core.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()

djm-0.0.1a0/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "djm"
+version = "0.0.1-alpha"
+description = "Generate goose-style SQL migrations from Django migrations, plus base model mixins"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "django>=6.0.2",
+    "uuid6>=2025.0.1",
+]
+
+[project.optional-dependencies]
+dev = []
+
+[project.scripts]
+djm = "djm.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["djm", "base"]

djm-0.0.1a0/uv.lock

@@ -0,0 +1,69 @@
+version = 1
+revision = 3
+requires-python = ">=3.13"
+
+[[package]]
+name = "asgiref"
+version = "3.11.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/63/40/f03da1264ae8f7cfdbf9146542e5e7e8100a4c66ab48e791df9a03d3f6c0/asgiref-3.11.1.tar.gz", hash = "sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce", size = 38550, upload-time = "2026-02-03T13:30:14.33Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5c/0a/a72d10ed65068e115044937873362e6e32fab1b7dce0046aeb224682c989/asgiref-3.11.1-py3-none-any.whl", hash = "sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133", size = 24345, upload-time = "2026-02-03T13:30:13.039Z" },
+]
+
+[[package]]
+name = "django"
+version = "6.0.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "asgiref" },
+    { name = "sqlparse" },
+    { name = "tzdata", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/26/3e/a1c4207c5dea4697b7a3387e26584919ba987d8f9320f59dc0b5c557a4eb/django-6.0.2.tar.gz", hash = "sha256:3046a53b0e40d4b676c3b774c73411d7184ae2745fe8ce5e45c0f33d3ddb71a7", size = 10886874, upload-time = "2026-02-03T13:50:31.596Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/96/ba/a6e2992bc5b8c688249c00ea48cb1b7a9bc09839328c81dc603671460928/django-6.0.2-py3-none-any.whl", hash = "sha256:610dd3b13d15ec3f1e1d257caedd751db8033c5ad8ea0e2d1219a8acf446ecc6", size = 8339381, upload-time = "2026-02-03T13:50:15.501Z" },
+]
+
+[[package]]
+name = "djm"
+version = "0.0.1a0"
+source = { editable = "." }
+dependencies = [
+    { name = "django" },
+    { name = "uuid6" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "django", specifier = ">=6.0.2" },
+    { name = "uuid6", specifier = ">=2025.0.1" },
+]
+provides-extras = ["dev"]
+
+[[package]]
+name = "sqlparse"
+version = "0.5.5"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/90/76/437d71068094df0726366574cf3432a4ed754217b436eb7429415cf2d480/sqlparse-0.5.5.tar.gz", hash = "sha256:e20d4a9b0b8585fdf63b10d30066c7c94c5d7a7ec47c889a2d83a3caa93ff28e", size = 120815, upload-time = "2025-12-19T07:17:45.073Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/49/4b/359f28a903c13438ef59ebeee215fb25da53066db67b305c125f1c6d2a25/sqlparse-0.5.5-py3-none-any.whl", hash = "sha256:12a08b3bf3eec877c519589833aed092e2444e68240a3577e8e26148acc7b1ba", size = 46138, upload-time = "2025-12-19T07:17:46.573Z" },
+]
+
+[[package]]
+name = "tzdata"
+version = "2025.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/5e/a7/c202b344c5ca7daf398f3b8a477eeb205cf3b6f32e7ec3a6bac0629ca975/tzdata-2025.3.tar.gz", hash = "sha256:de39c2ca5dc7b0344f2eba86f49d614019d29f060fc4ebc8a417896a620b56a7", size = 196772, upload-time = "2025-12-13T17:45:35.667Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/b0/003792df09decd6849a5e39c28b513c06e84436a54440380862b5aeff25d/tzdata-2025.3-py2.py3-none-any.whl", hash = "sha256:06a47e5700f3081aab02b2e513160914ff0694bce9947d6b76ebd6bf57cfc5d1", size = 348521, upload-time = "2025-12-13T17:45:33.889Z" },
+]
+
+[[package]]
+name = "uuid6"
+version = "2025.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ca/b7/4c0f736ca824b3a25b15e8213d1bcfc15f8ac2ae48d1b445b310892dc4da/uuid6-2025.0.1.tar.gz", hash = "sha256:cd0af94fa428675a44e32c5319ec5a3485225ba2179eefcf4c3f205ae30a81bd", size = 13932, upload-time = "2025-07-04T18:30:35.186Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3d/b2/93faaab7962e2aa8d6e174afb6f76be2ca0ce89fde14d3af835acebcaa59/uuid6-2025.0.1-py3-none-any.whl", hash = "sha256:80530ce4d02a93cdf82e7122ca0da3ebbbc269790ec1cb902481fa3e9cc9ff99", size = 6979, upload-time = "2025-07-04T18:30:34.001Z" },
+]