files

func AssertDir ¶

func AssertDir(path string) (err error)

func Close ¶

func Close(f *os.File) error

func CloseReadOnly ¶

func CloseReadOnly(f *os.File)

CloseReadOnly closes a read-only file descriptor, intentionally discarding the error. close(2) errors on read-only fds are about flushing writes (EIO, ENOSPC, EDQUOT) which cannot occur when no writes were performed. The fd is always freed on Linux and macOS regardless of the error. Go's own os.ReadFile uses this same pattern.

func CombinedOutput ¶

func CombinedOutput(c *exec.Cmd) ([]byte, error)

func Create ¶

func Create(s string) (f *os.File, err error)

func CreateExclusiveReadOnly ¶

func CreateExclusiveReadOnly(path string) (file *os.File, err error)

func CreateExclusiveWriteOnly ¶

func CreateExclusiveWriteOnly(p string) (f *os.File, err error)

func DirEntries ¶

func DirEntries(
	dirPath string,
) (dirEntries collections_slice.Slice[os.DirEntry], err error)

func DirNameWriterIgnoringHidden ¶

func DirNameWriterIgnoringHidden(
	seq interfaces.SeqError[string],
) interfaces.SeqError[string]

func DirNames ¶

func DirNames(dirPath string) (slice collections_slice.Slice[string], err error)

func DirNames2 ¶

func DirNames2(p string) interfaces.SeqError[os.DirEntry]

func DirNamesLevel2 ¶

func DirNamesLevel2(
	dirPath string,
) interfaces.SeqError[string]

func DirectoriesRelativeTo ¶

func DirectoriesRelativeTo(p string) []string

func Exists ¶

func Exists(path string) bool

func IsErrNotDirectory ¶

func IsErrNotDirectory(err error) bool

func MakeDirIfNecessary ¶

func MakeDirIfNecessary(
	base string,
	joinFunc func(string, ...string) string,
	pathComponents ...string,
) (path string, err error)

func MakeDirIfNecessaryForStringerWithHeadAndTail ¶

func MakeDirIfNecessaryForStringerWithHeadAndTail(
	stringer interfaces.StringerWithHeadAndTail,
	pathComponents ...string,
) (path string, err error)

func MakeDirNameWriterIgnoringHidden ¶

func MakeDirNameWriterIgnoringHidden(
	wf func(string) error,
) func(string) error

func MakeHashBucketPath ¶

func MakeHashBucketPath(
	hashBytes []byte,
	buckets []int,
	pathComponents ...string,
) string

func MakeHashBucketPathJoinFunc ¶

func MakeHashBucketPathJoinFunc(
	buckets []int,
) func(string, ...string) string

func Open ¶

func Open(s string) (f *os.File, err error)

func OpenCreate ¶

func OpenCreate(s string) (f *os.File, err error)

func OpenCreateWriteOnlyTruncate ¶

func OpenCreateWriteOnlyTruncate(s string) (f *os.File, err error)

func OpenExclusive ¶

func OpenExclusive(s string) (f *os.File, err error)

func OpenExclusiveReadOnly ¶

func OpenExclusiveReadOnly(s string) (f *os.File, err error)

func OpenExclusiveWriteOnly ¶

func OpenExclusiveWriteOnly(s string) (f *os.File, err error)

func OpenExclusiveWriteOnlyAppend ¶

func OpenExclusiveWriteOnlyAppend(s string) (f *os.File, err error)

func OpenExclusiveWriteOnlyTruncate ¶

func OpenExclusiveWriteOnlyTruncate(s string) (f *os.File, err error)

func OpenFile ¶

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

func OpenFiles ¶

func OpenFiles(p ...string) (err error)

func OpenReadOnly ¶

func OpenReadOnly(s string) (f *os.File, err error)

func OpenReadWrite ¶

func OpenReadWrite(s string) (f *os.File, err error)

func PathElements ¶

func PathElements(p string) []string

func PathFromHeadAndTail ¶

func PathFromHeadAndTail(
	stringer interfaces.StringerWithHeadAndTail,
	pathComponents ...string,
) string

func ReadAllString ¶

func ReadAllString(s ...string) (o string, err error)

func ReadDir ¶

func ReadDir(ps ...string) (dirEntries []os.DirEntry, err error)

func ReadDirNamesLevel2 ¶

func ReadDirNamesLevel2(
	wf func(string) error,
	p string,
) (err error)

func ReadDirNamesTo ¶

func ReadDirNamesTo(
	wf func(string) error,
	p string,
) (err error)

func Readlink ¶

func Readlink(path string) (string, error)

func Rename ¶

func Rename(src, dst string) (err error)

func SetAllowUserChanges ¶

func SetAllowUserChanges(paths ...string) (err error)

func SetAllowUserChangesRecursive ¶

func SetAllowUserChangesRecursive(paths ...string) (err error)

func SetDisallowUserChanges ¶

func SetDisallowUserChanges(paths ...string) (err error)

func TryOrMakeDirIfNecessary ¶

func TryOrMakeDirIfNecessary(
	path string,
	apply func(string) (*os.File, error),
) (file *os.File, err error)

func TryOrTimeout ¶

func TryOrTimeout(
	path string,
	timeout time.Duration,
	apply func(string) (*os.File, error),
	explainApply string,
) (*os.File, error)

func WalkDir ¶

func WalkDir(
	base string,
) interfaces.SeqError[WalkDirEntry]

func WalkDirIgnoreFuncHidden ¶

func WalkDirIgnoreFuncHidden(dirEntry WalkDirEntry) bool