|
"""For backward compatibility, expose main functions from |
|
``setuptools.config.setupcfg`` |
|
""" |
|
from functools import wraps |
|
from typing import Callable, TypeVar, cast |
|
|
|
from ..warnings import SetuptoolsDeprecationWarning |
|
from . import setupcfg |
|
|
|
Fn = TypeVar("Fn", bound=Callable) |
|
|
|
__all__ = ('parse_configuration', 'read_configuration') |
|
|
|
|
|
def _deprecation_notice(fn: Fn) -> Fn: |
|
@wraps(fn) |
|
def _wrapper(*args, **kwargs): |
|
SetuptoolsDeprecationWarning.emit( |
|
"Deprecated API usage.", |
|
f""" |
|
As setuptools moves its configuration towards `pyproject.toml`, |
|
`{__name__}.{fn.__name__}` became deprecated. |
|
|
|
For the time being, you can use the `{setupcfg.__name__}` module |
|
to access a backward compatible API, but this module is provisional |
|
and might be removed in the future. |
|
|
|
To read project metadata, consider using |
|
``build.util.project_wheel_metadata`` (https://pypi.org/project/build/). |
|
For simple scenarios, you can also try parsing the file directly |
|
with the help of ``configparser``. |
|
""", |
|
|
|
|
|
) |
|
return fn(*args, **kwargs) |
|
|
|
return cast(Fn, _wrapper) |
|
|
|
|
|
read_configuration = _deprecation_notice(setupcfg.read_configuration) |
|
parse_configuration = _deprecation_notice(setupcfg.parse_configuration) |
|
|
