{"id":20214155,"url":"https://github.com/masterminds/vcs","last_synced_at":"2026-04-01T20:43:41.822Z","repository":{"id":35380585,"uuid":"39643904","full_name":"Masterminds/vcs","owner":"Masterminds","description":"VCS Repo management through a common interface in Go","archived":false,"fork":false,"pushed_at":"2022-03-31T14:40:37.000Z","size":320,"stargazers_count":199,"open_issues_count":14,"forks_count":60,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-03-24T13:03:59.820Z","etag":null,"topics":["bzr","git","go","golang","hg","scm","svn","vcs"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Masterminds.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-07-24T16:06:34.000Z","updated_at":"2025-02-19T16:06:18.000Z","dependencies_parsed_at":"2022-07-08T05:59:11.177Z","dependency_job_id":null,"html_url":"https://github.com/Masterminds/vcs","commit_stats":null,"previous_names":["masterminds/go-vcs"],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Masterminds%2Fvcs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Masterminds%2Fvcs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Masterminds%2Fvcs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Masterminds%2Fvcs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Masterminds","download_url":"https://codeload.github.com/Masterminds/vcs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247675597,"owners_count":20977376,"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":["bzr","git","go","golang","hg","scm","svn","vcs"],"created_at":"2024-11-14T06:14:20.973Z","updated_at":"2026-04-01T20:43:41.814Z","avatar_url":"https://github.com/Masterminds.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VCS Repository Management for Go\n\nManage repos in varying version control systems with ease through a common\ninterface.\n\n[![Linux Tests](https://github.com/Masterminds/vcs/actions/workflows/linux-tests.yaml/badge.svg)](https://github.com/Masterminds/vcs/actions/workflows/linux-tests.yaml) [![Go Report Card](https://goreportcard.com/badge/github.com/Masterminds/vcs)](https://goreportcard.com/report/github.com/Masterminds/vcs)\n[![Windows Tests](https://github.com/Masterminds/vcs/actions/workflows/windows-tests.yaml/badge.svg)](https://github.com/Masterminds/vcs/actions/workflows/windows-tests.yaml) [![Docs](https://img.shields.io/static/v1?label=docs\u0026message=reference\u0026color=blue)](https://pkg.go.dev/github.com/Masterminds/vcs)\n\n**Note: Module names are case sensitive. Please be sure to use `github.com/Masterminds/vcs` with the capital M.**\n\n## Quick Usage\n\nQuick usage:\n\n\tremote := \"https://github.com/Masterminds/vcs\"\n    local, _ := os.TempDir(\"\", \"go-vcs\")\n    repo, err := NewRepo(remote, local)\n\nIn this case `NewRepo` will detect the VCS is Git and return a `GitRepo`. All of\nthe repos implement the `Repo` interface with a common set of features between\nthem.\n\n## Supported VCS\n\nGit, SVN, Bazaar (Bzr), and Mercurial (Hg) are currently supported. They each\nhave their own type (e.g., `GitRepo`) that follow a simple naming pattern. Each\ntype implements the `Repo` interface and has a constructor (e.g., `NewGitRepo`).\nThe constructors have the same signature as `NewRepo`.\n\n## Features\n\n- Clone or checkout a repository depending on the version control system.\n- Pull updates to a repository.\n- Get the currently checked out commit id.\n- Checkout a commit id, branch, or tag (depending on the availability in the VCS).\n- Get a list of tags and branches in the VCS.\n- Check if a string value is a valid reference within the VCS.\n- More...\n\nFor more details see [the documentation](https://godoc.org/github.com/Masterminds/vcs).\n\n## Motivation\n\nThe package `golang.org/x/tools/go/vcs` provides some valuable functionality\nfor working with packages in repositories in varying source control management\nsystems. That package, while useful and well tested, is designed with a specific\npurpose in mind. Our uses went beyond the scope of that package. To implement\nour scope we built a package that went beyond the functionality and scope\nof `golang.org/x/tools/go/vcs`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasterminds%2Fvcs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmasterminds%2Fvcs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasterminds%2Fvcs/lists"}