tests.test_releases module

Tests for the GitHub Releases API client.

tests.test_releases.test_get_github_releases_single_page(monkeypatch)

A single-page fetch returns all releases as a dict.

tests.test_releases.test_get_github_releases_multi_page_pagination(monkeypatch)

Pagination merges results across pages until an empty page.

tests.test_releases.test_get_github_releases_empty_repo(monkeypatch)

A repo with no releases returns an empty dict (not an exception).

tests.test_releases.test_get_github_releases_raises_on_url_error(monkeypatch)

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)

A truncated page body is retried before the lookup fails.

tests.test_releases.test_get_github_releases_raises_on_persistent_incomplete_read(monkeypatch)

A page truncated on every retry raises GitHubReleasesUnavailable.

tests.test_releases.test_get_github_releases_raises_on_partial_pagination(monkeypatch)

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)

A TimeoutError surfaces as GitHubReleasesUnavailable.

tests.test_releases.test_get_github_releases_raises_on_invalid_json(monkeypatch)

An unparsable response surfaces as GitHubReleasesUnavailable.

tests.test_releases.test_get_github_releases_malformed_url_returns_empty()

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)

tests.test_releases.test_fetch_github_release_notes_filters_range_and_sorts()

tests.test_releases.test_fetch_github_release_notes_skips_empty_bodies()

tests.test_releases.test_fetch_github_release_notes_graceful_when_unavailable()

tests.test_releases.test_fetch_github_release_notes_honors_tag_pattern()

tests.test_releases.test_edit_release_notes_success()

Edits an existing release, title included, and returns True.

tests.test_releases.test_edit_release_notes_keeps_title()

Without a title, only the notes are replaced.

tests.test_releases.test_edit_release_notes_not_found()

Returns False when the release does not exist.

tests.test_releases.test_dev_release_url_and_previous_version_resolves_both()

One fetch yields the draft dev URL and the highest final version.

tests.test_releases.test_dev_release_url_and_previous_version_matches_release_segment()

A .dev1 draft still matches by release segment, ignoring drafts’ order.

tests.test_releases.test_dev_release_url_and_previous_version_no_draft()

A missing dev draft yields None for the URL but keeps the previous version.

tests.test_releases.test_dev_release_url_and_previous_version_first_release()

The very first release has a dev draft but no previous version.

tests.test_releases.test_dev_release_url_and_previous_version_unavailable(monkeypatch)

An API failure degrades both lookups to None.