{"id":15149555,"url":"https://github.com/frc1418/tbago","last_synced_at":"2025-10-24T05:31:37.745Z","repository":{"id":47253400,"uuid":"54886261","full_name":"frc1418/tbago","owner":"frc1418","description":":chart_with_upwards_trend: Go library for fetching data from The Blue Alliance API (v3).","archived":false,"fork":false,"pushed_at":"2023-02-27T18:02:23.000Z","size":50,"stargazers_count":4,"open_issues_count":4,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-31T00:07:31.437Z","etag":null,"topics":["frc","tba-api","the-blue-alliance"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frc1418.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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}},"created_at":"2016-03-28T10:56:41.000Z","updated_at":"2023-02-27T18:02:28.000Z","dependencies_parsed_at":"2024-06-21T05:43:10.018Z","dependency_job_id":"d7a19943-b32d-45fe-9a20-8d442c8e1905","html_url":"https://github.com/frc1418/tbago","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frc1418%2Ftbago","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frc1418%2Ftbago/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frc1418%2Ftbago/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frc1418%2Ftbago/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frc1418","download_url":"https://codeload.github.com/frc1418/tbago/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237918710,"owners_count":19387305,"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":["frc","tba-api","the-blue-alliance"],"created_at":"2024-09-26T14:00:35.567Z","updated_at":"2025-10-24T05:31:32.716Z","avatar_url":"https://github.com/frc1418.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tbago\n_1418 TBA Libraries_ // [Python](https://github.com/frc1418/tbapy) // [**Go**](https://github.com/frc1418/tbago) // [Ruby](https://github.com/frc1418/tbarb)\n\n\u003e Go library for interfacing with [The Blue Alliance](https://thebluealliance.com) [API](https://thebluealliance.com/apidocs) (v3).\n\n## Installation\n```sh\ngo get github.com/frc1418/tbago\n```\n\nTo use it in your project:\n\n```go\nimport (\n    ...\n    \"github.com/frc1418/tbago\"\n    ...\n)\n```\n\n## Data Retrieval\nData retrieval may appear somewhat complicated at first, as it uses a [builder pattern](https://gist.github.com/vaskoz/10073335) scheme to structure requests. However, once you gain an understanding of this system the library is quite simple to use.\n\nBefore retrieving data, you must instantiate the library, providing a valid TBA API key. The Blue Alliance's API requires that all applications identify themselves with an auth key when retrieving data. To obtain an auth key, visit TBA's [Account page](https://www.thebluealliance.com/account).\n\n```go\ntba, err := tbago.New(token)\n// Always handle errors\n```\n\nThere are several base requests you can make: `Status()`, `Teams(page int)`, `Teams(number int)`, `Events(year int)`, `Event(id string)`, `Match(key string)`, `Districts(year int)`, and `District(abbreviation string, year int)`.\n\nIf you like, you can stop there:\n\n```go\nteam, err := tba.Team(1418).Get()\n// Handle error\n```\n\nHowever, you can also modify those requests before sending them. Many requests support `Simple()` or `Year()` modifiers for optional request parameters.\n\nIn addition, if you want to, say, get a list of the teams present at a given event, you would form your request thus:\n\n```go\nteams, err := tba.Event(\"2017chcmp\").Teams().Get()\n```\n\nSpecific options can be found by searching through the source code.\n\n\n## Authors\n`tbago` was originally published as `tba` by [Carl Colglazier](https://github.com/CarlColglazier).\n\nDevelopment is now led by [Erik Boesen](https://github.com/ErikBoesen) through [Team 1418](https://github.com/frc1418).\n\n## License\nThis software is available under the terms of the [ISC License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrc1418%2Ftbago","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrc1418%2Ftbago","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrc1418%2Ftbago/lists"}