Low commit activity in last 3 years
git merge driver for db/structure.sql in a Rails project. Originally forked from git-merge-structure-sql
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.2
~> 13.0
~> 3.0
 Project Readme

git-driver-merge-structure-sql

This is a fork from the original unmaintained version to support the newer reversed order version markers in structure.sql

This is a merge driver for Git that resolves typical merge conflicts in a db/structure.sql file of Rails.

When your project is configured with config.active_record.schema_format = :sql, the database schema is kept in db/structure.sql instead of db/schema.rb in the native dump format of the underlying database engine, which is not suitable for the default merge driver of Git to deal with. As a result, when you try to merge two branches you always have to resolve trivial conflicts manually if new schema migrations take place in both branches. This custom driver takes away such a pain.

Currently only PostgreSQL, MySQL and SQLite3 dump formats are supported.

Installation

Run this:

$ gem install git-driver-merge-structure-sql

And enable it yourself in your Git configuration, or let it do that for you by this command:

$ git-driver-merge-structure-sql --install

This adds necessary settings to your ~/.gitconfig or $XDG_CONFIG_HOME/git/config and the default gitattributes(5) file to enable the merge driver for structure.sql files.

If you want to enable this driver only in the current git directory, run this:

$ git-driver-merge-structure-sql --install=local

Usage

Once enabled, Git should call this driver as necessary when it needs to merge changes made in structure.sql.

History

See CHANGELOG.md for the version history.

Author

Copyright (c) 2018-2021 Akinori MUSHA.

Licensed under the 2-clause BSD license. See LICENSE.txt for details.

Visit the GitHub Repository for the latest information.