{"id":15547535,"url":"https://github.com/cvbarros/go-teamcity","last_synced_at":"2025-04-23T18:23:45.649Z","repository":{"id":48994551,"uuid":"122406050","full_name":"cvbarros/go-teamcity","owner":"cvbarros","description":"Golang client for TeamCity REST API","archived":false,"fork":false,"pushed_at":"2021-08-18T13:41:00.000Z","size":73353,"stargazers_count":32,"open_issues_count":12,"forks_count":33,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-30T02:22:09.929Z","etag":null,"topics":["go","golang","sdk-go","teamcity"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cvbarros.png","metadata":{"files":{"readme":"README.MD","changelog":"CHANGELOG.MD","contributing":"CONTRIBUTING.MD","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-02-21T23:17:07.000Z","updated_at":"2024-08-29T18:18:16.000Z","dependencies_parsed_at":"2022-09-07T04:03:17.541Z","dependency_job_id":null,"html_url":"https://github.com/cvbarros/go-teamcity","commit_stats":null,"previous_names":["cvbarros/go-teamcity-sdk"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvbarros%2Fgo-teamcity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvbarros%2Fgo-teamcity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvbarros%2Fgo-teamcity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvbarros%2Fgo-teamcity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cvbarros","download_url":"https://codeload.github.com/cvbarros/go-teamcity/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250488367,"owners_count":21438770,"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":["go","golang","sdk-go","teamcity"],"created_at":"2024-10-02T13:09:33.201Z","updated_at":"2025-04-23T18:23:45.629Z","avatar_url":"https://github.com/cvbarros.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# go-teamcity #\n\n[![GoDoc](https://godoc.org/github.com/cvbarros/go-teamcity/github?status.svg)](https://godoc.org/github.com/cvbarros/go-teamcity) [![Build Status](https://travis-ci.com/cvbarros/go-teamcity.svg?branch=master)](https://travis-ci.com/cvbarros/go-teamcity)\n\n\n## LOOKING FOR MAINTAINTERS ##\n\nThis project is in need of new maintainers, please see here:  \nhttps://github.com/cvbarros/go-teamcity/issues/94.  \nhttps://github.com/cvbarros/terraform-provider-teamcity/issues/113\n\n---\n_go-teamcity_ is a Go client library interacting with Jetbrain's [TeamCity CI server REST API](https://confluence.jetbrains.com/display/TCD10/REST+API).  \nCurrently, guaranteed supported API version (on CI tests) is **TeamCity 2019.2.2 or up**.\n\n## Motivation ##\ngo-teamcity is intended for automating Jetbrain's TeamCity tasks and configurations using Go.\nIt is also the client library used in [TeamCity Provider](https://github.com/cvbarros/terraform-provider-teamcity), a [Hashicorp's Terraform](https://www.terraform.io) custom provider to configure TeamCity as code.\n\n## Usage ##\n\n```go\nimport teamcity \"github.com/cvbarros/go-teamcity\"\n```\n\nConstruct a new Teamcity client with a default `http.Client` for the server at the `TEAMCITY_ADDR` environment variable, then use the various services exposed by the client to use TeamCity API's features.\n\n```go\nclient := teamcity.NewClient(teamcity.BasicAuth(\"admin\", \"admin\"), http.DefaultClient)\n```\nor\n```go\nclient := teamcity.NewClient(teamcity.TokenAuth(\"token\"), http.DefaultClient)\n``` \n```go\n// retrieve a project identified 'myproject', using the id: locator\nproject,  err := client.Projects.GetById(\"myproject\")\n```\n\n\u003e You may also use an `teamcity.NewClientWithAddress(...)` to explicitly provide the server address.\n\n### Examples ###\n\nFor now, [integration tests](https://github.com/cvbarros/go-teamcity/search?q=filename%3A*_test.go\u0026unscoped_q=filename%3A*_test.go) are the best examples on how to use the library to interact with the several services.\n\n## Other Information ##\n\nWe follow [semantic versioning](https://semver.org) conventions. Thus releases are tagged in the `\u003cmajor\u003e.\u003cminor\u003e.\u003cpatch\u003e` format, meaning:\n\n- Public API breaking changes or major TeamCity version support (2018, 2019, etc) **MUST** increment the `major` version.\n- Features and considerable refactorings without breaking compatibility should increment the `minor`.\n- Bugfixes and minor patches should increment `patch`\n\nAll changes released are documented on the [CHANGELOG](CHANGELOG.MD).  \n\nIssues, contributions and feature requests are welcome, please see [contributing](CONTRIBUTING.MD) for guidance on how to get involved.\n\nThe development and design of this library is based on the [go-github](https://github.com/google/go-github) project.\n\n## License ##\n\nThis library is distributed under the MPL-2.0 license fully described in the [LICENSE](./LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcvbarros%2Fgo-teamcity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcvbarros%2Fgo-teamcity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcvbarros%2Fgo-teamcity/lists"}