feat(scripts): implement report-status.sh with bats and cucumber tests

POST build status to Gitea REST API. Supports pending, success, failure, error states. Cross-repo reporting via optional root_commit and root_repo parameters. Includes mock Gitea API server shared between bats unit tests and cucumber acceptance tests.
2026-06-08 10:47:21 +03:00
parent 9a59cbc185
commit 51922e2954
10 changed files with 1540 additions and 6 deletions
@@ -0,0 +1,123 @@
+#!/usr/bin/env bats
+
+setup() {
+  source tests/helpers/mock-api.sh
+  export GITEA_API_URL="http://localhost:18080"
+  export GITEA_TOKEN="test-token-abc123"
+  export GITHUB_REPOSITORY="test-owner/test-repo"
+  export GITHUB_SHA="abc123def456789012345678901234567890abcd"
+  export GITHUB_SERVER_URL="https://gitea.example.com"
+  export GITHUB_RUN_ID="42"
+}
+
+teardown() {
+  mock_stop
+}
+
+@test "pending status is POSTed with correct payload" {
+  mock_start
+  run bash scripts/report-status.sh pending "Building project" "http://example.com/build/42"
+  [ "$status" -eq 0 ]
+  path=$(mock_get_request_path)
+  [[ "$path" == "/api/v1/repos/test-owner/test-repo/statuses/abc123def456789012345678901234567890abcd" ]]
+  body=$(mock_get_request_body)
+  [[ "$body" == *'"state":"pending"'* ]]
+  [[ "$body" == *'"description":"Building project"'* ]]
+  [[ "$body" == *'"target_url":"http://example.com/build/42"'* ]]
+  method=$(mock_get_request_method)
+  [[ "$method" == "POST" ]]
+}
+
+@test "success status with url and custom key" {
+  mock_start
+  run bash scripts/report-status.sh success "Unit tests OK" "http://example.com/reports/cucumber.html" "unit-test"
+  [ "$status" -eq 0 ]
+  body=$(mock_get_request_body)
+  [[ "$body" == *'"state":"success"'* ]]
+  [[ "$body" == *'"description":"Unit tests OK"'* ]]
+  [[ "$body" == *'"target_url":"http://example.com/reports/cucumber.html"'* ]]
+  [[ "$body" == *'"context":"unit-test"'* ]]
+}
+
+@test "failure status is POSTed correctly" {
+  mock_start
+  run bash scripts/report-status.sh failure "Tests failed: 3 of 10" "http://example.com/build/42"
+  [ "$status" -eq 0 ]
+  body=$(mock_get_request_body)
+  [[ "$body" == *'"state":"failure"'* ]]
+  [[ "$body" == *'"description":"Tests failed: 3 of 10"'* ]]
+}
+
+@test "error status is POSTed correctly" {
+  mock_start
+  run bash scripts/report-status.sh error "Build timed out" "http://example.com/build/42"
+  [ "$status" -eq 0 ]
+  body=$(mock_get_request_body)
+  [[ "$body" == *'"state":"error"'* ]]
+}
+
+@test "cross-repo: root_commit and root_repo override target" {
+  mock_start
+  run bash scripts/report-status.sh success "Deployed to staging" "http://example.com/deploy/42" "deploy-staging" "rootabc123" "services/temperature-store"
+  [ "$status" -eq 0 ]
+  path=$(mock_get_request_path)
+  [[ "$path" == "/api/v1/repos/services/temperature-store/statuses/rootabc123" ]]
+  body=$(mock_get_request_body)
+  [[ "$body" == *'"state":"success"'* ]]
+  [[ "$body" == *'"context":"deploy-staging"'* ]]
+}
+
+@test "cross-repo: only root_commit without root_repo is ignored" {
+  mock_start
+  run bash scripts/report-status.sh success "Partial cross-repo" "http://example.com" "my-key" "abc"
+  [ "$status" -eq 0 ]
+  path=$(mock_get_request_path)
+  [[ "$path" == "/api/v1/repos/test-owner/test-repo/statuses/abc123def456789012345678901234567890abcd" ]]
+}
+
+@test "default key when not provided" {
+  mock_start
+  run bash scripts/report-status.sh pending "Build started" "http://example.com/build/42"
+  [ "$status" -eq 0 ]
+  body=$(mock_get_request_body)
+  [[ "$body" == *'"context":"commit-abc123de"'* ]]
+}
+
+@test "API returns 500 causes exit 1" {
+  mock_set_response 500
+  mock_start
+  run bash scripts/report-status.sh success "Should fail" "http://example.com"
+  [ "$status" -eq 1 ]
+}
+
+@test "missing GITEA_API_URL causes exit 1 with error message" {
+  unset GITEA_API_URL
+  run bash scripts/report-status.sh pending "Test" "http://example.com"
+  [ "$status" -eq 1 ]
+  [[ "$output" == *"ERROR"* ]] || [[ "$output" == *"GITEA_API_URL"* ]]
+}
+
+@test "missing GITEA_TOKEN causes exit 1 with error message" {
+  unset GITEA_TOKEN
+  run bash scripts/report-status.sh pending "Test" "http://example.com"
+  [ "$status" -eq 1 ]
+  [[ "$output" == *"ERROR"* ]] || [[ "$output" == *"GITEA_TOKEN"* ]]
+}
+
+@test "missing required state argument causes exit 1" {
+  mock_start
+  run bash scripts/report-status.sh "" "desc" "http://example.com"
+  [ "$status" -eq 1 ]
+}
+
+@test "missing required description argument causes exit 1" {
+  mock_start
+  run bash scripts/report-status.sh pending "" "http://example.com"
+  [ "$status" -eq 1 ]
+}
+
+@test "missing required url argument causes exit 1" {
+  mock_start
+  run bash scripts/report-status.sh pending "desc" ""
+  [ "$status" -eq 1 ]
+}