django-migraid 0.1.0b1__tar.gz

django_migraid-0.1.0b1/.claude/settings.local.json

@@ -0,0 +1,11 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "Bash(python3 *)",
+      "Bash(grep -E \"\\\\.py$\")",
+      "Bash(cat)",
+      "Read(//tmp/**)"
+    ]
+  }
+}

django_migraid-0.1.0b1/.editorconfig

@@ -0,0 +1,21 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.yml]
+indent_size = 2
+
+[*.toml]
+indent_size = 4
+
+[Makefile]
+indent_style = tab
+
+[*.md]
+trim_trailing_whitespace = false

django_migraid-0.1.0b1/.github/workflows/ci.yml

@@ -0,0 +1,55 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install lint deps
+        run: pip install ruff mypy "django-stubs[compatible-mypy]>=4.2" Django>=4.2 libcst>=1.1 rich>=13.0 gitpython>=3.1
+      - run: ruff check src tests
+      - run: ruff format --check src tests
+      - run: mypy src/migraid
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+        django-version: ["4.2", "5.0", "5.1"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          pip install "Django~=${{ matrix.django-version }}.0" -e ".[dev]"
+      - name: Run tests with coverage
+        run: pytest --cov=migraid --cov-report=xml --cov-report=term
+      - uses: codecov/codecov-action@v4
+        if: matrix.python-version == '3.12' && matrix.django-version == '5.1'
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false
+
+  docs:
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    needs: [lint, test]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install mkdocs-material
+      - run: mkdocs build --strict

django_migraid-0.1.0b1/.gitignore

@@ -0,0 +1,55 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+*.egg
+MANIFEST
+
+.venv/
+env/
+venv/
+ENV/
+
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+.tox/
+.nox/
+
+*.mo
+*.pot
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+instance/
+.webassets-cache
+
+.scrapy
+
+docs/_build/
+docs/site/
+
+.DS_Store
+.env
+.env.*
+
+*.log
+*.pid
+
+dist/
+node_modules/
+
+.idea/
+.vscode/
+*.swp
+*.swo

django_migraid-0.1.0b1/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.3.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.8.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - django-stubs[compatible-mypy]
+          - types-gitpython
+        args: [--strict]

django_migraid-0.1.0b1/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0b1] - 2024-05-26
+
+### Added
+- Beta release with initial feature set.
+- All features from 0.1.0-alpha.
+
+## [0.1.0] - 2024-01-01
+
+### Added
+- `doctor` command: read-only diagnostic with 11 issue detectors (E001–E004, W001–W005, I001–I002)
+- `rebase` command: renumber branch-local migrations onto a target branch
+- `fix-conflicts` command: linearize conflicting leaf migrations
+- `renumber` command: fix gap/duplicate numbering for an app
+- `prune` command: remove stale `django_migrations` rows
+- `graph` command: visualize migration DAG in ASCII, Mermaid, or Graphviz dot format
+- Static-first analysis (Tier 1) using libcst — works on broken/mid-rebase repos
+- Live Django loader integration (Tier 2) for DB-dependent checks
+- Safety pipeline: dirty-tree guard, applied-migration guard, backup ref, undo log, post-apply validation
+- Apache 2.0 license
+
+[Unreleased]: https://github.com/AhmedShehab/django-migraid/compare/v0.1.0b1...HEAD
+[0.1.0b1]: https://github.com/AhmedShehab/django-migraid/releases/tag/v0.1.0b1
+[0.1.0]: https://github.com/AhmedShehab/django-migraid/releases/tag/v0.1.0

django_migraid-0.1.0b1/CODE_OF_CONDUCT.md

@@ -0,0 +1,26 @@
+# Code of Conduct
+
+## Our Pledge
+
+We pledge to make participation in our community a harassment-free experience for everyone.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+
+Examples of unacceptable behavior:
+- Harassment in any form
+- Trolling or insulting comments
+- Publishing others' private information without consent
+
+## Enforcement
+
+Instances of abusive behavior may be reported to the project maintainers. All complaints will be reviewed and investigated.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

django_migraid-0.1.0b1/CONTRIBUTING.md

@@ -0,0 +1,45 @@
+# Contributing to django-migraid
+
+Thank you for contributing!
+
+## Development Setup
+
+```bash
+git clone https://github.com/yourusername/django-migraid
+cd django-migraid
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+pre-commit install
+```
+
+## Running Tests
+
+```bash
+pytest                          # run all tests
+pytest --cov=migraid            # with coverage
+pytest tests/test_analysis/     # specific module
+tox                             # full matrix (Python 3.10-3.12 × Django 4.2/5.0/5.1)
+```
+
+## Adding a New Issue Detector
+
+1. Add an issue code and description to the table in `docs/known-issues.md`
+2. Add the code to `src/migraid/analysis/issues.py` — write a detector function following the `Callable[[MigrationAnalyzer], list[Issue]]` signature
+3. Register it in `ALL_DETECTORS` at the bottom of `issues.py`
+4. Write a test in `tests/test_analysis/test_issues.py` with a fixture from `tests/fixtures/`
+
+## Code Style
+
+- `ruff check src tests` — zero issues
+- `ruff format src tests` — consistent formatting
+- `mypy src/migraid` — strict, clean
+- Type hints on every public function
+
+## Pull Request Checklist
+
+- [ ] Tests added / updated
+- [ ] `pytest --cov=migraid` ≥ 85%
+- [ ] `ruff check src tests` passes
+- [ ] `mypy src/migraid` passes
+- [ ] `CHANGELOG.md` updated under `[Unreleased]`

django_migraid-0.1.0b1/LICENSE

@@ -0,0 +1,174 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other transformations
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean, as submitted to the Licensor for inclusion
+      in the Work by the copyright owner or by an individual or Legal Entity
+      authorized to submit on behalf of the copyright owner. For the purposes
+      of this definition, "submit" means any form of electronic, verbal, or
+      written communication sent to the Licensor or its representatives,
+      including but not limited to communication on electronic mailing lists,
+      source code control systems, and issue tracking systems that are managed
+      by, or on behalf of, the Licensor for the purpose of contributing to
+      the Work.
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and included
+      within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by the combination of their Contributions
+      with the Work to which such Contributions were submitted. If You
+      institute patent litigation against any entity (including a cross-claim
+      or counterclaim in a lawsuit) alleging that the Work or any patent
+      claim (s) embodied in the Work constitute direct or contributory patent
+      infringement, then any patent rights granted to You under this License
+      for that Work shall terminate as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative Works
+          a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in all Source forms of the Work and Derivative
+          Works that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work, excluding
+          those notices that do not pertain to any part of the Derivative
+          Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, You must include a readable copy of the attribution
+          notices contained within such NOTICE file, in at least one of the
+          following places: within a NOTICE text file distributed as part of
+          the Derivative Works; within the Source form or documentation, if
+          provided along with the Derivative Works; or, within a display
+          generated by the Derivative Works, if and wherever such third-party
+          notices normally appear. The contents of the NOTICE file are for
+          informational purposes only and do not modify the License.
+
+      (e) You may add Your own attribution notices within Derivative Works
+          that You distribute, alongside or in addition to the NOTICE text
+          from the Work, provided that such additional attribution notices
+          cannot be construed as modifying the License.
+
+      You may add Your own license statement for Your modifications and
+      may provide additional grant of rights to use, copy, modify, merge,
+      publish, distribute, sublicense, and/or sell copies of the Work.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or reproducing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (even if such Contributor has been advised of the possibility
+      of such damages).
+
+   9. Accepting Warranty or Liability. While redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a fee
+      for, acceptance of support, warranty, indemnity, or other liability
+      obligations and/or rights consistent with this License. However, in
+      accepting such obligations, You may offer only on your own behalf and
+      on your sole responsibility, not on behalf of any other Contributor,
+      and only if You agree to indemnify, defend, and hold each Contributor
+      harmless for any liability incurred by, or claims asserted against,
+      such Contributor by reason of your accepting any warranty or
+      additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2024 django-migraid contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

django_migraid-0.1.0b1/NOTICE

@@ -0,0 +1,6 @@
+django-migraid
+Copyright 2024 django-migraid contributors
+
+This product includes software developed by the django-migraid contributors.
+
+Licensed under the Apache License, Version 2.0.

django_migraid-0.1.0b1/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: django-migraid
+Version: 0.1.0b1
+Summary: Detect, diagnose, and auto-fix Django migration problems in Git workflows
+Project-URL: Homepage, https://github.com/AhmedShehab/django-migraid
+Project-URL: Repository, https://github.com/AhmedShehab/django-migraid
+Project-URL: Documentation, https://AhmedShehab.github.io/django-migraid
+Project-URL: Changelog, https://github.com/AhmedShehab/django-migraid/blob/main/CHANGELOG.md
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: devtools,django,git,migrations,rebase
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: django>=4.2
+Requires-Dist: gitpython>=3.1
+Requires-Dist: libcst>=1.1
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: coverage[toml]>=7.3; extra == 'dev'
+Requires-Dist: django-stubs[compatible-mypy]>=4.2; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.0; extra == 'dev'
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pytest-django>=4.7; extra == 'dev'
+Requires-Dist: pytest>=7.4; extra == 'dev'
+Requires-Dist: ruff>=0.3; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# django-migraid
+
+**Detect, diagnose, and auto-fix Django migration problems in Git workflows.**
+
+[![CI](https://github.com/AhmedShehab/django-migraid/actions/workflows/ci.yml/badge.svg)](https://github.com/AhmedShehab/django-migraid/actions)
+[![PyPI](https://img.shields.io/pypi/v/django-migraid.svg)](https://pypi.org/project/django-migraid/)
+[![Python](https://img.shields.io/pypi/pyversions/django-migraid.svg)](https://pypi.org/project/django-migraid/)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+
+---
+
+## The Problem
+
+Two developers branch from `main` at migration `0004`. Both generate `0005_*.py`. Main merges one. The second developer's rebase leaves them with a conflict that `makemigrations --merge` doesn't cleanly handle in rebase-based workflows. django-migraid fixes this — and ten other common migration pain points.
+
+## Installation
+
+```bash
+pip install django-migraid
+```
+
+Add to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    ...
+    "migraid",
+]
+```
+
+## Quick Start
+
+```bash
+# Diagnose all migration issues in your project
+python manage.py migraid doctor
+
+# Rebase your branch's migrations onto main
+python manage.py migraid rebase --base main --dry-run
+
+# Fix conflicting leaf migrations
+python manage.py migraid fix-conflicts --dry-run
+
+# Fix out-of-order numbering
+python manage.py migraid renumber myapp --dry-run
+
+# Remove stale django_migrations rows
+python manage.py migraid prune
+
+# Visualize the migration DAG
+python manage.py migraid graph myapp --format mermaid
+```
+
+## Problems This Solves
+
+| Issue | Code | Command |
+|-------|------|---------|
+| Conflicting leaf migrations (parallel development) | E001 | `fix-conflicts` |
+| Circular migration dependencies | E002 | — (reports) |
+| Out-of-order / gap numbering after rebase | E003 | `renumber` |
+| Dependency on a deleted migration | E004 | — (reports) |
+| Stale `django_migrations` rows | W001 | `prune` |
+| `RunPython` without `reverse_code` | W002 | — (reports) |
+| Squashed migration with old files still present | W003 | — (reports) |
+| Merge migrations in a rebase-workflow repo | W004 | `rebase` |
+| Non-deterministic dependency ordering | W005 | — (reports) |
+| Cross-app dependency risks | I001 | — (reports) |
+| `--fake` / `--fake-initial` footgun patterns | I002 | — (reports) |
+
+## Command Reference
+
+### `doctor`
+
+Read-only diagnostic. Reports every detected issue with severity.
+
+```bash
+python manage.py migraid doctor [--app LABEL] [--format text|json]
+```
+
+### `rebase`
+
+Renumber local branch migrations to follow the latest from a target branch.
+
+```bash
+python manage.py migraid rebase [--base BRANCH] [--app LABEL] [--dry-run] [--yes] [--force] [--allow-applied]
+```
+
+### `fix-conflicts`
+
+Resolve multiple-leaf conflicts by linearizing the fork.
+
+```bash
+python manage.py migraid fix-conflicts [--app LABEL] [--dry-run] [--yes] [--force] [--allow-applied]
+```
+
+### `renumber`
+
+Fix gap or duplicate numbering in a single app's migrations.
+
+```bash
+python manage.py migraid renumber <app> [--dry-run] [--yes] [--force] [--allow-applied]
+```
+
+### `prune`
+
+Remove orphaned `django_migrations` rows for migrations no longer on disk.
+
+```bash
+python manage.py migraid prune [--dry-run] [--yes] [--allow-applied]
+```
+
+### `graph`
+
+Print or export the migration DAG.
+
+```bash
+python manage.py migraid graph [app] [--format mermaid|dot|ascii] [--output FILE]
+```
+
+## Safety Model
+
+Every mutation command:
+1. Checks for uncommitted git changes (bypass with `--force`)
+2. Guards against rewriting already-applied migrations (bypass with `--allow-applied`)
+3. Creates a `migraid-backup-<timestamp>` git ref before any writes
+4. Shows a diff-style preview before making changes
+5. Asks for confirmation (bypass with `--yes`)
+6. Maintains an undo log — reverses all file ops automatically if anything fails
+7. Self-validates after apply: if the migration graph gets worse, auto-reverts
+
+`--dry-run` on any mutation command prints the full preview without writing.
+
+## CI Integration
+
+Add to your pre-push hook or CI pipeline:
+
+```bash
+python manage.py migraid doctor --format json | jq '.[] | select(.severity == "error")'
+```
+
+Or fail CI on any ERROR-level issue:
+
+```bash
+python manage.py migraid doctor
+```
+
+(exits non-zero if any E0xx issues are found)
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE).