Skip to main content

Fork of peewee-migrate with active support

Project description

Peewee Migrate 2 – A simple migration engine for Peewee

Build Status Coverals Version

Why Fork?

It’s a fork of original Thank klen for that!

But klen don’t support project for a long time.

To fix critical issues project was forked and development continued.

All previous compatibilities will be preserved.


  • python 2.7,3.5
  • peewee >= 3.3.1

Dependency Note

For Peewee<3.0 please use Peewee-Migrate==0.14.0.


To reduce code changes Python package name don’t changed. Only name on PyPI.

If you have installed previous version please remove it before using pip:

pip uninstall peewee_migrate

Peewee Migrate should be installed using pip:

pip install peewee_migrate2


Do you want Flask integration? Look at Flask-PW.

From shell

Getting help:

$ pw_migrate --help

Usage: pw_migrate [OPTIONS] COMMAND [ARGS]...

    --help  Show this message and exit.

    create   Create migration.
    migrate  Run migrations.
    rollback Rollback migration.

Create migration:

$ pw_migrate create --help

Usage: pw_migrate create [OPTIONS] NAME

    Create migration.

    --auto                  FLAG  Scan sources and create db migrations automatically. Supports autodiscovery.
    --auto-source           TEXT  Set to python module path for changes autoscan (e.g. 'package.models'). Current directory will be recursively scanned by default.
    --database              TEXT  Database connection
    --directory             TEXT  Directory where migrations are stored
    -v, --verbose
    --help                        Show this message and exit.

Run migrations:

$ pw_migrate migrate --help

Usage: pw_migrate migrate [OPTIONS]

    Run migrations.

    --name TEXT       Select migration
    --database TEXT   Database connection
    --directory TEXT  Directory where migrations are stored
    -v, --verbose
    --help            Show this message and exit.

From python

from peewee_migrate import Router
from peewee import SqliteDatabase

router = Router(SqliteDatabase('test.db'))

# Create migration

# Run migration/migrations'migration_name')

# Run all unapplied migrations

Migration files

By default, migration files are looked up in os.getcwd()/migrations directory, but custom directory can be given.

Migration files are sorted and applied in ascending order per their filename.

Each migration file must specify migrate() function and may specify rollback() function:

def migrate(migrator, database, fake=False, **kwargs):

def rollback(migrator, database, fake=False, **kwargs):

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to the issue tracker at


Development of starter happens at github:




Licensed under a BSD license.

Project details

Download files

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

Files for peewee-migrate2, version 1.2.2
Filename, size File type Python version Upload date Hashes
Filename, size peewee_migrate2-1.2.2-py2.py3-none-any.whl (18.0 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size peewee_migrate2-1.2.2.tar.gz (17.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page