golang高效文件操作插件库gut/yos的使用

gut/yos是一个高效的Go语言文件操作库，提供了比标准库更简洁、更高效的API来处理文件和目录操作。下面我将介绍它的主要功能和使用方法。

安装

go get github.com/1set/gut/yos

主要功能

1. 文件操作

检查文件是否存在：

if yos.ExistFile("test.txt") {
    fmt.Println("文件存在")
}

创建文件：

if err := yos.CreateFile("newfile.txt"); err != nil {
    fmt.Println("创建文件失败:", err)
}

读取文件内容：

content, err := yos.ReadFile("test.txt")
if err != nil {
    fmt.Println("读取文件失败:", err)
} else {
    fmt.Println("文件内容:", string(content))
}

写入文件：

data := []byte("Hello, yos!")
if err := yos.WriteFile("test.txt", data); err != nil {
    fmt.Println("写入文件失败:", err)
}

追加内容到文件：

moreData := []byte("\nMore content")
if err := yos.AppendFile("test.txt", moreData); err != nil {
    fmt.Println("追加内容失败:", err)
}

2. 目录操作

创建目录：

if err := yos.MakeDir("newdir"); err != nil {
    fmt.Println("创建目录失败:", err)
}

递归创建目录：

if err := yos.MakeDirAll("path/to/nested/dir"); err != nil {
    fmt.Println("创建目录失败:", err)
}

列出目录内容：

entries, err := yos.ListDir(".")
if err != nil {
    fmt.Println("列出目录失败:", err)
} else {
    for _, entry := range entries {
        fmt.Println(entry.Name())
    }
}

3. 路径操作

获取绝对路径：

absPath, err := yos.AbsPath("test.txt")
if err != nil {
    fmt.Println("获取绝对路径失败:", err)
} else {
    fmt.Println("绝对路径:", absPath)
}

连接路径：

path := yos.JoinPath("dir", "subdir", "file.txt")
fmt.Println("连接后的路径:", path)

4. 高级操作

快速复制文件：

if err := yos.CopyFile("source.txt", "dest.txt"); err != nil {
    fmt.Println("复制文件失败:", err)
}

移动/重命名文件：

if err := yos.MoveFile("old.txt", "new.txt"); err != nil {
    fmt.Println("移动文件失败:", err)
}

删除文件或目录：

if err := yos.Remove("file_or_dir"); err != nil {
    fmt.Println("删除失败:", err)
}

递归删除目录：

if err := yos.RemoveAll("dir_to_delete"); err != nil {
    fmt.Println("递归删除失败:", err)
}

性能优势

gut/yos相比标准库的io/ioutil有更好的性能表现，特别是在处理大量小文件时。它通过以下方式优化：

1. 减少了不必要的系统调用
2. 使用更高效的缓冲区管理
3. 简化了常用操作的API

实际示例

下面是一个完整的示例，展示如何使用yos库处理文件：

package main

import (
	"fmt"
	"github.com/1set/gut/yos"
)

func main() {
	// 检查并创建目录
	dir := "data"
	if !yos.ExistDir(dir) {
		if err := yos.MakeDir(dir); err != nil {
			panic(fmt.Sprintf("无法创建目录 %s: %v", dir, err))
		}
	}

	// 创建并写入文件
	filePath := yos.JoinPath(dir, "log.txt")
	if !yos.ExistFile(filePath) {
		if err := yos.CreateFile(filePath); err != nil {
			panic(fmt.Sprintf("无法创建文件 %s: %v", filePath, err))
		}
	}

	// 写入内容
	content := []byte("日志开始\n")
	if err := yos.AppendFile(filePath, content); err != nil {
		panic(fmt.Sprintf("无法写入文件 %s: %v", filePath, err))
	}

	// 读取内容
	data, err := yos.ReadFile(filePath)
	if err != nil {
		panic(fmt.Sprintf("无法读取文件 %s: %v", filePath, err))
	}
	fmt.Printf("文件内容:\n%s", string(data))

	// 复制文件
	copyPath := yos.JoinPath(dir, "log_backup.txt")
	if err := yos.CopyFile(filePath, copyPath); err != nil {
		panic(fmt.Sprintf("无法复制文件: %v", err))
	}

	// 清理
	if err := yos.RemoveAll(dir); err != nil {
		panic(fmt.Sprintf("无法清理目录 %s: %v", dir, err))
	}
	fmt.Println("操作完成并已清理")
}

gut/yos是一个简单但功能强大的文件操作库，特别适合需要高效处理文件操作的Go项目。它的API设计简洁直观，减少了样板代码，同时提供了良好的性能表现。