afero

package
v1.8.3 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 10, 2022 License: Apache-2.0 Imports: 19 Imported by: 0

Documentation

Index

Constants

View Source 
const BADFD = afero.BADFD
View Source 
const FilePathSeparator = afero.FilePathSeparator

Variables

View Source 
var ErrDestinationExists = afero.ErrDestinationExists
View Source 
var ErrFileClosed = afero.ErrFileClosed
View Source 
var ErrFileExists = afero.ErrFileExists
View Source 
var ErrFileNotFound = afero.ErrFileNotFound
View Source 
var ErrNoReadlink = afero.ErrNoReadlink
View Source 
var ErrNoSymlink = afero.ErrNoSymlink
View Source 
var ErrOutOfRange = afero.ErrOutOfRange
View Source 
var ErrTooLarge = afero.ErrTooLarge
View Source 
var NewOsFs = afero.NewOsFs

Functions

func DirExists 

func DirExists(fs Fs, path string) (bool, error)

DirExists checks if a path exists and is a directory.

func Exists 

func Exists(fs Fs, path string) (bool, error)

Check if a file or directory exists.

func FileContainsAnyBytes 

func FileContainsAnyBytes(fs Fs, filename string, subslices [][]byte) (bool, error)

Check if a file contains any of the specified byte slices.

func FileContainsBytes 

func FileContainsBytes(fs Fs, filename string, subslice []byte) (bool, error)

Check if a file contains a specified byte slice.

func FullBaseFsPath 

func FullBaseFsPath(basePathFs *BasePathFs, relativePath string) string

func GetTempDir 

func GetTempDir(fs Fs, subPath string) string

GetTempDir returns the default temp directory with trailing slash if subPath is not empty then it will be created recursively with mode 777 rwx rwx rwx

func Glob 

func Glob(fs Fs, pattern string) (matches []string, err error)

Glob returns the names of all files matching pattern or nil if there is no matching file. The syntax of patterns is the same as in Match. The pattern may describe hierarchical names such as /usr/*/bin/ed (assuming the Separator is '/').

Glob ignores file system errors such as I/O errors reading directories. The only possible returned error is ErrBadPattern, when pattern is malformed.

This was adapted from (http://golang.org/pkg/path/filepath) and uses several built-ins from that package.

func IsDir 

func IsDir(fs Fs, path string) (bool, error)

IsDir checks if a given path is a directory.

func IsEmpty 

func IsEmpty(fs Fs, path string) (bool, error)

IsEmpty checks if a given file or directory is empty.

func NeuterAccents 

func NeuterAccents(s string) string

Transform characters with accents into plain forms.

func ReadAll 

func ReadAll(r io.Reader) ([]byte, error)

ReadAll reads from r until an error or EOF and returns the data it read. A successful call returns err == nil, not err == EOF. Because ReadAll is defined to read from src until EOF, it does not treat an EOF from Read as an error to be reported.

func ReadDir 

func ReadDir(fs Fs, dirname string) ([]os.FileInfo, error)

func ReadFile 

func ReadFile(fs Fs, filename string) ([]byte, error)

func SafeWriteReader 

func SafeWriteReader(fs Fs, path string, r io.Reader) (err error)

func TempDir 

func TempDir(fs Fs, dir, prefix string) (name string, err error)

func UnicodeSanitize 

func UnicodeSanitize(s string) string

Rewrite string to remove non-standard path characters

func Walk 

func Walk(fs Fs, root string, walkFn filepath.WalkFunc) error

func WriteFile 

func WriteFile(fs Fs, filename string, data []byte, perm os.FileMode) error

func WriteReader 

func WriteReader(fs Fs, path string, r io.Reader) (err error)

Types

type Afero 

type Afero struct {
	Fs
}

func (Afero) DirExists 

func (a Afero) DirExists(path string) (bool, error)

func (Afero) Exists 

func (a Afero) Exists(path string) (bool, error)

func (Afero) FileContainsAnyBytes 

func (a Afero) FileContainsAnyBytes(filename string, subslices [][]byte) (bool, error)

func (Afero) FileContainsBytes 

func (a Afero) FileContainsBytes(filename string, subslice []byte) (bool, error)

func (Afero) GetTempDir 

func (a Afero) GetTempDir(subPath string) string

func (Afero) IsDir 

func (a Afero) IsDir(path string) (bool, error)

func (Afero) IsEmpty 

func (a Afero) IsEmpty(path string) (bool, error)

func (Afero) ReadDir 

func (a Afero) ReadDir(dirname string) ([]os.FileInfo, error)

ReadDir reads the directory named by dirname and returns a list of sorted directory entries.

func (Afero) ReadFile 

func (a Afero) ReadFile(filename string) ([]byte, error)

ReadFile reads the file named by filename and returns the contents. A successful call returns err == nil, not err == EOF. Because ReadFile reads the whole file, it does not treat an EOF from Read as an error to be reported.

func (Afero) SafeWriteReader 

func (a Afero) SafeWriteReader(path string, r io.Reader) (err error)

Same as WriteReader but checks to see if file/directory already exists.

func (Afero) TempDir 

func (a Afero) TempDir(dir, prefix string) (name string, err error)

TempDir creates a new temporary directory in the directory dir with a name beginning with prefix and returns the path of the new directory. If dir is the empty string, TempDir uses the default directory for temporary files (see os.TempDir). Multiple programs calling TempDir simultaneously will not choose the same directory. It is the caller's responsibility to remove the directory when no longer needed.

func (Afero) TempFile 

func (a Afero) TempFile(dir, pattern string) (f File, err error)

TempFile creates a new temporary file in the directory dir, opens the file for reading and writing, and returns the resulting *os.File. The filename is generated by taking pattern and adding a random string to the end. If pattern includes a "*", the random string replaces the last "*". If dir is the empty string, TempFile uses the default directory for temporary files (see os.TempDir). Multiple programs calling TempFile simultaneously will not choose the same file. The caller can use f.Name() to find the pathname of the file. It is the caller's responsibility to remove the file when no longer needed.

func (Afero) Walk 

func (a Afero) Walk(root string, walkFn filepath.WalkFunc) error

func (Afero) WriteFile 

func (a Afero) WriteFile(filename string, data []byte, perm os.FileMode) error

WriteFile writes data to a file named by filename. If the file does not exist, WriteFile creates it with permissions perm; otherwise WriteFile truncates it before writing.

func (Afero) WriteReader 

func (a Afero) WriteReader(path string, r io.Reader) (err error)

Takes a reader and a path and writes the content

type BasePathFile 

type BasePathFile struct {
	File
	// contains filtered or unexported fields
}

func (*BasePathFile) Name 

func (f *BasePathFile) Name() string

type BasePathFs 

type BasePathFs struct {
	// contains filtered or unexported fields
}

The BasePathFs restricts all operations to a given path within an Fs. The given file name to the operations on this Fs will be prepended with the base path before calling the base Fs. Any file name (after filepath.Clean()) outside this base path will be treated as non existing file.

Note that it does not clean the error messages on return, so you may reveal the real path on errors.

func (*BasePathFs) Chmod 

func (b *BasePathFs) Chmod(name string, mode os.FileMode) (err error)

func (*BasePathFs) Chown 

func (b *BasePathFs) Chown(name string, uid, gid int) (err error)

func (*BasePathFs) Chtimes 

func (b *BasePathFs) Chtimes(name string, atime, mtime time.Time) (err error)

func (*BasePathFs) Create 

func (b *BasePathFs) Create(name string) (f File, err error)

func (*BasePathFs) LstatIfPossible 

func (b *BasePathFs) LstatIfPossible(name string) (os.FileInfo, bool, error)

func (*BasePathFs) Mkdir 

func (b *BasePathFs) Mkdir(name string, mode os.FileMode) (err error)

func (*BasePathFs) MkdirAll 

func (b *BasePathFs) MkdirAll(name string, mode os.FileMode) (err error)

func (*BasePathFs) Name 

func (b *BasePathFs) Name() string

func (*BasePathFs) Open 

func (b *BasePathFs) Open(name string) (f File, err error)

func (*BasePathFs) OpenFile 

func (b *BasePathFs) OpenFile(name string, flag int, mode os.FileMode) (f File, err error)

func (*BasePathFs) ReadlinkIfPossible 

func (b *BasePathFs) ReadlinkIfPossible(name string) (string, error)

func (*BasePathFs) RealPath 

func (b *BasePathFs) RealPath(name string) (path string, err error)

on a file outside the base path it returns the given file name and an error, else the given file with the base path prepended

func (*BasePathFs) Remove 

func (b *BasePathFs) Remove(name string) (err error)

func (*BasePathFs) RemoveAll 

func (b *BasePathFs) RemoveAll(name string) (err error)

func (*BasePathFs) Rename 

func (b *BasePathFs) Rename(oldname, newname string) (err error)

func (*BasePathFs) Stat 

func (b *BasePathFs) Stat(name string) (fi os.FileInfo, err error)

func (*BasePathFs) SymlinkIfPossible 

func (b *BasePathFs) SymlinkIfPossible(oldname, newname string) error

type CacheOnReadFs 

type CacheOnReadFs struct {
	// contains filtered or unexported fields
}

If the cache duration is 0, cache time will be unlimited, i.e. once a file is in the layer, the base will never be read again for this file.

For cache times greater than 0, the modification time of a file is checked. Note that a lot of file system implementations only allow a resolution of a second for timestamps... or as the godoc for os.Chtimes() states: "The underlying filesystem may truncate or round the values to a less precise time unit."

This caching union will forward all write calls also to the base file system first. To prevent writing to the base Fs, wrap it in a read-only filter - Note: this will also make the overlay read-only, for writing files in the overlay, use the overlay Fs directly, not via the union Fs.

func (*CacheOnReadFs) Chmod 

func (u *CacheOnReadFs) Chmod(name string, mode os.FileMode) error

func (*CacheOnReadFs) Chown 

func (u *CacheOnReadFs) Chown(name string, uid, gid int) error

func (*CacheOnReadFs) Chtimes 

func (u *CacheOnReadFs) Chtimes(name string, atime, mtime time.Time) error

func (*CacheOnReadFs) Create 

func (u *CacheOnReadFs) Create(name string) (File, error)

func (*CacheOnReadFs) Mkdir 

func (u *CacheOnReadFs) Mkdir(name string, perm os.FileMode) error

func (*CacheOnReadFs) MkdirAll 

func (u *CacheOnReadFs) MkdirAll(name string, perm os.FileMode) error

func (*CacheOnReadFs) Name 

func (u *CacheOnReadFs) Name() string

func (*CacheOnReadFs) Open 

func (u *CacheOnReadFs) Open(name string) (File, error)

func (*CacheOnReadFs) OpenFile 

func (u *CacheOnReadFs) OpenFile(name string, flag int, perm os.FileMode) (File, error)

func (*CacheOnReadFs) Remove 

func (u *CacheOnReadFs) Remove(name string) error

func (*CacheOnReadFs) RemoveAll 

func (u *CacheOnReadFs) RemoveAll(name string) error

func (*CacheOnReadFs) Rename 

func (u *CacheOnReadFs) Rename(oldname, newname string) error

func (*CacheOnReadFs) Stat 

func (u *CacheOnReadFs) Stat(name string) (os.FileInfo, error)

type CopyOnWriteFs 

type CopyOnWriteFs struct {
	// contains filtered or unexported fields
}

The CopyOnWriteFs is a union filesystem: a read only base file system with a possibly writeable layer on top. Changes to the file system will only be made in the overlay: Changing an existing file in the base layer which is not present in the overlay will copy the file to the overlay ("changing" includes also calls to e.g. Chtimes(), Chmod() and Chown()).

Reading directories is currently only supported via Open(), not OpenFile().

func (*CopyOnWriteFs) Chmod 

func (u *CopyOnWriteFs) Chmod(name string, mode os.FileMode) error

func (*CopyOnWriteFs) Chown 

func (u *CopyOnWriteFs) Chown(name string, uid, gid int) error

func (*CopyOnWriteFs) Chtimes 

func (u *CopyOnWriteFs) Chtimes(name string, atime, mtime time.Time) error

func (*CopyOnWriteFs) Create 

func (u *CopyOnWriteFs) Create(name string) (File, error)

func (*CopyOnWriteFs) LstatIfPossible 

func (u *CopyOnWriteFs) LstatIfPossible(name string) (os.FileInfo, bool, error)

func (*CopyOnWriteFs) Mkdir 

func (u *CopyOnWriteFs) Mkdir(name string, perm os.FileMode) error

func (*CopyOnWriteFs) MkdirAll 

func (u *CopyOnWriteFs) MkdirAll(name string, perm os.FileMode) error

func (*CopyOnWriteFs) Name 

func (u *CopyOnWriteFs) Name() string

func (*CopyOnWriteFs) Open 

func (u *CopyOnWriteFs) Open(name string) (File, error)

This function handles the 9 different possibilities caused by the union which are the intersection of the following... 

layer: doesn't exist, exists as a file, and exists as a directory
base:  doesn't exist, exists as a file, and exists as a directory

func (*CopyOnWriteFs) OpenFile 

func (u *CopyOnWriteFs) OpenFile(name string, flag int, perm os.FileMode) (File, error)

func (*CopyOnWriteFs) ReadlinkIfPossible 

func (u *CopyOnWriteFs) ReadlinkIfPossible(name string) (string, error)

func (*CopyOnWriteFs) Remove 

func (u *CopyOnWriteFs) Remove(name string) error

Removing files present only in the base layer is not permitted. If a file is present in the base layer and the overlay, only the overlay will be removed.

func (*CopyOnWriteFs) RemoveAll 

func (u *CopyOnWriteFs) RemoveAll(name string) error

func (*CopyOnWriteFs) Rename 

func (u *CopyOnWriteFs) Rename(oldname, newname string) error

Renaming files present only in the base layer is not permitted

func (*CopyOnWriteFs) Stat 

func (u *CopyOnWriteFs) Stat(name string) (os.FileInfo, error)

func (*CopyOnWriteFs) SymlinkIfPossible 

func (u *CopyOnWriteFs) SymlinkIfPossible(oldname, newname string) error

type DirsMerger 

type DirsMerger = afero.DirsMerger

type File 

type File = afero.File

func TempFile 

func TempFile(fs Fs, dir, pattern string) (f File, err error)

type FromIOFS 

type FromIOFS struct {
	fs.FS
}

FromIOFS adopts io/fs.FS to use it as afero.Fs Note that io/fs.FS is read-only so all mutating methods will return fs.PathError with fs.ErrPermission To store modifications you may use afero.CopyOnWriteFs

func (FromIOFS) Chmod 

func (f FromIOFS) Chmod(name string, mode os.FileMode) error

func (FromIOFS) Chown 

func (f FromIOFS) Chown(name string, uid, gid int) error

func (FromIOFS) Chtimes 

func (f FromIOFS) Chtimes(name string, atime time.Time, mtime time.Time) error

func (FromIOFS) Create 

func (f FromIOFS) Create(name string) (File, error)

func (FromIOFS) Mkdir 

func (f FromIOFS) Mkdir(name string, perm os.FileMode) error

func (FromIOFS) MkdirAll 

func (f FromIOFS) MkdirAll(path string, perm os.FileMode) error

func (FromIOFS) Name 

func (f FromIOFS) Name() string

func (FromIOFS) Open 

func (f FromIOFS) Open(name string) (File, error)

func (FromIOFS) OpenFile 

func (f FromIOFS) OpenFile(name string, flag int, perm os.FileMode) (File, error)

func (FromIOFS) Remove 

func (f FromIOFS) Remove(name string) error

func (FromIOFS) RemoveAll 

func (f FromIOFS) RemoveAll(path string) error

func (FromIOFS) Rename 

func (f FromIOFS) Rename(oldname, newname string) error

func (FromIOFS) Stat 

func (f FromIOFS) Stat(name string) (os.FileInfo, error)

type Fs 

type Fs = afero.Fs

func NewBasePathFs 

func NewBasePathFs(source Fs, path string) Fs

func NewCacheOnReadFs 

func NewCacheOnReadFs(base Fs, layer Fs, cacheTime time.Duration) Fs

func NewCopyOnWriteFs 

func NewCopyOnWriteFs(base Fs, layer Fs) Fs

func NewReadOnlyFs 

func NewReadOnlyFs(source Fs) Fs

func NewRegexpFs 

func NewRegexpFs(source Fs, re *regexp.Regexp) Fs

type IOFS 

type IOFS struct {
	Fs
}

IOFS adopts afero.Fs to stdlib io/fs.FS

func NewIOFS 

func NewIOFS(fs Fs) IOFS

func (IOFS) Glob 

func (iofs IOFS) Glob(pattern string) ([]string, error)

func (IOFS) Open 

func (iofs IOFS) Open(name string) (fs.File, error)

func (IOFS) ReadDir 

func (iofs IOFS) ReadDir(name string) ([]fs.DirEntry, error)

func (IOFS) ReadFile 

func (iofs IOFS) ReadFile(name string) ([]byte, error)

func (IOFS) Sub 

func (iofs IOFS) Sub(dir string) (fs.FS, error)

type LinkReader 

type LinkReader = afero.LinkReader

type Linker 

type Linker = afero.Linker

type Lstater 

type Lstater = afero.Lstater

type OsFs 

type OsFs = afero.OsFs

type ReadOnlyFs 

type ReadOnlyFs struct {
	// contains filtered or unexported fields
}

func (*ReadOnlyFs) Chmod 

func (r *ReadOnlyFs) Chmod(n string, m os.FileMode) error

func (*ReadOnlyFs) Chown 

func (r *ReadOnlyFs) Chown(n string, uid, gid int) error

func (*ReadOnlyFs) Chtimes 

func (r *ReadOnlyFs) Chtimes(n string, a, m time.Time) error

func (*ReadOnlyFs) Create 

func (r *ReadOnlyFs) Create(n string) (File, error)

func (*ReadOnlyFs) LstatIfPossible 

func (r *ReadOnlyFs) LstatIfPossible(name string) (os.FileInfo, bool, error)

func (*ReadOnlyFs) Mkdir 

func (r *ReadOnlyFs) Mkdir(n string, p os.FileMode) error

func (*ReadOnlyFs) MkdirAll 

func (r *ReadOnlyFs) MkdirAll(n string, p os.FileMode) error

func (*ReadOnlyFs) Name 

func (r *ReadOnlyFs) Name() string

func (*ReadOnlyFs) Open 

func (r *ReadOnlyFs) Open(n string) (File, error)

func (*ReadOnlyFs) OpenFile 

func (r *ReadOnlyFs) OpenFile(name string, flag int, perm os.FileMode) (File, error)

func (*ReadOnlyFs) ReadDir 

func (r *ReadOnlyFs) ReadDir(name string) ([]os.FileInfo, error)

func (*ReadOnlyFs) ReadlinkIfPossible 

func (r *ReadOnlyFs) ReadlinkIfPossible(name string) (string, error)

func (*ReadOnlyFs) Remove 

func (r *ReadOnlyFs) Remove(n string) error

func (*ReadOnlyFs) RemoveAll 

func (r *ReadOnlyFs) RemoveAll(p string) error

func (*ReadOnlyFs) Rename 

func (r *ReadOnlyFs) Rename(o, n string) error

func (*ReadOnlyFs) Stat 

func (r *ReadOnlyFs) Stat(name string) (os.FileInfo, error)

func (*ReadOnlyFs) SymlinkIfPossible 

func (r *ReadOnlyFs) SymlinkIfPossible(oldname, newname string) error

type RegexpFile 

type RegexpFile struct {
	// contains filtered or unexported fields
}

func (*RegexpFile) Close 

func (f *RegexpFile) Close() error

func (*RegexpFile) Name 

func (f *RegexpFile) Name() string

func (*RegexpFile) Read 

func (f *RegexpFile) Read(s []byte) (int, error)

func (*RegexpFile) ReadAt 

func (f *RegexpFile) ReadAt(s []byte, o int64) (int, error)

func (*RegexpFile) Readdir 

func (f *RegexpFile) Readdir(c int) (fi []os.FileInfo, err error)

func (*RegexpFile) Readdirnames 

func (f *RegexpFile) Readdirnames(c int) (n []string, err error)

func (*RegexpFile) Seek 

func (f *RegexpFile) Seek(o int64, w int) (int64, error)

func (*RegexpFile) Stat 

func (f *RegexpFile) Stat() (os.FileInfo, error)

func (*RegexpFile) Sync 

func (f *RegexpFile) Sync() error

func (*RegexpFile) Truncate 

func (f *RegexpFile) Truncate(s int64) error

func (*RegexpFile) Write 

func (f *RegexpFile) Write(s []byte) (int, error)

func (*RegexpFile) WriteAt 

func (f *RegexpFile) WriteAt(s []byte, o int64) (int, error)

func (*RegexpFile) WriteString 

func (f *RegexpFile) WriteString(s string) (int, error)

type RegexpFs 

type RegexpFs struct {
	// contains filtered or unexported fields
}

The RegexpFs filters files (not directories) by regular expression. Only files matching the given regexp will be allowed, all others get a ENOENT error ( "No such file or directory").

func (*RegexpFs) Chmod 

func (r *RegexpFs) Chmod(name string, mode os.FileMode) error

func (*RegexpFs) Chown 

func (r *RegexpFs) Chown(name string, uid, gid int) error

func (*RegexpFs) Chtimes 

func (r *RegexpFs) Chtimes(name string, a, m time.Time) error

func (*RegexpFs) Create 

func (r *RegexpFs) Create(name string) (File, error)

func (*RegexpFs) Mkdir 

func (r *RegexpFs) Mkdir(n string, p os.FileMode) error

func (*RegexpFs) MkdirAll 

func (r *RegexpFs) MkdirAll(n string, p os.FileMode) error

func (*RegexpFs) Name 

func (r *RegexpFs) Name() string

func (*RegexpFs) Open 

func (r *RegexpFs) Open(name string) (File, error)

func (*RegexpFs) OpenFile 

func (r *RegexpFs) OpenFile(name string, flag int, perm os.FileMode) (File, error)

func (*RegexpFs) Remove 

func (r *RegexpFs) Remove(name string) error

func (*RegexpFs) RemoveAll 

func (r *RegexpFs) RemoveAll(p string) error

func (*RegexpFs) Rename 

func (r *RegexpFs) Rename(oldname, newname string) error

func (*RegexpFs) Stat 

func (r *RegexpFs) Stat(name string) (os.FileInfo, error)

type Symlinker 

type Symlinker = afero.Symlinker

type UnionFile 

type UnionFile = afero.UnionFile

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.