Skip to main content

A generic tool for migrate in python.

Project description

Build Status

Link Migration

A generic tool for schema and data migrations.

The primary inspirations for this library came from Alembic, Django, and Hibernate/Liquibase. The ultimate goal is to allow a lightweight migration framework to be deployed into any technology stack. Much of this currently relies on the user to implement, however with time more and more integrations will be added to the default set.




If you have pip available on your system, just type::

pip install link-migration

If you’ve already got an old version of link-migration, and want to upgrade, use:

pip install --upgrade link-migration

Usage Introduction

The first thing you’ll need to define is the file and to specify its location: link_migration -c "path_to_file/"

Below are the minimum requirements for definitions in The important step here is to specify where the migrations folder exists so they can be detected, and to specify where to store and fetch the versions for executed migrations.

import os
import requests
import json

ROOT_DIR = 'link_migration.example_migrations'
MIGRATIONS_ABS_PATH = os.path.abspath(os.path.join(os.path.dirname(__file__)))
MIGRATIONS_DIR = 'link_migration.example_migrations'

def get_current_version():
    path = "%s/current_version.txt" % MIGRATIONS_ABS_PATH
    with open(path, "r+") as f:
        content =
    return int(content)

def set_current_version(version):
    path = "%s/current_version.txt" % MIGRATIONS_ABS_PATH
    with open(path, "w") as f:
        content = f.write(f'{version}')
    return int(content)

Link Migration uses the version information to track the migrations schema and to decide the order of execution of the scripts. Link Migration will go through all .py files in your directory and execute all of them version order.

Migrating to a specific version

If you want, you can migrate your database schema to a specific version by informing the --to (or -t) parameter. The attribute version of the migration file will be used as unique identifier:

$ link-migration --to=57

If you don’t specify any version, using --up or --down, Link Migration will migrate the schema to the latest version available in the migrations directories specified in the config file.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

link_migration-0.0.21.tar.gz (11.5 kB view hashes)

Uploaded source

Built Distribution

link_migration-0.0.21-py3-none-any.whl (17.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page