Files
computer-playbook/tests/unit/python/utils/update/test_docker.py
T
kevinveenbirkenbachandClaude Opus 5.5 1585e056fc feat(update): let a declared version source own the whole pin
A pin that names its own upstream in an update: block was still collected
by the image updater or, for a ref, by the repository updater. Those raise
it to the newest tag of its registry or repository, which for a component
of a release is not the release's value. A tag built from several upstream
values, such as <freeswitch>-<bigbluebutton>, could not be resolved at
all: the resolver takes one capture and keeps a pin on its suffix.

The image updater now skips a version and the repository updater a ref
that declares a source for itself. An http_regex source accepts a template
over the pattern's named groups, and a templated pin moves whenever the
assembled value changes, its suffix included.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-08 10:32:14 +02:00

83 lines
2.4 KiB
Python

from __future__ import annotations
import tempfile
import unittest
from pathlib import Path
from utils.cache.files import read_text
from utils.roles.mapping import ROLE_FILE_META_SERVICES
from utils.update.docker import (
_registry_cursor,
collect_entries,
sourced_services,
update_config_versions,
)
SOURCED = """bundled:
image: example/app
version: v1.0.0
update:
type: http_regex
url: https://example.invalid/bundle
pattern: "app:(v[0-9.]+)"
tracked:
image: example/side
version: v2.0.0
other_version: v3.0.0
update:
- key: other_version
type: git_tags
repository: https://example.invalid/side.git
plain:
image: example/plain
version: v4.0.0
"""
class TestRegistryCursor(unittest.TestCase):
def test_v_prefixed_pin_seeds_cursor(self) -> None:
self.assertEqual(_registry_cursor("v19.1.1"), "v")
def test_bare_numeric_pin_scans_from_start(self) -> None:
self.assertIsNone(_registry_cursor("19.1.1"))
class TestDeclaredSource(unittest.TestCase):
def test_a_version_with_its_own_source_is_left_to_that_source(self) -> None:
root = Path(tempfile.mkdtemp())
config = root / "roles" / "web-app-example" / ROLE_FILE_META_SERVICES
config.parent.mkdir(parents=True)
config.write_text(SOURCED, encoding="utf-8")
self.assertEqual(sourced_services(config), {"bundled"})
self.assertEqual(
sorted(entry.service for entry in collect_entries(root)),
["plain", "tracked"],
)
class TestUpdateDocker(unittest.TestCase):
def test_update_config_versions_updates_only_target_services(self) -> None:
original = """moodle:
version: "4.5" # Keep comment
image: bitnamilegacy/moodle
nginx:
version: alpine
image: nginx
"""
with tempfile.TemporaryDirectory() as tmpdir:
config_path = Path(tmpdir) / "main.yml"
config_path.write_text(original, encoding="utf-8")
changed = update_config_versions(config_path, {"moodle": "5.0"})
self.assertTrue(changed)
updated = read_text(str(config_path))
self.assertIn('version: "5.0" # Keep comment', updated)
self.assertIn("version: alpine", updated)
self.assertNotIn('version: "4.5" # Keep comment', updated)
if __name__ == "__main__":
unittest.main()