From c9353b2bd7c1cbdf8f78dad6deac64ed2f2ed9eb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=C3=A1ximo=20Cuadros?= Date: Fri, 16 Dec 2016 21:53:40 +0100 Subject: [PATCH] README and examples progress --- README.md | 29 ++++++++++++++--------------- examples/README.md | 1 + examples/common_test.go | 1 + examples/progress/main.go | 32 ++++++++++++++++++++++++++++++++ 4 files changed, 48 insertions(+), 15 deletions(-) create mode 100644 examples/progress/main.go diff --git a/README.md b/README.md index c026a135f..26428cbd8 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # go-git [![GoDoc](https://godoc.org/gopkg.in/src-d/go-git.v4?status.svg)](https://godoc.org/gopkg.in/src-d/go-git.v4) [![Build Status](https://travis-ci.org/src-d/go-git.svg)](https://travis-ci.org/src-d/go-git) [![codecov.io](https://codecov.io/github/src-d/go-git/coverage.svg)](https://codecov.io/github/src-d/go-git) [![codebeat badge](https://codebeat.co/badges/b6cb2f73-9e54-483d-89f9-4b95a911f40c)](https://codebeat.co/projects/github-com-src-d-go-git) -A low level and highly extensible git implementation in **pure Go**. +A low level and highly extensible git implementation in **pure Go**. *go-git* aims to reach the completeness of [libgit2](https://libgit2.github.com/) or [jgit](http://www.eclipse.org/jgit/), nowadays covers the **majority** of the plumbing **read operations** and **some** of the main **write operations**, but lacks the main porcelain operations such as merges. @@ -12,7 +12,7 @@ The master branch represents the `v4` of the library, it is currently under acti If you are looking for a production ready version, please take a look to the [`v3`](https://github.com/src-d/go-git/tree/v3) which is being used in production at [source{d}](http://sourced.tech) since August 2015 to analyze all GitHub public repositories (i.e. 16M repositories). -We recommend the use of `v4` to develop new projects since it includes much new functionality and provides a more *idiomatic git* API +We recommend the use of `v4` to develop new projects since it includes much new functionality and provides a more *idiomatic git* API Installation ------------ @@ -29,7 +29,7 @@ Examples Cloning a repository and printing the history of HEAD, just like `git log` does -> Please note that the functions `CheckIfError` and `Inf`o used in the examples are from the [examples package](https://github.com/src-d/go-git/blob/master/examples/common.go#L17) just to be used in the examples. +> Please note that the functions `CheckIfError` and `Info` used in the examples are from the [examples package](https://github.com/src-d/go-git/blob/master/examples/common.go#L17) just to be used in the examples. ```go @@ -66,21 +66,20 @@ for _, c := range history { Outputs: ``` -commit 2275fa7d0c75d20103f90b0e1616937d5a9fc5e6 -Author: Máximo Cuadros -Date: 2015-10-23 00:44:33 +0200 +0200 +commit ded8054fd0c3994453e9c8aacaf48d118d42991e +Author: Santiago M. Mola +Date: Sat Nov 12 21:18:41 2016 +0100 -commit 35b585759cbf29f8ec428ef89da20705d59f99ec -Author: Carlos Cobo -Date: 2015-05-20 15:21:37 +0200 +0200 + index: ReadFrom/WriteTo returns IndexReadError/IndexWriteError. (#9) -commit 7e3259c191a9de23d88b6077dcb1cd427e925432 -Author: Alberto Cortés -Date: 2016-01-21 03:29:57 +0100 +0100 +commit df707095626f384ce2dc1a83b30f9a21d69b9dfc +Author: Santiago M. Mola +Date: Fri Nov 11 13:23:22 2016 +0100 -commit 24b8ae50db91f3909b11304014564bffc6fdee79 -Author: Alberto Cortés -Date: 2015-12-11 17:57:10 +0100 +0100 + readwriter: fix bug when writing index. (#10) + + When using ReadWriter on an existing siva file, absolute offset for + index entries was not being calculated correctly. ... ``` diff --git a/examples/README.md b/examples/README.md index 8762b4abe..334664f46 100644 --- a/examples/README.md +++ b/examples/README.md @@ -7,6 +7,7 @@ Here you can find a list of annotated _go-git_ examples: - [open](open/main.go) - Opening a existing repository cloned by _git_ - [clone](clone/main.go) - Cloning a repository - [remotes](remotes/main.go) - Working with remotes: adding, removing, etc +- [progress](progress/main.go) - Priting the progress information from the sideband ### Advanced - [custom_http](custom_http/main.go) - Replacing the HTTP client using a custom one diff --git a/examples/common_test.go b/examples/common_test.go index 1059f4bd8..e75b492af 100644 --- a/examples/common_test.go +++ b/examples/common_test.go @@ -18,6 +18,7 @@ var args = map[string][]string{ "showcase": []string{defaultURL}, "custom_http": []string{defaultURL}, "clone": []string{defaultURL, tempFolder()}, + "progress": []string{defaultURL, tempFolder()}, "open": []string{filepath.Join(cloneRepository(defaultURL, tempFolder()), ".git")}, } diff --git a/examples/progress/main.go b/examples/progress/main.go new file mode 100644 index 000000000..e0e4c1d7f --- /dev/null +++ b/examples/progress/main.go @@ -0,0 +1,32 @@ +package main + +import ( + "os" + + "gopkg.in/src-d/go-git.v4" + . "gopkg.in/src-d/go-git.v4/examples" +) + +func main() { + CheckArgs("", "") + url := os.Args[1] + directory := os.Args[2] + + r, err := git.NewFilesystemRepository(directory) + CheckIfError(err) + + // as git does, when you make a clone, pull or some other operations, the + // server sends information via the sideband, this information can being + // collected provinding a io.Writer to the repository + r.Progress = os.Stdout + + // Clone the given repository to the given directory + Info("git clone %s %s", url, directory) + + err = r.Clone(&git.CloneOptions{ + URL: url, + Depth: 1, + }) + + CheckIfError(err) +}