source

type Node struct {
	// Entry is the file system entry information.
	Entry fs.DirEntry
	// Error indicates if there was an error processing this node.
	Error error
	// Info contains the parsed information about the file.
	Info parser.Info
	// Type indicates the type of node (media, subtitle, etc.).
	Type NodeType
	// Path is the original file or directory path.
	Path string
	// Responses holds metadata responses from provider.
	Response provider.Response
}

type NodeType int

type Options struct {
	ExcludeGlob  string // A glob pattern to exclude files or directories
	ExcludeRegex string // A regex pattern to exclude files or directories
	IncludeRegex string // A regex pattern to include files or directories
	MediaExts    []string
	SubtitleExts []string
	// TODO: add setting to prefer file name preference over parent directories when finding a match
	Recursive     bool   // Whether to scan directories recursively
	Query         string // Query override for metadata retrieval
	QueryLanguage string // Language code for metadata retrieval
	Language      string // Language code for destination names
	MinDepth      int    // Minimum directory depth to process
	MaxDepth      int    // Maximum directory depth to process
	// TODO: might be an options just for renaming and not sourcing
	SkipDirectories bool // Whether to skip processing directories themselves
	StripComponents int  // Number of leading path components to strip from source paths
	TitleRegex      string
}

type Source interface {
	// Scan processes the given path using the provided metadata providers and options,
	// returning a list of nodes that represent potential rename operations.
	Scan(string, []provider.Interface, Options) []Node
}