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 https://github.com/klen/peewee_migrate. Thank klen for that!

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

To fix critical issues project was forked and development continued.

Requirements

  • python >= 3.6

  • peewee >= 3.3.1

Dependency Note

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

Installation

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

Usage

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

From shell

Getting help:

$ pw_migrate --help

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

Options:
    --help  Show this message and exit.

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

Create migration:

$ pw_migrate create --help

Usage: pw_migrate create [OPTIONS] NAME

    Create migration.

Options:
    --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
    --schema                TEXT  Database schema
    -v, --verbose
    --help                        Show this message and exit.

Run migrations:

$ pw_migrate migrate --help

Usage: pw_migrate migrate [OPTIONS]

    Run migrations.

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

Auto create migration:

$ pw_migrate makemigrations --help

Usage: pw_migrate makemigrations [OPTIONS]

  Create a migration automatically

  Similar to `create` command, but `auto` is True by default, and `name` not
  required

Options:
    --name TEXT         Migration file name. By default will be
                      'auto_YYYYmmdd_HHMM'
    --auto              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
    --schema                TEXT  Database schema
    -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
router.create('migration_name')

# Run migration/migrations
router.run('migration_name')

# Run all unapplied migrations
router.run()

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):
    pass

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

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/spumer/peewee_migrate2/issues

Contributing

Development of starter happens at github: https://github.com/spumer/peewee_migrate2

Contributors

See AUTHORS.rst

License

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.

Source Distribution

peewee_migrate2-1.6.4.tar.gz (18.2 kB view details)

Uploaded Source

Built Distribution

peewee_migrate2-1.6.4-py2.py3-none-any.whl (18.9 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file peewee_migrate2-1.6.4.tar.gz.

File metadata

  • Download URL: peewee_migrate2-1.6.4.tar.gz
  • Upload date:
  • Size: 18.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.0 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.7.8

File hashes

Hashes for peewee_migrate2-1.6.4.tar.gz
Algorithm Hash digest
SHA256 648359686bbee0e3a5cfa9d79047b978830506540b7ef5519df31f2ffb651257
MD5 02587efcc176a5e9438dc953508f9d26
BLAKE2b-256 d8f2fb24bcca2148a0f5d1f1c9e61395d1674d503fcb1689007b183528c5ba5d

See more details on using hashes here.

File details

Details for the file peewee_migrate2-1.6.4-py2.py3-none-any.whl.

File metadata

  • Download URL: peewee_migrate2-1.6.4-py2.py3-none-any.whl
  • Upload date:
  • Size: 18.9 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.0 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.7.8

File hashes

Hashes for peewee_migrate2-1.6.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 fa23ea46b04115ccc278afc5ca6199693821692a9f564c4e2a76845280579831
MD5 e4c0d1802bee46ab3e3200854b029b03
BLAKE2b-256 f58fb3da21babc66331c8cfce1b93d144954686a0195d095ef30c5104c993e10

See more details on using hashes here.

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