fileutil

func CalculateDirectorySize ¶ added in v0.47.0

func CalculateDirectorySize(dirPath string) int64

CalculateDirectorySize recursively calculates the total size of files in a directory.

func CopyFile ¶ added in v0.47.0

func CopyFile(src, dst string) error

CopyFile copies a file from src to dst using buffered IO.

func DirExists ¶ added in v0.47.0

func DirExists(path string) bool

DirExists checks if a directory exists.

func FileExists ¶ added in v0.47.0

func FileExists(path string) bool

FileExists checks if a file exists and is not a directory.

func IsDirEmpty ¶ added in v0.47.0

func IsDirEmpty(path string) bool

IsDirEmpty checks if a directory is empty.

func ValidateAbsolutePath ¶

func ValidateAbsolutePath(path string) (string, error)

ValidateAbsolutePath validates that a file path is absolute and safe to use. It performs the following security checks:

• Cleans the path using filepath.Clean to normalize . and .. components
• Verifies the path is absolute to prevent relative path traversal attacks

Returns the cleaned absolute path if validation succeeds, or an error if:

• The path is empty
• The path is relative (not absolute)

This function should be used before any file operations (read, write, stat, etc.) to ensure defense-in-depth security against path traversal vulnerabilities.

Example:

cleanPath, err := fileutil.ValidateAbsolutePath(userInputPath)

if err != nil {
   return fmt.Errorf("invalid path: %w", err)
}

content, err := os.ReadFile(cleanPath)