stride

type AdvancedWalkFunc func(ctx context.Context, path string, info os.FileInfo, stats Stats) error

type ErrorHandling int

type ErrorHandlingMode string

type FilterOptions struct {
	MinSize             int64       // Minimum file size in bytes
	MaxSize             int64       // Maximum file size in bytes
	Pattern             string      // Glob pattern for matching files
	ExcludeDir          []string    // Directory patterns to exclude
	IncludeTypes        []string    // File extensions to include (e.g. ".txt", ".go")
	FileTypes           []string    // File types to include (file, dir, symlink)
	ExcludePattern      []string    // Patterns to exclude files
	ModifiedAfter       time.Time   // Only include files modified after
	ModifiedBefore      time.Time   // Only include files modified before
	AccessedAfter       time.Time   // Include files accessed after this time
	AccessedBefore      time.Time   // Include files accessed before this time
	CreatedAfter        time.Time   // Include files created after this time
	CreatedBefore       time.Time   // Include files created before this time
	MinPermissions      os.FileMode // Minimum file permissions (e.g. 0644)
	MaxPermissions      os.FileMode // Maximum file permissions (e.g. 0755)
	ExactPermissions    os.FileMode // Exact file permissions to match
	UseExactPermissions bool        // Whether to use exact permissions matching
	OwnerUID            int         // Filter by owner UID
	OwnerGID            int         // Filter by group GID
	OwnerName           string      // Filter by owner username
	GroupName           string      // Filter by group name
	MinDepth            int         // Minimum traversal depth
	MaxDepth            int         // Maximum traversal depth
	IncludeEmptyFiles   bool        // Include only empty files
	IncludeEmptyDirs    bool        // Include only empty directories
}

type FindHandler func(ctx context.Context, result FindResult) error

type FindMessage struct {
	Path      string            // Full path to the file
	Name      string            // Base name of the file
	Dir       string            // Directory containing the file
	Size      int64             // Size in bytes
	Time      time.Time         // Modification time
	IsDir     bool              // Whether the entry is a directory
	Metadata  map[string]string // File metadata
	Tags      map[string]string // File tags
	VersionID string            // Version identifier (if applicable)
}

type FindOptions struct {
	// Pattern matching options
	NamePattern   string         // Match by file name (supports wildcards)
	PathPattern   string         // Match by path (supports wildcards)
	IgnorePattern string         // Skip paths matching this pattern
	RegexPattern  *regexp.Regexp // Match by regular expression

	// Time-based filtering
	OlderThan time.Duration // Files older than this duration
	NewerThan time.Duration // Files newer than this duration

	// Size-based filtering
	LargerSize  int64 // Files larger than this size (bytes)
	SmallerSize int64 // Files smaller than this size (bytes)

	// Metadata and tag filtering
	MatchMeta map[string]*regexp.Regexp // Metadata key-value patterns to match
	MatchTags map[string]*regexp.Regexp // Tag key-value patterns to match

	// Execution options
	ExecCmd     string // Command to execute for each match
	PrintFormat string // Format string for output

	// Traversal options
	MaxDepth       uint // Maximum directory depth to traverse
	FollowSymlinks bool // Whether to follow symbolic links
	IncludeHidden  bool // Whether to include hidden files
	WithVersions   bool // Whether to include file versions

	// Watch options
	Watch       bool     // Whether to watch for changes
	WatchEvents []string // Events to watch for (create, modify, delete)
}

type FindResult struct {
	Message FindMessage
	Error   error
}

type LogLevel int

type MemoryLimit struct {
	SoftLimit int64 // Pause processing when reached
	HardLimit int64 // Stop processing when reached
}

type MemoryLimitOptions struct {
	SoftLimit int64
	HardLimit int64
}

type MiddlewareFunc func(next WalkFunc) WalkFunc

type ProgressFn func(stats Stats)

type Stats struct {
	FilesProcessed int64         // Number of files processed
	DirsProcessed  int64         // Number of directories processed
	EmptyDirs      int64         // Number of empty directories
	BytesProcessed int64         // Total bytes processed
	ErrorCount     int64         // Number of errors encountered
	ElapsedTime    time.Duration // Total time elapsed
	AvgFileSize    int64         // Average file size in bytes
	SpeedMBPerSec  float64       // Processing speed in MB/s
}

type SymlinkHandling int

type WalkFunc func(ctx context.Context, path string, info os.FileInfo) error

type WalkOptions struct {
	// Core options
	Context           context.Context   // Context for cancellation and deadlines
	ErrorHandling     ErrorHandling     // Legacy error handling mode
	ErrorHandlingMode ErrorHandlingMode // String-based error handling mode
	Filter            FilterOptions     // File filtering options

	// Progress monitoring
	Progress         ProgressFn        // Legacy progress function
	ProgressCallback func(stats Stats) // Enhanced progress callback

	// Logging and debug
	Logger   *zap.Logger // Structured logger
	LogLevel LogLevel    // Logging verbosity level
	DryRun   bool        // Simulate operations without executing

	// Performance tuning
	BufferSize  int // Size of internal buffers
	NumWorkers  int // Legacy worker count
	WorkerCount int // Enhanced worker count

	// Special handling
	SymlinkHandling SymlinkHandling    // How to handle symbolic links
	MemoryLimit     MemoryLimit        // Legacy memory limits
	MemoryLimits    MemoryLimitOptions // Enhanced memory limits

	// Extensibility
	Middleware []MiddlewareFunc // Middleware functions for customization
}