"""Tests for GiteaClient API client.""" from unittest.mock import MagicMock, patch from gitea_dashboard.client import GiteaClient class TestGiteaClientInit: """Test client initialization and auth.""" def test_auth_header_is_set(self): """Session must carry Authorization header with token prefix.""" client = GiteaClient("http://gitea.local:3000", "my-secret-token") assert client.session.headers["Authorization"] == "token my-secret-token" def test_base_url_stored(self): """Base URL is stored without trailing slash.""" client = GiteaClient("http://gitea.local:3000/", "tok") assert client.base_url == "http://gitea.local:3000" def test_default_timeout_is_30(self): """Default timeout is 30 seconds.""" client = GiteaClient("http://gitea.local:3000", "tok") assert client.timeout == 30 def test_custom_timeout_is_stored(self): """Custom timeout is stored and used.""" client = GiteaClient("http://gitea.local:3000", "tok", timeout=10) assert client.timeout == 10 class TestGetPaginated: """Test internal pagination logic.""" def _make_client(self): return GiteaClient("http://gitea.local:3000", "tok") def test_single_page(self): """When response has fewer items than limit, stop after one request.""" client = self._make_client() # Return 3 items (< 50 limit) -> single page mock_resp = MagicMock() mock_resp.raise_for_status = MagicMock() mock_resp.json.return_value = [{"id": 1}, {"id": 2}, {"id": 3}] with patch.object(client.session, "get", return_value=mock_resp) as mock_get: result = client._get_paginated("/api/v1/user/repos") assert result == [{"id": 1}, {"id": 2}, {"id": 3}] # Called exactly once (single page) mock_get.assert_called_once() def test_two_pages(self): """When first page is full (limit items), fetch second page.""" client = self._make_client() page1 = [{"id": i} for i in range(50)] # Exactly limit=50 page2 = [{"id": i} for i in range(50, 60)] # 10 items -> last page mock_resp1 = MagicMock() mock_resp1.raise_for_status = MagicMock() mock_resp1.json.return_value = page1 mock_resp2 = MagicMock() mock_resp2.raise_for_status = MagicMock() mock_resp2.json.return_value = page2 with patch.object(client.session, "get", side_effect=[mock_resp1, mock_resp2]): result = client._get_paginated("/api/v1/user/repos") assert len(result) == 60 assert result == page1 + page2 def test_pagination_params_forwarded(self): """Extra params are merged with pagination params.""" client = self._make_client() mock_resp = MagicMock() mock_resp.raise_for_status = MagicMock() mock_resp.json.return_value = [] with patch.object(client.session, "get", return_value=mock_resp) as mock_get: client._get_paginated("/api/v1/repos/o/r/milestones", params={"state": "open"}) call_params = mock_get.call_args[1]["params"] assert call_params["state"] == "open" assert call_params["limit"] == 50 assert call_params["page"] == 1 class TestGetRepos: """Test get_repos method.""" def test_get_repos_calls_paginated(self): """get_repos delegates to _get_paginated with correct endpoint.""" client = GiteaClient("http://gitea.local:3000", "tok") with patch.object(client, "_get_paginated", return_value=[{"id": 1}]) as mock_pag: result = client.get_repos() mock_pag.assert_called_once_with("/api/v1/user/repos") assert result == [{"id": 1}] class TestGetLatestRelease: """Test get_latest_release method.""" def test_returns_release_on_success(self): """Returns release dict when repo has a release.""" client = GiteaClient("http://gitea.local:3000", "tok") mock_resp = MagicMock() mock_resp.status_code = 200 mock_resp.json.return_value = {"tag_name": "v1.0", "published_at": "2026-01-01"} with patch.object(client.session, "get", return_value=mock_resp): result = client.get_latest_release("admin", "my-repo") assert result == {"tag_name": "v1.0", "published_at": "2026-01-01"} def test_returns_none_on_404(self): """Returns None when repo has no release (404).""" client = GiteaClient("http://gitea.local:3000", "tok") mock_resp = MagicMock() mock_resp.status_code = 404 with patch.object(client.session, "get", return_value=mock_resp): result = client.get_latest_release("admin", "no-release-repo") assert result is None def test_raises_on_server_error(self): """HTTP 500 raises an exception instead of silently returning bad data.""" import pytest import requests as req client = GiteaClient("http://gitea.local:3000", "tok") mock_resp = MagicMock() mock_resp.status_code = 500 mock_resp.raise_for_status.side_effect = req.HTTPError("500 Server Error") with patch.object(client.session, "get", return_value=mock_resp): with pytest.raises(req.HTTPError): client.get_latest_release("admin", "my-repo") class TestGetMilestones: """Test get_milestones method.""" def test_get_milestones_calls_paginated_with_state_open(self): """get_milestones delegates to _get_paginated with state=open.""" client = GiteaClient("http://gitea.local:3000", "tok") milestones = [{"title": "v2.0", "open_issues": 3, "closed_issues": 2}] with patch.object(client, "_get_paginated", return_value=milestones) as mock_pag: result = client.get_milestones("admin", "my-repo") mock_pag.assert_called_once_with( "/api/v1/repos/admin/my-repo/milestones", params={"state": "open"}, ) assert result == milestones