Skip to content

deprecate: Add deprecation warning to migrate module #1373

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dimitri-yatsenko merged 4 commits into from
Feb 3, 2026
Merged

deprecate: Add deprecation warning to migrate module #1373

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
24c329c
deprecate: Add deprecation warning to migrate module
dimitri-yatsenko Feb 3, 2026
1ceabd5
deprecate: Show warning only in 2.1+, update messaging
dimitri-yatsenko Feb 3, 2026
4c1be52
fix: Use packaging.version for proper version comparison
dimitri-yatsenko Feb 3, 2026
0ebce4c
fix: Import __version__ from .version to avoid circular import
dimitri-yatsenko Feb 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions src/datajoint/migrate.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,11 @@
Codec system, particularly for upgrading blob columns to use
explicit `<blob>` type declarations.

.. note::
This module is provided temporarily to assist with migration from pre-2.0.
It will be deprecated in DataJoint 2.1 and removed in 2.2.
Complete your migrations while on DataJoint 2.0.

Note on Terminology
-------------------
This module uses "external storage" because that was the term in DataJoint 0.14.6.
Expand All @@ -16,9 +21,22 @@

import logging
import re
import warnings
from typing import TYPE_CHECKING

from packaging.version import Version

from .errors import DataJointError
from .version import __version__

# Show deprecation warning starting in 2.1
if Version(__version__) >= Version("2.1"):
warnings.warn(
"datajoint.migrate is deprecated and will be removed in DataJoint 2.2. "
"Complete your schema migrations before upgrading.",
DeprecationWarning,
stacklevel=2,
)

if TYPE_CHECKING:
from .schemas import Schema
Expand Down
Loading