Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
58 commits
Select commit Hold shift + click to select a range
6316d70
feat: provide Python run-time version support
vchudnov-g Jul 29, 2025
a136ad7
feat: apply Python version suport warnings to api_core
vchudnov-g Jul 29, 2025
45cd647
feat: add deprecation check for the protobuf package
vchudnov-g Jul 30, 2025
25225fa
format files
vchudnov-g Jul 30, 2025
1d567c0
fix lint warning
vchudnov-g Jul 30, 2025
f1dbbb4
add docstring to `warn_deprecation_for_versions_less_than`
vchudnov-g Jul 30, 2025
e3fd56f
Add/fix docstrings
vchudnov-g Jul 30, 2025
8b1dfb1
fix typo
vchudnov-g Jul 31, 2025
4b9208e
add test for _python_package_support.py
vchudnov-g Jul 31, 2025
5cf8652
add constants for various buffer periods
vchudnov-g Jul 31, 2025
7d8b1c7
Update warning code to only require import package names
vchudnov-g Jul 31, 2025
cda8e27
Fix messaegs and test
vchudnov-g Jul 31, 2025
db92fac
Add TODO: provide the functionality in previous versions of api_core
vchudnov-g Jul 31, 2025
118a7c8
Fix mypy failures
vchudnov-g Aug 12, 2025
f1c46aa
Try to remove a round-off error causing a test mock failure
vchudnov-g Aug 12, 2025
474ec0d
Remove more potential test failures/warnings
vchudnov-g Aug 12, 2025
2083b49
Format
vchudnov-g Aug 12, 2025
4ea124e
Try making the specified_timeout a float
vchudnov-g Aug 12, 2025
c5949c4
fix: tweak message parameter names
vchudnov-g Sep 3, 2025
6fc1473
fix: add PYTHON_VERSION_STATUS_UNSPECIFIED enum value
vchudnov-g Sep 3, 2025
8829e20
docs: tweak TODOs
vchudnov-g Sep 3, 2025
bdb6260
fix test to match code changes
vchudnov-g Sep 3, 2025
7896664
fix: restore asyncio designator for async tests
vchudnov-g Sep 4, 2025
54a5611
Remove some workarounds trying to fix presubmit errors (since fixed)
vchudnov-g Sep 5, 2025
2e2990b
Additional test tweaks to prevent non-significant failures
vchudnov-g Sep 5, 2025
35a2074
chore: fix test that was waiting before initiating operation
vchudnov-g Sep 5, 2025
cd64832
fix: skip coverage checks for code specific to Pyton 3.7
vchudnov-g Sep 5, 2025
e36414a
chore: try to address coverage failures
vchudnov-g Sep 8, 2025
b6245ca
chore: try to address more coverage failures
vchudnov-g Sep 8, 2025
3a897ba
chore: fix comments and exported function
vchudnov-g Sep 9, 2025
814ea63
fix lint
vchudnov-g Sep 9, 2025
8dee04b
chore: fix unit test
vchudnov-g Sep 9, 2025
95f4777
chore: lint
vchudnov-g Sep 9, 2025
a34ec15
Use warnings module instead of logging module
vchudnov-g Sep 10, 2025
a04e2e6
fix: print the current package versions correctly
vchudnov-g Sep 15, 2025
8b3f337
wip: before gemini doc fixes
vchudnov-g Sep 15, 2025
29896cf
fix: return tuple of version tuple and version string, fix tests
vchudnov-g Sep 16, 2025
d421f98
lint
vchudnov-g Sep 22, 2025
ac76f7a
feat: add grace period for 3.9; tweak warning
vchudnov-g Oct 1, 2025
e093a96
lint
vchudnov-g Oct 1, 2025
187f848
allow providing a recommended version
vchudnov-g Oct 1, 2025
b575a16
refactor: used namedtuple
vchudnov-g Oct 13, 2025
ecb7211
refactor: s/"--"/UNKNOWN_VERSION_STRING/ in code, not test
vchudnov-g Oct 13, 2025
3c587cf
refactor s/next_supported_version/minimum_fully_supported_version/
vchudnov-g Oct 13, 2025
fbe0f0b
refactor: s/dependent_/consumer_/
vchudnov-g Oct 13, 2025
28b0b32
refactor: add _PACKAGE_DEPENDENCY_WARNINGS
vchudnov-g Oct 13, 2025
21c9aec
refactor: reorder and comment on _init__ statements for clarity
vchudnov-g Oct 13, 2025
e24c13d
fix: exapnd VersionInfo with version field; clarify fake dates
vchudnov-g Oct 13, 2025
dbc3a26
doc: document PythonVersionSupportStatus
vchudnov-g Oct 13, 2025
d472bae
refactor: make fake past and future versions into constants
vchudnov-g Oct 14, 2025
0550f83
refactor: reword default string for min_python
vchudnov-g Oct 14, 2025
491b695
fix: fix populating PYTHON_VERSION_INFO
vchudnov-g Oct 14, 2025
6338389
fix: type hints
vchudnov-g Oct 14, 2025
05bcf6f
feat: allow check_dependency_versions() to take any number of Depende…
vchudnov-g Oct 17, 2025
fc224b7
add unit test to satisfy coverage requirement
vchudnov-g Oct 17, 2025
a6c40ce
fix lint
vchudnov-g Oct 17, 2025
d0414b2
fix lint
vchudnov-g Oct 17, 2025
835df53
test: add test for _flatten_message
vchudnov-g Oct 23, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Fix messaegs and test
  • Loading branch information
vchudnov-g committed Oct 23, 2025
commit cda8e2709cb6f247547a998c5aa2d370a332fa9f
8 changes: 6 additions & 2 deletions google/api_core/_python_package_support.py
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,8 @@ def warn_deprecation_for_versions_less_than(
dependent_distribution_package,
) = _get_distribution_and_import_packages(dependent_import_package)
Copy link
Contributor

@daniel-sanche daniel-sanche Oct 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can these variables be made less similar? (dependent_x vs dependency_x)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

They're the correct terms, but they are very similar. I changed the less common term (IMO), dependent, to consumer.

message_template = message_template or _flatten_message(
"""DEPRECATION: Package {dependent_packages} depends on
"""
DEPRECATION: Package {dependent_packages} depends on
{dependency_packages}, currently installed at version
{version_used.__str__}. Future updates to
{dependent_packages} will require {dependency_packages} at
Expand All @@ -120,12 +121,15 @@ def warn_deprecation_for_versions_less_than(
{dependent_packages} can require the higher version, or
(b) you manually update your Python environment to use at
least version {next_supported_version} of
{dependency_packages}."""
{dependency_packages}.
"""
)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can we make this into a constant? Maybe DEFAULT_PACKAGE_DEPRECATION_TEMPLATE?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would prefer not to because the message template is defined and directly used in one place, and it's closely coupled to the variables provided by the function. I think black-boxing it inside the function, and defining it where it's used, is clearer and more compact than defining a separate constant inside or outside the function.

logging.warning(
message_template.format(
dependent_import_package=dependent_import_package,
dependency_import_package=dependency_import_package,
dependency_packages=dependency_packages,
dependent_packages=dependent_packages,
next_supported_version=next_supported_version,
version_used=version_used,
)
Expand Down
18 changes: 12 additions & 6 deletions google/api_core/_python_version_support.py
Original file line number Diff line number Diff line change
Expand Up @@ -185,36 +185,42 @@ def min_python(date: datetime.date) -> str:

if gapic_end < today:
message = _flatten_message(
f"""You are using a non-supported Python version
f"""
You are using a non-supported Python version
({py_version_str}). Google will not post any further
updates to {package_label}. We suggest you upgrade to the
latest Python version, or at least Python
{min_python(today)}, and then update {package_label}. """
{min_python(today)}, and then update {package_label}.
"""
)
logging.warning(message)
return PythonVersionStatus.PYTHON_VERSION_UNSUPPORTED

eol_date = version_info.python_eol + EOL_GRACE_PERIOD
if eol_date <= today <= gapic_end:
message = _flatten_message(
f"""You are using a Python version ({py_version_str})
f"""
You are using a Python version ({py_version_str})
past its end of life. Google will update {package_label}
with critical bug fixes on a best-effort basis, but not
with any other fixes or features. We suggest you upgrade
to the latest Python version, or at least Python
{min_python(today)}, and then update {package_label}."""
{min_python(today)}, and then update {package_label}.
"""
)
logging.warning(message)
return PythonVersionStatus.PYTHON_VERSION_EOL

if gapic_deprecation <= today <= gapic_end:
message = _flatten_message(
f"""You are using a Python version ({py_version_str}),
f"""
You are using a Python version ({py_version_str}),
which Google will stop supporting in {package_label} when
it reaches its end of life ({version_info.python_eol}). We
suggest you upgrade to the latest Python version, or at
least Python {min_python(version_info.python_eol)}, and
then update {package_label}."""
then update {package_label}.
"""
)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you think these message (or at least templates) would be better as constants, instead of embedded in the function?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, for the same reason as the other case. They are defined and used directly only once, and the substitution strings and the text are closely related to the logic of the function. I think it reads more clearly to have them defined inline, as they are now.

logging.warning(message)
return PythonVersionStatus.PYTHON_VERSION_DEPRECATED
Expand Down
35 changes: 26 additions & 9 deletions tests/unit/test_python_package_support.py
Original file line number Diff line number Diff line change
Expand Up @@ -54,46 +54,63 @@ def test_get_dependency_version_py37(mock_get_distribution):
assert get_dependency_version("not-a-package") is None


@patch("google.api_core._python_package_support._get_distribution_and_import_packages")
@patch("google.api_core._python_package_support.get_dependency_version")
@patch("google.api_core._python_package_support.logging.warning")
def test_warn_deprecation_for_versions_less_than(mock_log_warning, mock_get_version):
def test_warn_deprecation_for_versions_less_than(
mock_log_warning, mock_get_version, mock_get_packages
):
"""Test the deprecation warning logic."""
# Mock the helper function to return predictable package strings
mock_get_packages.side_effect = [
("dep-package (dep.package)", "dep-package"),
("my-package (my.package)", "my-package"),
]

# Case 1: Installed version is less than required, should warn.
mock_get_version.return_value = parse_version("1.0.0")
warn_deprecation_for_versions_less_than("my-package", "dep-package", "2.0.0")
warn_deprecation_for_versions_less_than("my.package", "dep.package", "2.0.0")
mock_log_warning.assert_called_once()
assert (
"DEPRECATION: Package my-package depends on dep-package"
"DEPRECATION: Package my-package (my.package) depends on dep-package (dep.package)"
in mock_log_warning.call_args[0][0]
)

# Case 2: Installed version is equal to required, should not warn.
mock_log_warning.reset_mock()
mock_get_packages.reset_mock()
mock_get_version.return_value = parse_version("2.0.0")
warn_deprecation_for_versions_less_than("my-package", "dep-package", "2.0.0")
warn_deprecation_for_versions_less_than("my.package", "dep.package", "2.0.0")
mock_log_warning.assert_not_called()

# Case 3: Installed version is greater than required, should not warn.
mock_log_warning.reset_mock()
mock_get_packages.reset_mock()
mock_get_version.return_value = parse_version("3.0.0")
warn_deprecation_for_versions_less_than("my-package", "dep-package", "2.0.0")
warn_deprecation_for_versions_less_than("my.package", "dep.package", "2.0.0")
mock_log_warning.assert_not_called()

# Case 4: Dependency not found, should not warn.
mock_log_warning.reset_mock()
mock_get_packages.reset_mock()
mock_get_version.return_value = None
warn_deprecation_for_versions_less_than("my-package", "dep-package", "2.0.0")
warn_deprecation_for_versions_less_than("my.package", "dep.package", "2.0.0")
mock_log_warning.assert_not_called()

# Case 5: Custom message template.
mock_log_warning.reset_mock()
mock_get_packages.reset_mock()
mock_get_packages.side_effect = [
("dep-package (dep.package)", "dep-package"),
("my-package (my.package)", "my-package"),
]
mock_get_version.return_value = parse_version("1.0.0")
template = "Custom warning for {dependency_name} used by {dependent_package}."
template = "Custom warning for {dependency_packages} used by {dependent_packages}."
warn_deprecation_for_versions_less_than(
"my-package", "dep-package", "2.0.0", message_template=template
"my.package", "dep.package", "2.0.0", message_template=template
)
mock_log_warning.assert_called_once()
assert (
"Custom warning for dep-package used by my-package."
"Custom warning for dep-package (dep.package) used by my-package (my.package)."
in mock_log_warning.call_args[0][0]
)