gitclone

Documentation

Overview

Package gitclone is the first git-clone plumbing in this repo: a small shallow-clone helper for `sf plugin install <git-url>` (and, later, `sf pack install`). It shells out to the user's own `git`, so authentication is ambient — whatever ssh-agent, a credential helper, or ~/.netrc already trusts — sofia never reads, stores, or asks for a token itself.

Index

• func CloneShallow(url, ref, dst string) (string, error)
• func IsURL(s string) bool
• func RepoName(rawurl string) (string, error)

Functions

func CloneShallow

func CloneShallow(url, ref, dst string) (string, error)

CloneShallow clones url at ref into dst (which must not already exist) and returns the commit it landed on. ref is a branch or tag name; "" clones the remote's default branch. Commit SHAs are not supported — `git clone --branch` doesn't accept one, and resolving one would need a full clone.

func IsURL

func IsURL(s string) bool

IsURL reports whether s names a git remote rather than a local path, by prefix alone (no regex, no network round-trip). Anything else — including relative and absolute filesystem paths — is treated as a local directory by the caller.

func RepoName

func RepoName(rawurl string) (string, error)

RepoName derives a plugin/pack name from a git URL: the last path segment, with a trailing ".git" and any trailing slash stripped. It understands both URL form (scheme://host/path) and the scp-like shorthand git@host:path.