forked from gitea/gitea
1
0
Fork 0
gitea/vendor/gopkg.in/src-d/go-billy.v4
Mura Li d77176912b Use Go1.11 module (#5743)
* Migrate to go modules

* make vendor

* Update mvdan.cc/xurls

* make vendor

* Update code.gitea.io/git

* make fmt-check

* Update github.com/go-sql-driver/mysql

* make vendor
2019-03-27 19:15:23 +08:00
..
helper Implement git refs API for listing references (branches, tags and other) (#5354) 2018-11-27 16:52:20 -05:00
osfs Implement git refs API for listing references (branches, tags and other) (#5354) 2018-11-27 16:52:20 -05:00
util Implement git refs API for listing references (branches, tags and other) (#5354) 2018-11-27 16:52:20 -05:00
.gitignore Use Go1.11 module (#5743) 2019-03-27 19:15:23 +08:00
.travis.yml Use Go1.11 module (#5743) 2019-03-27 19:15:23 +08:00
DCO Use Go1.11 module (#5743) 2019-03-27 19:15:23 +08:00
LICENSE Implement git refs API for listing references (branches, tags and other) (#5354) 2018-11-27 16:52:20 -05:00
MAINTAINERS Use Go1.11 module (#5743) 2019-03-27 19:15:23 +08:00
Makefile Use Go1.11 module (#5743) 2019-03-27 19:15:23 +08:00
README.md Use Go1.11 module (#5743) 2019-03-27 19:15:23 +08:00
appveyor.yml Use Go1.11 module (#5743) 2019-03-27 19:15:23 +08:00
fs.go Implement git refs API for listing references (branches, tags and other) (#5354) 2018-11-27 16:52:20 -05:00
go.mod Use Go1.11 module (#5743) 2019-03-27 19:15:23 +08:00
go.sum Use Go1.11 module (#5743) 2019-03-27 19:15:23 +08:00

README.md

go-billy GoDoc Build Status Build status codecov

The missing interface filesystem abstraction for Go. Billy implements an interface based on the os standard library, allowing to develop applications without dependency on the underlying storage. Makes it virtually free to implement mocks and testing over filesystem operations.

Billy was born as part of src-d/go-git project.

Installation

go get -u gopkg.in/src-d/go-billy.v4/...

Usage

Billy exposes filesystems using the Filesystem interface. Each filesystem implementation gives you a New method, whose arguments depend on the implementation itself, that returns a new Filesystem.

The following example caches in memory all readable files in a directory from any billy's filesystem implementation.

func LoadToMemory(origin billy.Filesystem, path string) (*memory.Memory, error) {
	memory := memory.New()

	files, err := origin.ReadDir("/")
	if err != nil {
		return nil, err
	}

	for _, file := range files {
		if file.IsDir() {
			continue
		}

		src, err := origin.Open(file.Name())
		if err != nil {
			return nil, err
		}

		dst, err := memory.Create(file.Name())
		if err != nil {
			return nil, err
		}

		if _, err = io.Copy(dst, src); err != nil {
			return nil, err
		}

		if err := dst.Close(); err != nil {
			return nil, err
		}

		if err := src.Close(); err != nil {
			return nil, err
		}
	}

	return memory, nil
}

Why billy?

The library billy deals with storage systems and Billy is the name of a well-known, IKEA bookcase. That's it.

License

Apache License Version 2.0, see LICENSE