tests.test_releases module¶
Tests for the GitHub Releases API client.
- tests.test_releases.test_get_github_releases_single_page(monkeypatch)[source]¶
A single-page fetch returns all releases as a dict.
- tests.test_releases.test_get_github_releases_multi_page_pagination(monkeypatch)[source]¶
Pagination merges results across pages until a short page.
- tests.test_releases.test_get_github_releases_stops_on_a_short_page(monkeypatch)[source]¶
A page shorter than a full one is the last: no empty page is fetched.
- tests.test_releases.test_release_maps_leave_drafts_out(monkeypatch)[source]¶
A draft reads as absent, whatever token can see it.
- tests.test_releases.test_get_github_releases_strips_the_tag_prefix(monkeypatch)[source]¶
Only
v-prefixed tags count, keyed by their bare version.
- tests.test_releases.test_force_refresh_skips_the_cached_map(monkeypatch)[source]¶
A forced refresh reads the API even when a cached map is fresh.
- tests.test_releases.test_corrupt_cached_map_falls_through_to_the_api(monkeypatch, cached)[source]¶
A cached map that does not decode is fetched again, not trusted.
- tests.test_releases.test_get_github_releases_empty_repo(monkeypatch)[source]¶
A repo with no releases returns an empty dict (not an exception).
- tests.test_releases.test_get_github_releases_raises_on_url_error(monkeypatch)[source]¶
A URLError on the first page raises GitHubReleasesUnavailable.
Distinguishes “we don’t know” from “no releases” — the legacy behavior returned
{}for both, which let transient API failures silently rewrite the changelog.
- tests.test_releases.test_get_github_releases_retries_incomplete_read(monkeypatch)[source]¶
A truncated page body is retried before the lookup fails.
- tests.test_releases.test_get_github_releases_raises_on_persistent_incomplete_read(monkeypatch)[source]¶
A page truncated on every retry raises GitHubReleasesUnavailable.
- tests.test_releases.test_get_github_releases_raises_on_partial_pagination(monkeypatch)[source]¶
A URLError on a later page raises rather than silently truncating.
This is the failure mode behind kdeldycke/click-extra#1702: page 1 succeeded, page 2 timed out, the legacy
breakreturned the partial page-1 result, and the caller treated every missing version as “no GitHub release exists.”
- tests.test_releases.test_get_github_releases_raises_on_timeout(monkeypatch)[source]¶
A TimeoutError surfaces as GitHubReleasesUnavailable.
- tests.test_releases.test_get_github_releases_raises_on_invalid_json(monkeypatch)[source]¶
An unparsable response surfaces as GitHubReleasesUnavailable.
- tests.test_releases.test_get_github_releases_malformed_url_returns_empty()[source]¶
A URL with no
owner/reposegment returns an empty dict.This is a caller-level bug, not an API failure: nothing to fetch and nothing to gate against, so the legacy “return empty” behavior is preserved.
- tests.test_releases.test_edit_release_notes_success()[source]¶
Edits an existing release, title included, and returns True.
- tests.test_releases.test_edit_release_notes_keeps_title()[source]¶
Without a title, only the notes are replaced.
- tests.test_releases.test_edit_release_notes_not_found(error)[source]¶
Returns False when the release does not exist.
- tests.test_releases.test_edit_release_notes_raises_on_a_transient_failure()[source]¶
A failure other than an absence is raised, never read as one.
A caller treating it as “no such release” would create a second release for the same tag.
- tests.test_releases.test_release_exists_raises_on_a_transient_failure()[source]¶
A failed lookup is no absence: reading it as one duplicates the release.
- tests.test_releases.test_create_release_leaves_an_existing_release_alone()[source]¶
A re-run finds the release its first attempt created.
- tests.test_releases.DRAFTS_URL = 'https://github.com/user/repo/releases/tag'¶
Base of the URL a draft release lives at before it gets a tag.
- tests.test_releases.test_dev_release_url_and_previous_version(releases, version, expected)[source]¶
One fetch yields the draft dev URL and the highest final version.
An API failure degrades both lookups to None.
- tests.test_releases.test_release_review_steps(monkeypatch)[source]¶
Review steps embed the draft dev URL and the previous-version compare link.
- tests.test_releases.test_release_review_steps_partial(monkeypatch)[source]¶
Each step is omitted independently when its release data is missing.
Both steps collapse to empty strings when nothing can be looked up.
- tests.test_releases.test_resolve_tag_to_sha(monkeypatch, repo_url, answers, expected)[source]¶
A tag resolves to its commit, one more lookup away for an annotated tag.
- tests.test_releases.RANGE_RELEASES = {'v1.0.0': ('2026-01-01', 'notes 1.0.0'), 'v1.1.0': ('2026-02-01', 'notes 1.1.0'), 'v1.2.0': ('2026-03-01', 'notes 1.2.0'), 'v1.3.0': ('2026-05-01', 'notes 1.3.0'), 'v1.3.0rc1': ('2026-04-01', 'notes 1.3.0rc1'), 'v2.0.0b1': ('2026-06-01', 'notes 2.0.0b1')}¶
Releases of one repository, two pre-releases among them.
- tests.test_releases.test_fetch_github_release_notes_covers_the_bump(request_, expected)[source]¶
A bump shows the notes of the releases it covers, and of no others.
Pre-releases inside the range are left out: the sweep never adopts one, so the bump never stood on it. The adopted version is kept whatever it is.