updates

Backend/venv/lib/python3.12/site-packages/pydantic/version.py

@@ -1,10 +1,25 @@
 """The `version` module holds the version information for Pydantic."""
+
 from __future__ import annotations as _annotations
 
+import sys
+
+from pydantic_core import __version__ as __pydantic_core_version__
+
 __all__ = 'VERSION', 'version_info'
 
-VERSION = '2.5.0'
-"""The version of Pydantic."""
+VERSION = '2.12.5'
+"""The version of Pydantic.
+
+This version specifier is guaranteed to be compliant with the [specification],
+introduced by [PEP 440].
+
+[specification]: https://packaging.python.org/en/latest/specifications/version-specifiers/
+[PEP 440]: https://peps.python.org/pep-0440/
+"""
+
+# Keep this in sync with the version constraint in the `pyproject.toml` dependencies:
+_COMPATIBLE_PYDANTIC_CORE_VERSION = '2.41.5'
 
 
 def version_short() -> str:
@@ -17,16 +32,13 @@ def version_short() -> str:
 
 def version_info() -> str:
     """Return complete version information for Pydantic and its dependencies."""
+    import importlib.metadata
     import platform
-    import sys
     from pathlib import Path
 
     import pydantic_core._pydantic_core as pdc
 
-    if sys.version_info >= (3, 8):
-        import importlib.metadata as importlib_metadata
-    else:
-        import importlib_metadata
+    from ._internal import _git as git
 
     # get data about packages that are closely related to pydantic, use pydantic or often conflict with pydantic
     package_names = {
@@ -40,36 +52,62 @@ def version_info() -> str:
     }
     related_packages = []
 
-    for dist in importlib_metadata.distributions():
+    for dist in importlib.metadata.distributions():
         name = dist.metadata['Name']
         if name in package_names:
             related_packages.append(f'{name}-{dist.version}')
 
+    pydantic_dir = Path(__file__).parents[1].resolve()
+    most_recent_commit = (
+        git.git_revision(pydantic_dir) if git.is_git_repo(pydantic_dir) and git.have_git() else 'unknown'
+    )
+
     info = {
         'pydantic version': VERSION,
-        'pydantic-core version': pdc.__version__,
-        'pydantic-core build': getattr(pdc, 'build_info', None) or pdc.build_profile,
-        'install path': Path(__file__).resolve().parent,
+        'pydantic-core version': __pydantic_core_version__,
+        'pydantic-core build': getattr(pdc, 'build_info', None) or pdc.build_profile,  # pyright: ignore[reportPrivateImportUsage]
         'python version': sys.version,
         'platform': platform.platform(),
         'related packages': ' '.join(related_packages),
+        'commit': most_recent_commit,
     }
     return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items())
 
 
-def parse_mypy_version(version: str) -> tuple[int, ...]:
-    """Parse mypy string version to tuple of ints.
+def check_pydantic_core_version() -> bool:
+    """Check that the installed `pydantic-core` dependency is compatible."""
+    return __pydantic_core_version__ == _COMPATIBLE_PYDANTIC_CORE_VERSION
 
-    This function is included here rather than the mypy plugin file because the mypy plugin file cannot be imported
-    outside a mypy run.
 
-    It parses normal version like `0.930` and dev version
-    like `0.940+dev.04cac4b5d911c4f9529e6ce86a27b44f28846f5d.dirty`.
+def _ensure_pydantic_core_version() -> None:  # pragma: no cover
+    if not check_pydantic_core_version():
+        raise_error = True
+        # Do not raise the error if pydantic is installed in editable mode (i.e. in development):
+        if sys.version_info >= (3, 13):  # origin property added in 3.13
+            from importlib.metadata import distribution
+
+            dist = distribution('pydantic')
+            if getattr(getattr(dist.origin, 'dir_info', None), 'editable', False):
+                raise_error = False
+
+        if raise_error:
+            raise SystemError(
+                f'The installed pydantic-core version ({__pydantic_core_version__}) is incompatible '
+                f'with the current pydantic version, which requires {_COMPATIBLE_PYDANTIC_CORE_VERSION}. '
+                "If you encounter this error, make sure that you haven't upgraded pydantic-core manually."
+            )
+
+
+def parse_mypy_version(version: str) -> tuple[int, int, int]:
+    """Parse `mypy` string version to a 3-tuple of ints.
+
+    It parses normal version like `1.11.0` and extra info followed by a `+` sign
+    like `1.11.0+dev.d6d9d8cd4f27c52edac1f537e236ec48a01e54cb.dirty`.
 
     Args:
         version: The mypy version string.
 
     Returns:
-        A tuple of ints. e.g. (0, 930).
+        A triple of ints, e.g. `(1, 11, 0)`.
     """
-    return tuple(map(int, version.partition('+')[0].split('.')))
+    return tuple(map(int, version.partition('+')[0].split('.')))  # pyright: ignore[reportReturnType]