gitremote

package

v0.38.2 Latest Latest Go to latest Published: Sep 1, 2026 License: Apache-2.0 Imports: 4 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/specscore/specscore-cli

Links

Open Source Insights

Documentation ¶

Overview ¶

Package gitremote parses git remote URLs into their owner / repo / host components. MVP supports GitHub hosts only; other hosts return ok=false.

Index ¶

func CurrentBranch(dir string) (string, error)
func HeadSHA(dir string) (string, error)
func OriginURL(dir string) (string, error)
type Remote
- func Parse(url string) (Remote, bool)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func CurrentBranch ¶ added in v0.28.0

func CurrentBranch(dir string) (string, error)

CurrentBranch returns the short name of the branch currently checked out at dir (e.g. "main", "feature/foo"). It returns an error when dir is not a git repository, or when HEAD is detached (not pointing at a branch) — a detached HEAD has no branch name to report, and callers that need "is this invocation on branch X" (e.g. coordination-branch enforcement) should treat that error as "not on X" rather than guessing a name.

func HeadSHA ¶ added in v0.5.1

func HeadSHA(dir string) (string, error)

HeadSHA returns the 40-char hex SHA of HEAD for the git repository at dir. It returns an error when dir is not a git repository, has no commits yet, or any other `git rev-parse HEAD` failure occurs. Callers that need an always-succeed path (e.g. envelope auto-fill) should substitute their own fallback value on error rather than propagating it.

func OriginURL ¶

func OriginURL(dir string) (string, error)

OriginURL returns the URL of the "origin" remote for the git repository at dir. Returns an error if dir is not a git repo or has no origin remote.

Types ¶

type Remote ¶

type Remote struct {
	Owner string
	Repo  string
	Host  string // e.g. "github.com"
}

Remote is a parsed git remote URL.

func Parse ¶

func Parse(url string) (Remote, bool)

Parse extracts the owner/repo/host from a git remote URL. It returns (Remote, true) only for GitHub hosts in MVP; any other host (GitLab, Bitbucket, self-hosted) yields (_, false) so callers can gracefully skip rather than emit broken links.

Source Files ¶

View all Source files

gitremote.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL