{"id":22403,"library":"sqlalchemy-migrate","title":"sqlalchemy-migrate","description":"Database schema migration tool for SQLAlchemy. Current version 0.13.0. Release cadence: sporadic, last release 2020.","status":"maintenance","version":"0.13.0","language":"python","source_language":"en","source_url":"https://github.com/openstack/sqlalchemy-migrate","tags":["migration","sqlalchemy","database","schema"],"install":[{"cmd":"pip install sqlalchemy-migrate","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core dependency","package":"sqlalchemy","optional":false},{"reason":"Required for ORM support","package":"sqlalchemy-declarative","optional":true}],"imports":[{"note":"Package is installed as 'migrate', not 'sqlalchemy_migrate'.","wrong":"import sqlalchemy_migrate","symbol":"migrate","correct":"from migrate import versioning"},{"note":"","wrong":"","symbol":"VersioningApi","correct":"from migrate.versioning.api import db_version, upgrade"}],"quickstart":{"code":"from migrate.versioning import api\nfrom migrate.versioning.repository import Repository\nimport os\n\ndb_url = os.environ.get('DATABASE_URL', 'sqlite:///test.db')\nrepo_path = '/path/to/migrations'\n# Create repository: api.create(repo_path, 'myapp')\n# Upgrade: api.upgrade(db_url, repo_path, version=None)\nprint('Migration setup ready.')","lang":"python","description":"Basic usage: create a repository and run migrations."},"warnings":[{"fix":"Use Alembic (pip install alembic) as it is actively maintained and more flexible.","message":"sqlalchemy-migrate is in maintenance mode. Consider using Alembic for new projects.","severity":"deprecated","affected_versions":"all"},{"fix":"Use 'from migrate import versioning.api' and ensure the package is installed correctly.","message":"The package is installed as 'migrate', but the import is 'from migrate import ...'. Users often try 'import sqlalchemy_migrate' which fails.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'pip install sqlalchemy-migrate' and use 'from migrate import ...'.","cause":"Incorrect import path. The package name on PyPI is 'sqlalchemy-migrate', but the module is 'migrate'.","error":"ModuleNotFoundError: No module named 'sqlalchemy_migrate'"},{"fix":"Reinstall with 'pip install --upgrade sqlalchemy-migrate' or check that the package is not partially installed.","cause":"The 'migrate' package is installed but missing 'versioning' submodule, possibly due to an outdated version or broken installation.","error":"ImportError: No module named migrate.versioning"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}