{"id":15664769,"url":"https://github.com/katbyte/tctest","last_synced_at":"2025-10-30T02:07:33.228Z","repository":{"id":41626284,"uuid":"185623066","full_name":"katbyte/tctest","owner":"katbyte","description":"CLI utility to run tests on TC for github PRss","archived":false,"fork":false,"pushed_at":"2025-01-28T15:19:36.000Z","size":22750,"stargazers_count":16,"open_issues_count":14,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-19T12:13:51.376Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/katbyte.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-05-08T14:32:18.000Z","updated_at":"2025-01-28T15:19:40.000Z","dependencies_parsed_at":"2024-06-18T21:27:27.997Z","dependency_job_id":"45780794-9624-4d06-8e25-188df7f4578e","html_url":"https://github.com/katbyte/tctest","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katbyte%2Ftctest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katbyte%2Ftctest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katbyte%2Ftctest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katbyte%2Ftctest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/katbyte","download_url":"https://codeload.github.com/katbyte/tctest/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252591558,"owners_count":21773133,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-03T13:44:06.759Z","updated_at":"2025-10-30T02:07:33.199Z","avatar_url":"https://github.com/katbyte.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tctest\n\n![build](https://github.com/katbyte/tctest/actions/workflows/build.yaml/badge.svg)\n![lint](https://github.com/katbyte/tctest/actions/workflows/lint.yaml/badge.svg)\n[![Go Report Card](https://goreportcard.com/badge/github.com/katbyte/tctest)](https://goreportcard.com/report/github.com/katbyte/tctest)\n\nA command-line utility to trigger builds in teamcity to run provider acceptance tests. Given a PR# it can find the files modified, tests to run and generate a TEST_PATTERN.    \n\nExample:\n![pr-example](.github/images/example.png)\n\nbasic help:\n![help](.github/images/help.png)\n\n## Installation\n\nTo install `tctest` from the command line, you can run:\n```bash\ngo install github.com/katbyte/tctest\n```\n\n## Configuration\n\nWhile all commands can be configured from the command line, environment variables can be used instead. By creating a file such as [`set_env_example.sh`](.github/images/set_env_example.sh), it can then be sourced:\n![env](.github/images/env.png) \n\n## Basic Usage\n\nTo run a build on a branch with a test pattern:\n```bash\ntctest branch master TestAcc -s ci.katbyte.me -b AzureRm -u katbyte\n```\nor when environment variables are set:\n```bash\ntctest branch master TestAcc\n```\n\n## For a PR\n\nTo run a build on the merge branch with a specific test pattern:\n```bash\ntctest pr 3232 TestAcc -s ci.katbyte.me -b AzureRm -u katbyte -r terraform-providers/terraform-provider-azurerm\n```\n\n\nIf no test pattern is specified the modified files in the PR will be checked and it will be generated automatically:\n```bash\ntctest pr 3232\n```\n\nMultiple PRs can be specified at once\n```bash\ntctest pr 3232,5454,7676\n````\n\n\nTo list all the tests discovered for a given PR:\n```bash\ntctest list 3232\n```\n\nTo run tests against a PR and display results when complete:\n```bash\ntctest pr 3232 --wait\n```\n\n## Build results: \n*By TeamCity Build Number*\n\nTo show the PASS/FAIL/SKIP results for a TeamCity build number:\n```bash\ntctest results 12345\n```\n\nTo wait for a running or queued build to complete and then show the results:\n```bash\ntctest results 12345 --wait\n```\n\n*By Github PR Number*\n\nTo show the PASS/FAIL/SKIP results for **all** TeamCity builds for a Github PR:\n```bash\ntctest results pr 12345\n```\nTo show the PASS/FAIL/SKIP results for the **latest** TeamCity build for a Github PR:\n```bash\ntctest results pr 12345 --latest\n```\nTo wait for a running or queued build to complete and then show the results:\n```bash\ntctest results pr 12345 --wait\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkatbyte%2Ftctest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkatbyte%2Ftctest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkatbyte%2Ftctest/lists"}