Method●Since v0.5

glob

glob(
    self,
    pattern: str,
    path: str | None = None,
) -> GlobResult

Parameters

Name	Type	Description
`pattern`*	`str`	Glob pattern to match files against (e.g., `'.py'`, `'/.txt'`, `'src/*/.py'`).
`path`	`str \| None`	Default:`None` Base directory to search from. Defaults to `root_dir` / `cwd`.

Find files matching a glob pattern.

Pattern matching uses the shared backend contract (same as grep include-glob):

Patterns without / match the basename at any depth under path (e.g. '*.py' matches nested files).
Patterns containing / match paths relative to path, with ** support. A leading / anchors to the search root.
Leading-dot names need an explicit leading . in the pattern segment. ** does not descend into dot-directories, so '*.yml' matches .github/workflows/ci.yml while '**/*.yml' does not.