Documentation ¶
Overview ¶
Package git Main package of the git commands.
Reference: https://git-scm.com/docs/
Index ¶
- func Add(options ...types.Option) (string, error)
- func Branch(options ...types.Option) (string, error)
- func Checkout(options ...types.Option) (string, error)
- func Clone(options ...types.Option) (string, error)
- func CmdExecutor(executor types.Executor) types.Option
- func Commit(options ...types.Option) (string, error)
- func Cond(apply bool, options ...types.Option) types.Option
- func Config(options ...types.Option) (string, error)
- func Debug(g *types.Cmd)
- func Debugger(debug bool) types.Option
- func Fetch(options ...types.Option) (string, error)
- func Init(options ...types.Option) (string, error)
- func LogOutput(w io.Writer) types.Option
- func Merge(options ...types.Option) (string, error)
- func NoOp(_ *types.Cmd)
- func Pull(options ...types.Option) (string, error)
- func Push(options ...types.Option) (string, error)
- func Raw(cmd string, options ...types.Option) (string, error)
- func Rebase(options ...types.Option) (string, error)
- func Remote(options ...types.Option) (string, error)
- func Reset(options ...types.Option) (string, error)
- func RevParse(options ...types.Option) (string, error)
- func Status(options ...types.Option) (string, error)
- func Tag(options ...types.Option) (string, error)
- func Worktree(options ...types.Option) (string, error)
Examples ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Add ¶ added in v0.17.0
Add https://git-scm.com/docs/git-add
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/add" "github.com/ldez/go-git-cmd-wrapper/git" ) func main() { out, _ := git.Add(add.All, git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git add --all
func Branch ¶ added in v0.6.0
Branch https://git-scm.com/docs/git-branch
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/branch" "github.com/ldez/go-git-cmd-wrapper/git" ) func main() { out, _ := git.Branch(branch.DeleteForce, branch.BranchName("myBranch"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git branch -D myBranch
func Checkout ¶
Checkout https://git-scm.com/docs/git-checkout
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/checkout" "github.com/ldez/go-git-cmd-wrapper/git" ) func main() { out, _ := git.Checkout(checkout.NewBranch("myBranchName"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git checkout -b myBranchName
func Clone ¶
Clone https://git-scm.com/docs/git-clone
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/clone" "github.com/ldez/go-git-cmd-wrapper/git" ) func main() { out, _ := git.Clone(clone.Repository("git@github.com:ldez/go-git-cmd-wrapper.git"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git clone git@github.com:ldez/go-git-cmd-wrapper.git
func CmdExecutor ¶ added in v0.22.0
CmdExecutor Allow to override the Git command call (useful for testing purpose)
func Commit ¶ added in v0.16.0
Commit https://git-scm.com/docs/git-commit
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/commit" "github.com/ldez/go-git-cmd-wrapper/git" ) func main() { out, _ := git.Commit(commit.Amend, commit.Message("chore: foo"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git commit --amend --message="chore: foo"
func Cond ¶
Cond apply conditionally some options
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" "github.com/ldez/go-git-cmd-wrapper/push" ) func main() { param := false out, _ := git.Push(push.All, git.Cond(param, push.DryRun), push.FollowTags, push.ReceivePack("aaa"), git.CmdExecutor(cmdExecutorMock)) fmt.Print(out) param = true out, _ = git.Push(push.All, git.Cond(param, push.DryRun), push.FollowTags, push.ReceivePack("aaa"), git.CmdExecutor(cmdExecutorMock)) fmt.Print(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git push --all --follow-tags --receive-pack=aaa git push --all --dry-run --follow-tags --receive-pack=aaa
func Config ¶
Config https://git-scm.com/docs/git-config
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/config" "github.com/ldez/go-git-cmd-wrapper/git" ) func main() { out, _ := git.Config(config.Entry("rebase.autoSquash", "true"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git config rebase.autoSquash true
func Fetch ¶
Fetch https://git-scm.com/docs/git-fetch
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/fetch" "github.com/ldez/go-git-cmd-wrapper/git" ) func main() { out, _ := git.Fetch(fetch.NoTags, fetch.Remote("upstream"), fetch.RefSpec("myBranchName"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git fetch --no-tags upstream myBranchName
func Init ¶
Init https://git-scm.com/docs/git-init
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" ginit "github.com/ldez/go-git-cmd-wrapper/init" ) func main() { out, _ := git.Init(ginit.Bare, ginit.Quiet, ginit.Directory("foobar"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git init --bare --quiet foobar
func Merge ¶ added in v0.18.0
Merge https://git-scm.com/docs/git-merge
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" "github.com/ldez/go-git-cmd-wrapper/merge" ) func main() { out, _ := git.Merge(merge.Squash, merge.Commits("myBranch"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git merge --squash myBranch
func Pull ¶ added in v0.11.0
Pull https://git-scm.com/docs/git-pull
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" "github.com/ldez/go-git-cmd-wrapper/pull" ) func main() { out, _ := git.Pull(pull.All, pull.Force, pull.Repository("upstream"), pull.Refspec("master"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git pull --all --force upstream master
func Push ¶
Push https://git-scm.com/docs/git-push
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" "github.com/ldez/go-git-cmd-wrapper/push" ) func main() { out, _ := git.Push(push.All, push.FollowTags, push.ReceivePack("aaa"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git push --all --follow-tags --receive-pack=aaa
func Rebase ¶
Rebase https://git-scm.com/docs/git-rebase
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" "github.com/ldez/go-git-cmd-wrapper/rebase" ) func main() { out, _ := git.Rebase(rebase.PreserveMerges, rebase.Branch(fmt.Sprintf("%s/%s", "upstream", "master")), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git rebase --preserve-merges upstream/master
func Remote ¶
Remote https://git-scm.com/docs/git-remote
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" "github.com/ldez/go-git-cmd-wrapper/remote" ) func main() { out, _ := git.Remote(remote.Add("upstream", "git@github.com:johndoe/go-git-cmd-wrapper.git"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git remote add upstream git@github.com:johndoe/go-git-cmd-wrapper.git
func Reset ¶ added in v0.16.0
Reset https://git-scm.com/docs/git-reset
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" "github.com/ldez/go-git-cmd-wrapper/reset" ) func main() { out, _ := git.Reset(reset.Soft, reset.Commit("e41f083"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git reset --soft e41f083
func RevParse ¶ added in v0.9.0
RevParse https://git-scm.com/docs/git-rev-parse
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" "github.com/ldez/go-git-cmd-wrapper/revparse" ) func main() { out, _ := git.RevParse(revparse.AbbrevRef(""), revparse.Args("HEAD"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git rev-parse --abbrev-ref HEAD
func Status ¶ added in v1.3.0
Status https://git-scm.com/docs/git-status
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" "github.com/ldez/go-git-cmd-wrapper/status" ) func main() { out, _ := git.Status(status.Short, status.Branch, git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git status --short --branch
func Tag ¶ added in v1.1.0
Tag https://git-scm.com/docs/git-tag
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" "github.com/ldez/go-git-cmd-wrapper/tag" ) func main() { out, _ := git.Tag(tag.List, git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git tag --list
func Worktree ¶ added in v0.21.0
Worktree https://git-scm.com/docs/git-worktree
Example ¶
package main import ( "fmt" "strings" "github.com/ldez/go-git-cmd-wrapper/git" "github.com/ldez/go-git-cmd-wrapper/worktree" ) func main() { out, _ := git.Worktree(worktree.Add("v1.0", "origin/v1.0"), git.CmdExecutor(cmdExecutorMock)) fmt.Println(out) } func cmdExecutorMock(name string, _ bool, args ...string) (string, error) { return fmt.Sprintln(name, strings.Join(args, " ")), nil }
Output: git worktree add v1.0 origin/v1.0
Types ¶
This section is empty.