fs

type Directory interface {
	Entry
	Readdir(ctx context.Context) (Entries, error)
	Summary() *DirectorySummary
}

type DirectorySummary struct {
	TotalFileSize    int64     `json:"size"`
	TotalFileCount   int64     `json:"files"`
	TotalDirCount    int64     `json:"dirs"`
	MaxModTime       time.Time `json:"maxTime"`
	IncompleteReason string    `json:"incomplete,omitempty"`
}

type Entries []Entry

type Entry interface {
	os.FileInfo
	Owner() OwnerInfo
}

type File interface {
	Entry
	Open(ctx context.Context) (Reader, error)
}

type OwnerInfo struct {
	UserID  uint32
	GroupID uint32
}

type Reader interface {
	io.ReadCloser
	io.Seeker

	Entry() (Entry, error)
}

type Symlink interface {
	Entry
	Readlink(ctx context.Context) (string, error)
}