Skip to content
This repository was archived by the owner on Feb 23, 2026. It is now read-only.

Commit 691981e

Browse files
committed
refactor s/next_supported_version/minimum_fully_supported_version/
1 parent f23c41b commit 691981e

1 file changed

Lines changed: 11 additions & 11 deletions

File tree

google/api_core/_python_package_support.py

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -74,28 +74,28 @@ def get_dependency_version(
7474
def warn_deprecation_for_versions_less_than(
7575
dependent_import_package: str,
7676
dependency_import_package: str,
77-
next_supported_version: str,
77+
minimum_fully_supported_version: str,
7878
recommended_version: Optional[str] = None,
7979
message_template: Optional[str] = None,
8080
):
8181
"""Issue any needed deprecation warnings for `dependency_import_package`.
8282
8383
If `dependency_import_package` is installed at a version less than
84-
`next_supported_version`, this issues a warning using either a
84+
`minimum_fully_supported_version`, this issues a warning using either a
8585
default `message_template` or one provided by the user. The
8686
default `message_template` informs the user that they will not receive
8787
future updates for `dependent_import_package` if
8888
`dependency_import_package` is somehow pinned to a version lower
89-
than `next_supported_version`.
89+
than `minimum_fully_supported_version`.
9090
9191
Args:
9292
dependent_import_package: The import name of the package that
9393
needs `dependency_import_package`.
9494
dependency_import_package: The import name of the dependency to check.
95-
next_supported_version: The dependency_import_package version number
95+
minimum_fully_supported_version: The dependency_import_package version number
9696
below which a deprecation warning will be logged.
9797
recommended_version: If provided, the recommended next version, which
98-
could be higher than `next_supported_version`.
98+
could be higher than `minimum_fully_supported_version`.
9999
message_template: A custom default message template to replace
100100
the default. This `message_template` is treated as an
101101
f-string, where the following variables are defined:
@@ -105,21 +105,21 @@ def warn_deprecation_for_versions_less_than(
105105
`dependent_package` , which contain the import packages, the
106106
distribution packages, and pretty string with both the
107107
distribution and import packages for the dependency and the
108-
dependent, respectively; and `next_supported_version`,
108+
dependent, respectively; and `minimum_fully_supported_version`,
109109
`version_used`, and `version_used_string`, which refer to supported
110110
and currently-used versions of the dependency.
111111
112112
"""
113113
if (
114114
not dependent_import_package
115115
or not dependency_import_package
116-
or not next_supported_version
116+
or not minimum_fully_supported_version
117117
): # pragma: NO COVER
118118
return
119119
dependency_version = get_dependency_version(dependency_import_package)
120120
if not dependency_version.version:
121121
return
122-
if dependency_version.version < parse_version(next_supported_version):
122+
if dependency_version.version < parse_version(minimum_fully_supported_version):
123123
(
124124
dependency_package,
125125
dependency_distribution_package,
@@ -138,13 +138,13 @@ def warn_deprecation_for_versions_less_than(
138138
{dependency_package}, currently installed at version
139139
{version_used_string}. Future updates to
140140
{dependent_package} will require {dependency_package} at
141-
version {next_supported_version} or
141+
version {minimum_fully_supported_version} or
142142
higher{recommendation}. Please ensure that either (a) your
143143
Python environment doesn't pin the version of
144144
{dependency_package}, so that updates to
145145
{dependent_package} can require the higher version, or (b)
146146
you manually update your Python environment to use at
147-
least version {next_supported_version} of
147+
least version {minimum_fully_supported_version} of
148148
{dependency_package}.
149149
"""
150150
)
@@ -156,7 +156,7 @@ def warn_deprecation_for_versions_less_than(
156156
dependency_distribution_package=dependency_distribution_package,
157157
dependency_package=dependency_package,
158158
dependent_package=dependent_package,
159-
next_supported_version=next_supported_version,
159+
minimum_fully_supported_version=minimum_fully_supported_version,
160160
recommendation=recommendation,
161161
version_used=dependency_version.version,
162162
version_used_string=dependency_version.version_string,

0 commit comments

Comments
 (0)