path: root/storage/filesystem/storage.go

// Package filesystem is a storage backend base on filesystems
package filesystem

import (
	"gopkg.in/src-d/go-git.v4/storage/filesystem/dotgit"

	"gopkg.in/src-d/go-billy.v4"
)

// Storage is an implementation of git.Storer that stores data on disk in the
// standard git format (this is, the .git directory). Zero values of this type
// are not safe to use, see the NewStorage function below.
type Storage struct {
	StorageOptions

	fs  billy.Filesystem
	dir *dotgit.DotGit

	ObjectStorage
	ReferenceStorage
	IndexStorage
	ShallowStorage
	ConfigStorage
	ModuleStorage
}

// StorageOptions holds configuration for the storage.
type StorageOptions struct {
	// Static means that the filesystem is not modified while the repo is open.
	Static bool
}

// NewStorage returns a new Storage backed by a given `fs.Filesystem`
func NewStorage(fs billy.Filesystem) (*Storage, error) {
	return NewStorageWithOptions(fs, StorageOptions{})
}

// NewStorageWithOptions returns a new Storage backed by a given `fs.Filesystem`
func NewStorageWithOptions(
	fs billy.Filesystem,
	ops StorageOptions,
) (*Storage, error) {
	dOps := dotgit.DotGitOptions{
		Static: ops.Static,
	}

	dir := dotgit.NewWithOptions(fs, dOps)
	o, err := NewObjectStorage(dir)
	if err != nil {
		return nil, err
	}

	return &Storage{
		StorageOptions: ops,
		fs:             fs,
		dir:            dir,

		ObjectStorage:    o,
		ReferenceStorage: ReferenceStorage{dir: dir},
		IndexStorage:     IndexStorage{dir: dir},
		ShallowStorage:   ShallowStorage{dir: dir},
		ConfigStorage:    ConfigStorage{dir: dir},
		ModuleStorage:    ModuleStorage{dir: dir},
	}, nil
}

// Filesystem returns the underlying filesystem
func (s *Storage) Filesystem() billy.Filesystem {
	return s.fs
}

func (s *Storage) Init() error {
	return s.dir.Initialize()
}