migradiff 1.1.0__tar.gz

migradiff-1.1.0/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <http://unlicense.org>

migradiff-1.1.0/PKG-INFO

@@ -0,0 +1,291 @@
+Metadata-Version: 2.4
+Name: migradiff
+Version: 1.1.0
+Summary: Like `diff` but for PostgreSQL schemas — actively maintained fork
+License: MIT
+License-File: LICENSE
+Author: MigraDiff Team
+Author-email: migradiff@anomalyco.com
+Requires-Python: >=3.7,<4
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Provides-Extra: pg
+Requires-Dist: psycopg2-binary ; extra == "pg"
+Requires-Dist: schemainspect (>=3.1.1663480743)
+Requires-Dist: six
+Requires-Dist: sqlbag
+Project-URL: Homepage, https://github.com/migradiff/migra
+Project-URL: Repository, https://github.com/migradiff/migra
+Description-Content-Type: text/markdown
+
+# migra — PostgreSQL Schema Diff Tool
+
+[![PyPI version](https://img.shields.io/pypi/v/migradiff)](https://pypi.org/project/migradiff/)
+[![Python versions](https://img.shields.io/pypi/pyversions/migradiff)](https://pypi.org/project/migradiff/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+**The actively maintained fork of [djrobstep/migra](https://github.com/djrobstep/migra).**
+
+migra compares two PostgreSQL database schemas and generates the SQL
+migration script needed to transform one into the other. Drop it into
+your CI pipeline and stop writing `ALTER TABLE` by hand.
+
+---
+
+## Why This Fork
+
+The original `migra` was officially deprecated in 2024. This fork picks
+up where it left off — fixing known issues, adding Python 3.12+ support,
+and extending coverage for advanced PostgreSQL features.
+
+If you were using `djrobstep/migra`, this is your drop-in continuation.
+Nothing has changed about how the tool works. We're just keeping the
+lights on and making it better.
+
+---
+
+## Quickstart
+
+### Install
+
+```bash
+pip install migradiff
+```
+
+Requires Python 3.10+ and a running PostgreSQL instance (12+).
+
+To install from source:
+
+```bash
+git clone https://github.com/migradiff/migra
+cd migra
+pip install -e .
+```
+
+> **Note:** PyPI package coming with v1.1.0.
+
+### Basic Usage
+
+Point migra at two database connections and it outputs the DDL needed
+to migrate from one to the other:
+
+```bash
+migra \
+  postgresql://user:pass@localhost/db_production \
+  postgresql://user:pass@localhost/db_branch \
+  --unsafe
+```
+
+Output is plain SQL — pipe it, review it, apply it:
+
+```bash
+migra postgres://db_a postgres://db_b > migration.sql
+psql postgres://db_production < migration.sql
+```
+
+### Schema Dumps (No Live Connection Required)
+
+If you can't or don't want to point migra at a live database, use
+`pg_dump -s` to generate a schema dump and diff that instead:
+
+```bash
+pg_dump -s postgres://db_production > schema_a.sql
+pg_dump -s postgres://db_branch     > schema_b.sql
+migra --from-file schema_a.sql schema_b.sql
+```
+
+This is the recommended approach for CI pipelines and security-conscious
+environments — no production credentials required.
+
+### Scoped to a Schema
+
+```bash
+# Single schema
+migra --schema myschema postgres://db_a postgres://db_b
+
+# Multiple schemas (comma-separated)
+migra --schema public,reporting postgres://db_a postgres://db_b
+```
+
+### JSON Output
+
+For programmatic consumption or CI pipelines:
+
+```bash
+migra --output json postgres://db_a postgres://db_b
+```
+
+Output includes per-statement risk classification (`safe`, `warning`,
+`destructive`) and a summary with overall risk level.
+
+---
+
+## Development Setup
+
+The test suite requires a running PostgreSQL instance. The easiest
+way to get one is via Docker Compose:
+
+```bash
+docker compose up -d
+```
+
+This starts a Postgres 16 container on localhost:5432 with trust
+authentication. No password required.
+
+To stop it:
+
+```bash
+docker compose down
+```
+
+Data persists between restarts via the `migradiff-pgdata` volume.
+To reset completely:
+
+```bash
+docker compose down -v
+```
+
+---
+
+## Docker
+
+No Python environment? Use the official image:
+
+```bash
+docker run --rm ghcr.io/migradiff/migra \
+  postgres://db_a postgres://db_b
+```
+
+---
+
+## GitHub Actions
+
+Add schema diffing to your pull request workflow:
+
+```yaml
+- uses: migradiff/migra@v1
+  with:
+    base_url: ${{ secrets.DB_PRODUCTION_URL }}
+    head_url: ${{ secrets.DB_BRANCH_URL }}
+```
+
+Fail the build automatically if destructive operations are detected:
+
+```yaml
+- uses: migradiff/migra@v1
+  with:
+    base_url: ${{ secrets.DB_PRODUCTION_URL }}
+    head_url: ${{ secrets.DB_BRANCH_URL }}
+    fail_on_destructive: "true"
+```
+
+Use schema dump files instead of live connections:
+
+```yaml
+- uses: migradiff/migra@v1
+  with:
+    base_file: schema_production.sql
+    head_file: schema_branch.sql
+```
+
+See [docs/action-usage.md](docs/action-usage.md) for full configuration options.
+
+---
+
+## Pre-commit Hook
+
+```yaml
+# .pre-commit-config.yaml
+repos:
+  - repo: https://github.com/migradiff/migra
+    rev: v1.1.0
+    hooks:
+      - id: migra
+```
+
+See `pre-commit-config.example.yaml` in the repo root for full
+configuration options.
+
+---
+
+## What migra Understands
+
+- Tables, columns, constraints, indexes
+- Views and materialized views
+- Functions and stored procedures
+- Sequences
+- Enums, composite types, domains
+- Row-Level Security (RLS) policies
+- Foreign data wrappers
+- Column-level privileges
+- Partitioned tables
+
+---
+
+## Improvements Over Upstream
+
+| Area | Upstream (deprecated) | This Fork |
+|---|---|---|
+| Python 3.12+ | Deprecation warnings | Clean — no warnings |
+| RLS policies | Partial, equality bug | Full CREATE/DROP, partition support |
+| Error messages | Cryptic on unsupported types | Actionable with object name and issue link |
+| --schema flag | Edge cases in multi-schema DBs | Comma-separated, cross-schema dependencies resolved |
+| pg_dump input | Not supported | First-class `--from-file` mode |
+| JSON output | Not supported | `--output json` with risk classification |
+| Docker image | None | `ghcr.io/migradiff/migra` |
+| GitHub Action | None | `migradiff/migra-action` |
+| Pre-commit hook | None | `.pre-commit-hooks.yaml` |
+| Dev environment | Manual Docker commands | `docker compose up -d` |
+
+See [CHANGELOG.md](CHANGELOG.md) for the full fix history.
+
+---
+
+## Known Limitations
+
+migra generates the SQL diff — it does not apply it. Review every
+generated script before running against production. Destructive
+operations (`DROP TABLE`, `DROP COLUMN`) are flagged in JSON output
+mode but not blocked in plain SQL mode.
+
+migra requires a live PostgreSQL connection to introspect schemas,
+or schema dump files via `--from-file`. It does not parse raw DDL text.
+
+---
+
+## Contributing
+
+Bug reports and PRs are welcome. If you're fixing something that was
+reported upstream in `djrobstep/migra`, reference that issue number
+in your PR — it helps us track what the community most needs fixed.
+
+```bash
+git clone https://github.com/migradiff/migra
+cd migra
+docker compose up -d
+pip install -e ".[dev]"
+pytest
+```
+
+---
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+---
+
+## Acknowledgements
+
+This project is a fork of [djrobstep/migra](https://github.com/djrobstep/migra),
+created and originally maintained by Robert Lechte. The core diffing
+engine is his work. We are grateful for it.
+

migradiff-1.1.0/README.md

@@ -0,0 +1,262 @@
+# migra — PostgreSQL Schema Diff Tool
+
+[![PyPI version](https://img.shields.io/pypi/v/migradiff)](https://pypi.org/project/migradiff/)
+[![Python versions](https://img.shields.io/pypi/pyversions/migradiff)](https://pypi.org/project/migradiff/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+**The actively maintained fork of [djrobstep/migra](https://github.com/djrobstep/migra).**
+
+migra compares two PostgreSQL database schemas and generates the SQL
+migration script needed to transform one into the other. Drop it into
+your CI pipeline and stop writing `ALTER TABLE` by hand.
+
+---
+
+## Why This Fork
+
+The original `migra` was officially deprecated in 2024. This fork picks
+up where it left off — fixing known issues, adding Python 3.12+ support,
+and extending coverage for advanced PostgreSQL features.
+
+If you were using `djrobstep/migra`, this is your drop-in continuation.
+Nothing has changed about how the tool works. We're just keeping the
+lights on and making it better.
+
+---
+
+## Quickstart
+
+### Install
+
+```bash
+pip install migradiff
+```
+
+Requires Python 3.10+ and a running PostgreSQL instance (12+).
+
+To install from source:
+
+```bash
+git clone https://github.com/migradiff/migra
+cd migra
+pip install -e .
+```
+
+> **Note:** PyPI package coming with v1.1.0.
+
+### Basic Usage
+
+Point migra at two database connections and it outputs the DDL needed
+to migrate from one to the other:
+
+```bash
+migra \
+  postgresql://user:pass@localhost/db_production \
+  postgresql://user:pass@localhost/db_branch \
+  --unsafe
+```
+
+Output is plain SQL — pipe it, review it, apply it:
+
+```bash
+migra postgres://db_a postgres://db_b > migration.sql
+psql postgres://db_production < migration.sql
+```
+
+### Schema Dumps (No Live Connection Required)
+
+If you can't or don't want to point migra at a live database, use
+`pg_dump -s` to generate a schema dump and diff that instead:
+
+```bash
+pg_dump -s postgres://db_production > schema_a.sql
+pg_dump -s postgres://db_branch     > schema_b.sql
+migra --from-file schema_a.sql schema_b.sql
+```
+
+This is the recommended approach for CI pipelines and security-conscious
+environments — no production credentials required.
+
+### Scoped to a Schema
+
+```bash
+# Single schema
+migra --schema myschema postgres://db_a postgres://db_b
+
+# Multiple schemas (comma-separated)
+migra --schema public,reporting postgres://db_a postgres://db_b
+```
+
+### JSON Output
+
+For programmatic consumption or CI pipelines:
+
+```bash
+migra --output json postgres://db_a postgres://db_b
+```
+
+Output includes per-statement risk classification (`safe`, `warning`,
+`destructive`) and a summary with overall risk level.
+
+---
+
+## Development Setup
+
+The test suite requires a running PostgreSQL instance. The easiest
+way to get one is via Docker Compose:
+
+```bash
+docker compose up -d
+```
+
+This starts a Postgres 16 container on localhost:5432 with trust
+authentication. No password required.
+
+To stop it:
+
+```bash
+docker compose down
+```
+
+Data persists between restarts via the `migradiff-pgdata` volume.
+To reset completely:
+
+```bash
+docker compose down -v
+```
+
+---
+
+## Docker
+
+No Python environment? Use the official image:
+
+```bash
+docker run --rm ghcr.io/migradiff/migra \
+  postgres://db_a postgres://db_b
+```
+
+---
+
+## GitHub Actions
+
+Add schema diffing to your pull request workflow:
+
+```yaml
+- uses: migradiff/migra@v1
+  with:
+    base_url: ${{ secrets.DB_PRODUCTION_URL }}
+    head_url: ${{ secrets.DB_BRANCH_URL }}
+```
+
+Fail the build automatically if destructive operations are detected:
+
+```yaml
+- uses: migradiff/migra@v1
+  with:
+    base_url: ${{ secrets.DB_PRODUCTION_URL }}
+    head_url: ${{ secrets.DB_BRANCH_URL }}
+    fail_on_destructive: "true"
+```
+
+Use schema dump files instead of live connections:
+
+```yaml
+- uses: migradiff/migra@v1
+  with:
+    base_file: schema_production.sql
+    head_file: schema_branch.sql
+```
+
+See [docs/action-usage.md](docs/action-usage.md) for full configuration options.
+
+---
+
+## Pre-commit Hook
+
+```yaml
+# .pre-commit-config.yaml
+repos:
+  - repo: https://github.com/migradiff/migra
+    rev: v1.1.0
+    hooks:
+      - id: migra
+```
+
+See `pre-commit-config.example.yaml` in the repo root for full
+configuration options.
+
+---
+
+## What migra Understands
+
+- Tables, columns, constraints, indexes
+- Views and materialized views
+- Functions and stored procedures
+- Sequences
+- Enums, composite types, domains
+- Row-Level Security (RLS) policies
+- Foreign data wrappers
+- Column-level privileges
+- Partitioned tables
+
+---
+
+## Improvements Over Upstream
+
+| Area | Upstream (deprecated) | This Fork |
+|---|---|---|
+| Python 3.12+ | Deprecation warnings | Clean — no warnings |
+| RLS policies | Partial, equality bug | Full CREATE/DROP, partition support |
+| Error messages | Cryptic on unsupported types | Actionable with object name and issue link |
+| --schema flag | Edge cases in multi-schema DBs | Comma-separated, cross-schema dependencies resolved |
+| pg_dump input | Not supported | First-class `--from-file` mode |
+| JSON output | Not supported | `--output json` with risk classification |
+| Docker image | None | `ghcr.io/migradiff/migra` |
+| GitHub Action | None | `migradiff/migra-action` |
+| Pre-commit hook | None | `.pre-commit-hooks.yaml` |
+| Dev environment | Manual Docker commands | `docker compose up -d` |
+
+See [CHANGELOG.md](CHANGELOG.md) for the full fix history.
+
+---
+
+## Known Limitations
+
+migra generates the SQL diff — it does not apply it. Review every
+generated script before running against production. Destructive
+operations (`DROP TABLE`, `DROP COLUMN`) are flagged in JSON output
+mode but not blocked in plain SQL mode.
+
+migra requires a live PostgreSQL connection to introspect schemas,
+or schema dump files via `--from-file`. It does not parse raw DDL text.
+
+---
+
+## Contributing
+
+Bug reports and PRs are welcome. If you're fixing something that was
+reported upstream in `djrobstep/migra`, reference that issue number
+in your PR — it helps us track what the community most needs fixed.
+
+```bash
+git clone https://github.com/migradiff/migra
+cd migra
+docker compose up -d
+pip install -e ".[dev]"
+pytest
+```
+
+---
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+---
+
+## Acknowledgements
+
+This project is a fork of [djrobstep/migra](https://github.com/djrobstep/migra),
+created and originally maintained by Robert Lechte. The core diffing
+engine is his work. We are grateful for it.

migradiff-1.1.0/migra/__init__.py

@@ -0,0 +1,16 @@
+from __future__ import unicode_literals
+
+__version__ = "1.1.0"
+
+from .changes import Changes
+from .command import do_command
+from .migra import Migration
+from .statements import Statements, UnsafeMigrationException
+
+__all__ = [
+    "Migration",
+    "Changes",
+    "Statements",
+    "UnsafeMigrationException",
+    "do_command",
+]