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 break returned 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/repo segment 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_extract_version(tag, pattern, expected)[source]
tests.test_releases.test_fetch_github_release_notes_filters_range_and_sorts()[source]
tests.test_releases.test_fetch_github_release_notes_skips_empty_bodies()[source]
tests.test_releases.test_fetch_github_release_notes_graceful_when_unavailable()[source]
tests.test_releases.test_fetch_github_release_notes_honors_tag_pattern()[source]
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(side_effect, expected)[source]
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_creates_a_draft_with_its_assets(tmp_path)[source]
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.test_upload_release_files_replaces_same_named_assets(tmp_path)[source]
tests.test_releases.test_upload_release_files_without_files_calls_nothing()[source]
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.

tests.test_releases.test_dev_release_url_and_previous_version_unavailable(monkeypatch)[source]

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.

tests.test_releases.test_release_review_steps_unavailable(monkeypatch, repo_url)[source]

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.