Files
github-spec-kit/tests/unit/test_bundle_download_url.py
Andrew Chen 0d780162f9 fix(bundle): surface a clean BundlerError on a malformed bundle download URL (#3586)
`_download_manifest` and its `_require_https` helper parsed the catalog
entry's `download_url` with an unguarded `urlparse(url)`. A malformed
authority — e.g. an unclosed IPv6 bracket like `https://[::1` — makes
`urlparse` (or `.hostname` on older Pythons) raise a raw `ValueError`. The
three `bundle` CLI commands (`info`, `install`, `update`) only catch
`BundlerError`, so that `ValueError` escaped as an uncaught traceback.

Wrap both parse sites in the same `try/except ValueError -> BundlerError`
guard already used by the sibling `_validate_remote_url` (and established by
the merged catalog-URL fix #3576), so a bad `download_url` reports a clean,
actionable error in every mode.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-17 09:52:35 -05:00

43 lines
1.5 KiB
Python

"""Unit tests for malformed download-URL handling in bundle manifest resolution."""
from __future__ import annotations
from types import SimpleNamespace
import pytest
from specify_cli.bundler import BundlerError
from specify_cli.commands.bundle import _download_manifest, _require_https
_MALFORMED_URLS = [
"https://[::1", # unclosed IPv6 bracket
"https://[not-an-ip]/bundle.yml",
]
@pytest.mark.parametrize("url", _MALFORMED_URLS)
def test_download_manifest_rejects_malformed_url_cleanly(url):
"""A malformed download_url must raise BundlerError, not a raw ValueError.
``urlparse`` raises ``ValueError`` on a malformed authority (e.g. an
unclosed IPv6 bracket). The bundle CLI commands only catch BundlerError, so
a raw ValueError would escape as an uncaught traceback. Sibling of the
guarded ``_validate_remote_url`` (adapters) and the merged #3576 fix.
"""
resolved = SimpleNamespace(
entry=SimpleNamespace(id="mybundle", download_url=url)
)
with pytest.raises(BundlerError):
_download_manifest(resolved, offline=True)
@pytest.mark.parametrize("url", _MALFORMED_URLS)
def test_require_https_rejects_malformed_url_cleanly(url):
"""``_require_https`` must also surface BundlerError on a malformed authority.
On older Python versions the ValueError is raised at ``.hostname`` access
rather than at ``urlparse``, so guarding both keeps the contract across the
CI Python matrix.
"""
with pytest.raises(BundlerError):
_require_https("bundle 'x'", url)