great-scott 0.1.5

Automatically reverses Django migrations when changing git branches

great-scott

great-scott automatically reverses migrations in a Django project when switching between Git branches.

Installation • Usage • Removing Git hooks

Installation

1. Install the tool

   Via uv (recommended):

   uv tool install great-scott
   

   Via pipx:

   pipx install great-scott
   

   Or directly into the project's virtual environment:

   python -m pip install great-scott
   

2. Set up Git hooks

   From the project directory, run:

   great-scott install
   

Usage

Migrations are reversed automatically when switching branches:

$ git checkout main
Switched to branch 'main'
👀 Looking for migrations to reverse on mig-test...
⚠️ reversing migrations for importer (up to 0015)
⚠️ reversing migrations for permissions (up to 0018)
⚠️ reversing migrations for subscriptions (up to 0044)
I have reversed migrations for 3 apps!

IDE users: If you switch branches via PyCharm, VSCode, or another IDE's Git integration, make sure the IDE is configured to use the correct Python environment - otherwise automatic migration reversal may not trigger.

Removing Git hooks

From the project directory, run:

great-scott uninstall