[bumpversion]
-current_version = 62.3.1
+current_version = 62.3.2
commit = True
tag = True
+v62.3.2
+-------
+
+
+Misc
+^^^^
+* #3328: Include a first line summary to some of the existing multi-line warnings.
+
+
v62.3.1
-------
[metadata]
name = setuptools
-version = 62.3.1
+version = 62.3.2
author = Python Packaging Authority
author_email = distutils-sig@python.org
description = Easily download, build, install, upgrade, and uninstall Python packages
"""Inform users that package or module is included as 'data file'"""
MESSAGE = """\
+ Installing {importable!r} as data is deprecated, please list it in `packages`.
!!\n\n
############################
# Package would be ignored #
therefore is considered deprecated).
Please make sure that {importable!r} is included as a package by using
- setuptools' `packages` configuration field or the proper discovery methods.
+ setuptools' `packages` configuration field or the proper discovery methods
+ (for example by using `find_namespace_packages(...)`/`find_namespace:`
+ instead of `find_packages(...)`/`find:`).
You can read more about "package discovery" and "data files" on setuptools
documentation page.
try:
return str(packaging.version.Version(v)).replace("-", "_")
except packaging.version.InvalidVersion:
- msg = f"""!!\n\n
+ msg = f"""Invalid version: {version!r}.
+ !!\n\n
###################
# Invalid version #
###################
class _WouldIgnoreField(UserWarning):
- """Inform users that ``pyproject.toml`` would overwrite previously defined metadata:
+ """Inform users that ``pyproject.toml`` would overwrite previous metadata."""
+
+ MESSAGE = """\
+ {field!r} defined outside of `pyproject.toml` would be ignored.
!!\n\n
##########################################################################
# configuration would be ignored/result in error due to `pyproject.toml` #
@classmethod
def message(cls, field, value):
from inspect import cleandoc
- msg = "\n".join(cls.__doc__.splitlines()[1:])
- return cleandoc(msg.format(field=field, value=value))
+ return cleandoc(cls.MESSAGE.format(field=field, value=value))
class _InvalidFile(UserWarning):
- """Inform users that the given `pyproject.toml` is experimental:
+ """The given `pyproject.toml` file is invalid and would be ignored.
!!\n\n
############################
# Invalid `pyproject.toml` #
@classmethod
def message(cls):
from inspect import cleandoc
- msg = "\n".join(cls.__doc__.splitlines()[1:])
- return cleandoc(msg)
+ return cleandoc(cls.__doc__)