2 files changed, 298 insertions, 0 deletions
diff --git a/examples/fs_implementation/main.go b/examples/fs_implementation/main.go
new file mode 100644
index 0000000..0371f7f
--- /dev/null
+++ b/examples/fs_implementation/main.go
@@ -0,0 +1,103 @@
+package main
+
+import (
+	"fmt"
+	"io"
+	"io/ioutil"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"gopkg.in/src-d/go-git.v3"
+	gogitFS "gopkg.in/src-d/go-git.v3/utils/fs"
+)
+
+func main() {
+	if len(os.Args) != 2 {
+		usage()
+		os.Exit(1)
+	}
+
+	fs := newFS(os.Args[1])
+
+	repo, err := git.NewRepositoryFromFS(fs, ".git")
+	if err != nil {
+		fmt.Fprint(os.Stderr, err)
+		os.Exit(1)
+	}
+
+	iter, err := repo.Commits()
+	if err != nil {
+		fmt.Fprint(os.Stderr, err)
+		os.Exit(1)
+	}
+	defer iter.Close()
+
+	for {
+		commit, err := iter.Next()
+		if err != nil {
+			if err == io.EOF {
+				break
+			}
+
+			fmt.Fprint(os.Stderr, err)
+			os.Exit(1)
+		}
+
+		fmt.Println(commit)
+	}
+}
+
+func usage() {
+	fmt.Fprintf(os.Stderr, "%s <path to .git dir>", os.Args[0])
+}
+
+// A simple proxy filesystem example: It mimics local filesystems, using
+// 'base' as its root and a funny path separator ("--").
+//
+// Example: when constructed with 'newFS("tmp")', a path like 'foo--bar'
+// will represent the local path "/tmp/foo/bar".
+type fs struct {
+	base string
+}
+
+const separator = "--"
+
+func newFS(path string) *fs {
+	return &fs{
+		base: path,
+	}
+}
+
+func (fs *fs) Stat(path string) (info os.FileInfo, err error) {
+	f, err := os.Open(fs.ToReal(path))
+	if err != nil {
+		return nil, err
+	}
+
+	defer func() {
+		errClose := f.Close()
+		if err == nil {
+			err = errClose
+		}
+	}()
+
+	return f.Stat()
+}
+
+func (fs *fs) ToReal(path string) string {
+	parts := strings.Split(path, separator)
+	return filepath.Join(fs.base, filepath.Join(parts...))
+}
+
+func (fs *fs) Open(path string) (gogitFS.ReadSeekCloser, error) {
+	return os.Open(fs.ToReal(path))
+}
+
+func (fs *fs) ReadDir(path string) ([]os.FileInfo, error) {
+	return ioutil.ReadDir(fs.ToReal(path))
+}
+
+func (fs *fs) Join(elem ...string) string {
+	return strings.Join(elem, separator)
+}
diff --git a/examples/fs_implementation/main_test.go b/examples/fs_implementation/main_test.go
new file mode 100644
index 0000000..4f138c2
--- /dev/null
+++ b/examples/fs_implementation/main_test.go
@@ -0,0 +1,195 @@
+package main
+
+import (
+	"io/ioutil"
+	"os"
+	"path/filepath"
+	"reflect"
+	"regexp"
+	"testing"
+
+	"github.com/alcortesm/tgz"
+)
+
+func TestMain(m *testing.M) {
+	setUp()
+	rval := m.Run()
+	tearDown()
+	os.Exit(rval)
+}
+
+func setUp() {
+	var err error
+	repo, err = tgz.Extract("../../storage/seekable/internal/gitdir/fixtures/spinnaker-gc.tgz")
+	if err != nil {
+		panic(err)
+	}
+}
+
+var repo string
+
+func tearDown() {
+	err := os.RemoveAll(repo)
+	if err != nil {
+		panic(err)
+	}
+}
+
+func TestJoin(t *testing.T) {
+	fs := newFS("")
+	for i, test := range [...]struct {
+		input    []string
+		expected string
+	}{
+		{
+			input:    []string{},
+			expected: "",
+		}, {
+			input:    []string{"a"},
+			expected: "a",
+		}, {
+			input:    []string{"a", "b"},
+			expected: "a--b",
+		}, {
+			input:    []string{"a", "b", "c"},
+			expected: "a--b--c",
+		},
+	} {
+		obtained := fs.Join(test.input...)
+		if obtained != test.expected {
+			t.Fatalf("test %d:\n\tinput = %v\n\tobtained = %v\n\texpected = %v\n",
+				i, test.input, obtained, test.expected)
+		}
+	}
+}
+
+func TestStat(t *testing.T) {
+	fs := newFS(filepath.Join(repo, ".git/"))
+	for i, path := range [...]string{
+		"index",
+		"info--refs",
+		"objects--pack--pack-584416f86235cac0d54bfabbdc399fb2b09a5269.pack",
+	} {
+		real, err := os.Open(fs.ToReal(path))
+		if err != nil {
+			t.Fatalf("test %d: openning real: %s", err)
+		}
+
+		expected, err := real.Stat()
+		if err != nil {
+			t.Fatalf("test %d: stat on real: %s", err)
+		}
+
+		obtained, err := fs.Stat(path)
+		if err != nil {
+			t.Fatalf("test %d: fs.Stat unexpected error: %s", i, err)
+		}
+
+		if !reflect.DeepEqual(obtained, expected) {
+			t.Fatalf("test %d:\n\tinput = %s\n\tobtained = %v\n\texpected = %v\n",
+				i, path, obtained, expected)
+		}
+
+		err = real.Close()
+		if err != nil {
+			t.Fatalf("test %d: closing real: %s", i, err)
+		}
+	}
+}
+
+func TestStatErrors(t *testing.T) {
+	fs := newFS(filepath.Join(repo, ".git/"))
+	for i, test := range [...]struct {
+		input     string
+		errRegExp string
+	}{
+		{
+			input:     "bla",
+			errRegExp: ".*bla: no such file or directory",
+		}, {
+			input:     "bla--foo",
+			errRegExp: ".*bla/foo: no such file or directory",
+		},
+	} {
+		expected := regexp.MustCompile(test.errRegExp)
+
+		_, err := fs.Stat(test.input)
+		if err == nil {
+			t.Fatalf("test %d: no error returned", i)
+		}
+		if !expected.MatchString(err.Error()) {
+			t.Fatalf("test %d: error missmatch\n\tobtained = %q\n\texpected regexp = %q\n",
+				i, err.Error(), test.errRegExp)
+		}
+	}
+}
+
+func TestOpen(t *testing.T) {
+	fs := newFS(filepath.Join(repo, ".git/"))
+	for i, path := range [...]string{
+		"index",
+		"info--refs",
+		"objects--pack--pack-584416f86235cac0d54bfabbdc399fb2b09a5269.pack",
+	} {
+		real, err := os.Open(fs.ToReal(path))
+		if err != nil {
+			t.Fatalf("test %d: openning real: %s", err)
+		}
+
+		realData, err := ioutil.ReadAll(real)
+		if err != nil {
+			t.Fatal("test %d: ioutil.ReadAll on real: %s", err)
+		}
+
+		err = real.Close()
+		if err != nil {
+			t.Fatal("test %d: closing real: %s", err)
+		}
+
+		obtained, err := fs.Open(path)
+		if err != nil {
+			t.Fatalf("test %d: fs.Open unexpected error: %s", i, err)
+		}
+
+		obtainedData, err := ioutil.ReadAll(obtained)
+		if err != nil {
+			t.Fatal("test %d: ioutil.ReadAll on obtained: %s", err)
+		}
+
+		err = obtained.Close()
+		if err != nil {
+			t.Fatal("test %d: closing obtained: %s", err)
+		}
+
+		if !reflect.DeepEqual(obtainedData, realData) {
+			t.Fatalf("test %d:\n\tinput = %s\n\tobtained = %v\n\texpected = %v\n",
+				i, path, obtainedData, realData)
+		}
+	}
+}
+
+func TestReadDir(t *testing.T) {
+	fs := newFS(filepath.Join(repo, ".git/"))
+	for i, path := range [...]string{
+		"info",
+		".",
+		"",
+		"objects",
+		"objects--pack",
+	} {
+		expected, err := ioutil.ReadDir(fs.ToReal(path))
+		if err != nil {
+			t.Fatalf("test %d: real ReadDir: %s", err)
+		}
+
+		obtained, err := fs.ReadDir(path)
+		if err != nil {
+			t.Fatalf("test %d: fs.ReadDir unexpected error: %s", i, err)
+		}
+
+		if !reflect.DeepEqual(obtained, expected) {
+			t.Fatalf("test %d:\n\tinput = %s\n\tobtained = %v\n\texpected = %v\n",
+				i, path, obtained, expected)
+		}
+	}
+}