Files
skillshare/ai_docs/tests/azure_devops_url_parse_runbook.md
T
Willie ba4f7c9c4d docs(runbook): migrate all 16 runbooks to typed assertion syntax
Convert Expected blocks from natural language descriptions to
matchable assertions: exit_code: N, regex: <pattern>, jq: <expr>,
Not <text>, and plain substring matches. All runbooks now parse
correctly with the assertion engine.
2026-03-11 04:53:08 +08:00

2.3 KiB
Raw Blame History

Azure DevOps URL Parsing E2E Runbook

Scope

Verify ParseSource correctly handles all Azure DevOps URL formats: modern HTTPS (dev.azure.com), legacy HTTPS (visualstudio.com), SSH v3 (ssh.dev.azure.com), and ado: shorthand. Also verify TrackName and GitHubOwner return correct values.

Environment

  • Devcontainer with rebuilt binary (go build -o bin/skillshare ./cmd/skillshare)
  • No network required — all tests are offline unit tests

Steps

Step 1: Run Azure DevOps unit tests

cd /workspace
go test ./internal/install/ -run TestParseSource_AzureDevOps -v -count=1

Expected:

  • exit_code: 0
  • PASS
  • regex: ok\s+skillshare/internal/install
  • Not FAIL

Step 2: Run Azure DevOps TrackName tests

cd /workspace
go test ./internal/install/ -run TestParseSource_AzureDevOps_TrackName -v -count=1

Expected:

  • exit_code: 0
  • PASS
  • regex: ok\s+skillshare/internal/install
  • Not FAIL

Step 3: Run Azure DevOps GitHubOwner empty tests

cd /workspace
go test ./internal/install/ -run TestParseSource_AzureDevOps_GitHubOwnerEmpty -v -count=1

Expected:

  • exit_code: 0
  • PASS
  • regex: ok\s+skillshare/internal/install
  • Not FAIL

Step 4: Regression — all existing source tests still pass

cd /workspace
go test ./internal/install/ -run TestParseSource -v -count=1

Expected:

  • exit_code: 0
  • PASS
  • regex: ok\s+skillshare/internal/install
  • Not FAIL

Step 5: Regression — all install package tests pass

cd /workspace
go test ./internal/install/ -count=1

Expected:

  • exit_code: 0
  • regex: ok\s+skillshare/internal/install
  • Not FAIL

Step 6: Dry-run with Azure DevOps URL (CLI integration)

cd /workspace
bin/skillshare install --dry-run "https://dev.azure.com/testorg/testproj/_git/testrepo" 2>&1

Expected:

Step 7: Dry-run with ado: shorthand (CLI integration)

cd /workspace
bin/skillshare install --dry-run "ado:testorg/testproj/testrepo" 2>&1

Expected:

Pass Criteria

  • Steps 1–5: All Go unit tests PASS with 0 failures
  • Steps 6–7: CLI output shows correctly parsed Azure DevOps URL