Coverage for pydantic/plugin/_loader.py: 87.76%
33 statements
« prev ^ index » next coverage.py v7.8.0, created at 2025-05-02 08:21 +0000
« prev ^ index » next coverage.py v7.8.0, created at 2025-05-02 08:21 +0000
1from __future__ import annotations 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
3import importlib.metadata as importlib_metadata 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
4import os 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
5import warnings 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
6from collections.abc import Iterable 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
7from typing import TYPE_CHECKING, Final 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
9if TYPE_CHECKING: 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
10 from . import PydanticPluginProtocol
13PYDANTIC_ENTRY_POINT_GROUP: Final[str] = 'pydantic' 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
15# cache of plugins
16_plugins: dict[str, PydanticPluginProtocol] | None = None 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
17# return no plugins while loading plugins to avoid recursion and errors while import plugins
18# this means that if plugins use pydantic
19_loading_plugins: bool = False 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
22def get_plugins() -> Iterable[PydanticPluginProtocol]: 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
23 """Load plugins for Pydantic.
25 Inspired by: https://github.com/pytest-dev/pluggy/blob/1.3.0/src/pluggy/_manager.py#L376-L402
26 """
27 disabled_plugins = os.getenv('PYDANTIC_DISABLE_PLUGINS') 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
28 global _plugins, _loading_plugins
29 if _loading_plugins: 29 ↛ 31line 29 didn't jump to line 31 because the condition on line 29 was never true1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
30 # this happens when plugins themselves use pydantic, we return no plugins
31 return ()
32 elif disabled_plugins in ('__all__', '1', 'true'): 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
33 return () 1abcdefghijklmnopqrstuvwxyzABCDEFGHI
34 elif _plugins is None: 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
35 _plugins = {} 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
36 # set _loading_plugins so any plugins that use pydantic don't themselves use plugins
37 _loading_plugins = True 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
38 try: 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
39 for dist in importlib_metadata.distributions(): 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
40 for entry_point in dist.entry_points: 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
41 if entry_point.group != PYDANTIC_ENTRY_POINT_GROUP: 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
42 continue 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
43 if entry_point.value in _plugins: 43 ↛ 44line 43 didn't jump to line 44 because the condition on line 43 was never true1abcdefghijklmnopqrstuvwxyzABCDEFGHI
44 continue
45 if disabled_plugins is not None and entry_point.name in disabled_plugins.split(','): 1abcdefghijklmnopqrstuvwxyzABCDEFGHI
46 continue 1abcdefghijklmnopqrstuvwxyzABCDEFGHI
47 try: 1abcdefghijklmnopqrstuvwxyzABCDEFGHI
48 _plugins[entry_point.value] = entry_point.load() 1abcdefghijklmnopqrstuvwxyzABCDEFGHI
49 except (ImportError, AttributeError) as e:
50 warnings.warn(
51 f'{e.__class__.__name__} while loading the `{entry_point.name}` Pydantic plugin, '
52 f'this plugin will not be installed.\n\n{e!r}'
53 )
54 finally:
55 _loading_plugins = False 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI
57 return _plugins.values() 1abcdefghijklmnopqrstuvwxJKLMNOPyzABCDEFGHI