fs

Documentation

Index

• Constants
• Variables
• func CopyDir(src, dst string) error
• func CopyDirByMode(src, dst string, c mode) error
• func CopyFile(src, dst string) error
• func CopyFileByMode(src, dst string, c mode) error
• func CreatFileFromReader(filepath string, reader io.Reader) error
• func CreatFileFromReaderByMode(filepath string, reader io.Reader, c mode) error
• func Create(filepath string) (*os.File, error)
• func DirsDeDuplicate(dirs ...string) error
• func DirsDuplicateHandle(callback func(path1, path2 string) error, dirs ...string) error
• func DirsRangeDuplicateHandle(rangeCallback func(dir string, entry os.DirEntry) (error, bool), ...) error
• func DownloadFile(filepath string, reader io.Reader) error
• func DownloadFileByMode(filepath string, reader io.Reader, c mode) error
• func Exist(filepath string) bool
• func FindFile(path string) (string, error)
• func FindFiles(path string, deep int8, num int) ([]string, error)
• func FindFiles2(path string, deep int8, num int) ([]string, error)
• func GetFileCreateTime(path string) int64
• func GetMd5Name(name string) string
• func Inspect(dir string, file func(string, os.DirEntry) bool) error
• func IsExist(src string) bool
• func IsNotExist(src string) bool
• func IsPermission(src string) bool
• func LastFile(dir string) (os.FileInfo, map[string]os.FileInfo, error)
• func Md5(path string) (string, error)
• func Md5Equal(path1, path2 string) (bool, error)
• func Mkdir(src string) error
• func MkdirAll(src string) error
• func Move(src, dst string) error
• func MustOpen(filePath string) (*os.File, error)
• func NotExist(filepath string) bool
• func Open(filepath string) (*os.File, error)
• func OpenFile(filepath string, flag int, perm os.FileMode) (*os.File, error)
• func Range(dir string, callback FileRangeCallback) error
• func RangeDeep(dir string, callback FileRangeCallback, deep int) error
• func RangeDir(dir string, ...) error
• func RangeFile(dir string, callback FileRangeCallback) error
• func RangeFileDeep(dir string, callback FileRangeCallback, deep int) error
• func Sync(mainDir, slaveDir string) error
• func TwoDirDeDuplicate(dir1, dir2 string) error
• func TwoDirDuplicateHandle(dir1, dir2 string, callback func(path1, path2 string) error) error
• func Walk(root string, fn filepath.WalkFunc) error
• func WalkDir(root string, fn fs.WalkDirFunc) error
• func WalkDirFS(fsys fs.FS, root string, fn fs.WalkDirFunc) error
• func Write(data []byte, filename string) (n int, err error)
• func WriteBuffer(buf *bytes.Buffer, filename string) (n int, err error)
• type Dir
  • func (d Dir) Open(name string) (*os.File, error)
• type DirEntries
  • func (e DirEntries) Len() int
  • func (e DirEntries) Less(i, j int) bool
  • func (e DirEntries) Swap(i, j int)
• type FileRangeCallback
• type FileSize
  • func (f FileSize) MarshalText() ([]byte, error)
  • func (f *FileSize) UnmarshalText(text []byte) error
• type FileType
• type Visitor

Constants

const (
	Cover mode = iota
	SameNameSkip
	SameNameAndMd5Skip
)

const DownloadKey = ".downloading"

const PathSeparator = string(os.PathSeparator)

Variables

var FileTypeMap = map[string]FileType{
	".txt": Txt,
	".doc": Doc,
}

Functions

func CopyDir

func CopyDir(src, dst string) error

CopyDir 递归复制目录

func CopyDirByMode

func CopyDirByMode(src, dst string, c mode) error

CopyDirByMode 递归复制目录

func CopyFile

func CopyFile(src, dst string) error

CopyFile : General Approach

func CopyFileByMode

func CopyFileByMode(src, dst string, c mode) error

func CreatFileFromReader

func CreatFileFromReader(filepath string, reader io.Reader) error

func CreatFileFromReaderByMode

func CreatFileFromReaderByMode(filepath string, reader io.Reader, c mode) error

func Create

func Create(filepath string) (*os.File, error)

func DirsDeDuplicate

func DirsDeDuplicate(dirs ...string) error

去除目录中重复的文件,默认保留参数靠前目录中的文件

func DirsDuplicateHandle

func DirsDuplicateHandle(callback func(path1, path2 string) error, dirs ...string) error

func DirsRangeDuplicateHandle

func DirsRangeDuplicateHandle(rangeCallback func(dir string, entry os.DirEntry) (error, bool), duplicateCallback func(path1, path2 string) error, dirs ...string) error

DirsRangeDuplicateHandle rangeCallback 返回值为错误和是否继续

func DownloadFile

func DownloadFile(filepath string, reader io.Reader) error

func DownloadFileByMode

func DownloadFileByMode(filepath string, reader io.Reader, c mode) error

func Exist

func Exist(filepath string) bool

func FindFile

func FindFile(path string) (string, error)

path和filepath两个包，filepath文件专用

func FindFiles

func FindFiles(path string, deep int8, num int) ([]string, error)

func FindFiles2

func FindFiles2(path string, deep int8, num int) ([]string, error)

path和filepath两个包，filepath文件专用

func GetFileCreateTime

func GetFileCreateTime(path string) int64

func GetMd5Name

func GetMd5Name(name string) string

func Inspect

func Inspect(dir string, file func(string, os.DirEntry) bool) error

Inspect

func IsExist

func IsExist(src string) bool

func IsNotExist

func IsNotExist(src string) bool

func IsPermission

func IsPermission(src string) bool

func LastFile

func LastFile(dir string) (os.FileInfo, map[string]os.FileInfo, error)

LastFile 当前目录最后一个创建的文件

func Md5

func Md5(path string) (string, error)

func Md5Equal

func Md5Equal(path1, path2 string) (bool, error)

func Mkdir

func Mkdir(src string) error

func MkdirAll

func MkdirAll(src string) error

func Move

func Move(src, dst string) error

func MustOpen

func MustOpen(filePath string) (*os.File, error)

func NotExist

func NotExist(filepath string) bool

func Open

func Open(filepath string) (*os.File, error)

func OpenFile

func OpenFile(filepath string, flag int, perm os.FileMode) (*os.File, error)

func Range

func Range(dir string, callback FileRangeCallback) error

遍历根目录中的每个文件，为每个文件调用callback,包括文件夹,与filepath.WalkDir不同的是回调函数的参数不同,filepath.WalkDir的第一个参数是文件完整路径,RangeFile是文件所在目录的路径

func RangeDeep

func RangeDeep(dir string, callback FileRangeCallback, deep int) error

指定遍历深度,0为只遍历一层,-1为无限遍历

func RangeDir

func RangeDir(dir string, callback func(dir string, entries []os.DirEntry) ([]os.DirEntry, error)) error

RangeDir 遍历根目录中的每个文件夹，为文件夹中所有文件和目录的切片(os.ReadDir的返回)调用callback callback 需要处理每个文件夹下的所有文件和目录,返回值为需要递归遍历的目录和error 几乎每个文件夹下的文件夹都会被循环两次！

func RangeFile

func RangeFile(dir string, callback FileRangeCallback) error

遍历根目录中的每个文件，为每个文件调用callback,不包括文件夹,与filepath.WalkDir不同的是回调函数的参数不同,filepath.WalkDir的第一个参数是文件完整路径,RangeFile是文件所在目录的路径

func RangeFileDeep

func RangeFileDeep(dir string, callback FileRangeCallback, deep int) error

指定遍历深度,0为只遍历一层,-1为无限遍历

func Sync

func Sync(mainDir, slaveDir string) error

两个目录同步,第一个参数为主目录,参考目录,第二个参数目录与第一个保持一致

func TwoDirDeDuplicate

func TwoDirDeDuplicate(dir1, dir2 string) error

去除两个目录中重复的文件,默认保留第一个目录中的文件

func TwoDirDuplicateHandle

func TwoDirDuplicateHandle(dir1, dir2 string, callback func(path1, path2 string) error) error

func Walk

func Walk(root string, fn filepath.WalkFunc) error

func WalkDir

func WalkDir(root string, fn fs.WalkDirFunc) error

func WalkDirFS

func WalkDirFS(fsys fs.FS, root string, fn fs.WalkDirFunc) error

func Write

func Write(data []byte, filename string) (n int, err error)

func WriteBuffer

func WriteBuffer(buf *bytes.Buffer, filename string) (n int, err error)

Types

type Dir

type Dir string

func (Dir) Open

func (d Dir) Open(name string) (*os.File, error)

type DirEntries

type DirEntries []os.DirEntry

func (DirEntries) Len

func (e DirEntries) Len() int

func (DirEntries) Less

func (e DirEntries) Less(i, j int) bool

func (DirEntries) Swap

func (e DirEntries) Swap(i, j int)

type FileRangeCallback

type FileRangeCallback = func(dir string, entry os.DirEntry) error

type FileSize

type FileSize int64

func (FileSize) MarshalText

func (f FileSize) MarshalText() ([]byte, error)

MarshalText

func (*FileSize) UnmarshalText

func (f *FileSize) UnmarshalText(text []byte) error

UnMarshalText

type FileType

type FileType int

const (
	Unknown FileType = iota
	Txt
	Doc
	Docx
	Xls
	Xlsx
)

type Visitor

type Visitor interface {
	Visit(dir string, file os.DirEntry) (w Visitor)
}