79 lines
2.4 KiB
Python
79 lines
2.4 KiB
Python
"""The `version` module holds the version information for Pydantic."""
|
|
|
|
from __future__ import annotations as _annotations
|
|
|
|
__all__ = 'VERSION', 'version_info'
|
|
|
|
VERSION = '2.8.2'
|
|
"""The version of Pydantic."""
|
|
|
|
|
|
def version_short() -> str:
|
|
"""Return the `major.minor` part of Pydantic version.
|
|
|
|
It returns '2.1' if Pydantic version is '2.1.1'.
|
|
"""
|
|
return '.'.join(VERSION.split('.')[:2])
|
|
|
|
|
|
def version_info() -> str:
|
|
"""Return complete version information for Pydantic and its dependencies."""
|
|
import importlib.metadata as importlib_metadata
|
|
import os
|
|
import platform
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
import pydantic_core._pydantic_core as pdc
|
|
|
|
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 = {
|
|
'email-validator',
|
|
'fastapi',
|
|
'mypy',
|
|
'pydantic-extra-types',
|
|
'pydantic-settings',
|
|
'pyright',
|
|
'typing_extensions',
|
|
}
|
|
related_packages = []
|
|
|
|
for dist in importlib_metadata.distributions():
|
|
name = dist.metadata['Name']
|
|
if name in package_names:
|
|
related_packages.append(f'{name}-{dist.version}')
|
|
|
|
pydantic_dir = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
|
|
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,
|
|
'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.
|
|
|
|
It parses normal version like `0.930` and extra info followed by a `+` sign
|
|
like `0.940+dev.04cac4b5d911c4f9529e6ce86a27b44f28846f5d.dirty`.
|
|
|
|
Args:
|
|
version: The mypy version string.
|
|
|
|
Returns:
|
|
A tuple of ints. e.g. (0, 930).
|
|
"""
|
|
return tuple(map(int, version.partition('+')[0].split('.')))
|