File Discovery

Purpose

To reliably locate and filter Python source files for analysis, respecting project configuration and ignore patterns.

Requirements

Requirement: Recursive Discovery

The system SHALL accept file paths and directory arguments with recursive directory scanning.

Priority: Critical

Scenario: Analyzing a directory

• WHEN the user runs the linter on a directory

• THEN all Python files in that directory and subdirectories are found

Requirement: Ignore Patterns

The system SHALL honor .gitignore files by default.

Priority: Critical

Scenario: Ignoring files

• WHEN a file matches a .gitignore pattern

• THEN it is excluded from analysis