python

func IsTestFile ¶

func IsTestFile(filePath string) bool

IsTestFile reports whether the given Python path is a test file.

func ResolvePythonAbsoluteImportPath ¶

func ResolvePythonAbsoluteImportPath(absSourcePath, importPath string, suppliedFiles map[string]bool) []string

ResolvePythonAbsoluteImportPath resolves an absolute Python package import (e.g. "dexter.tools.finance.api") to matching project files.

A bare absolute import names a module reachable from a sys.path root, not from just anywhere in the tree a file with a matching tail happens to live. Suffix matching alone can't tell "the real top-level urllib3" apart from "requests/packages/urllib3", a same-named vendored copy several levels deep -- both end in "/urllib3/__init__.py". The directory that would need to be on sys.path for a candidate to be valid (suppliedPath with the matched suffix removed) is checked for its own __init__.py: a real sys.path entry is a directory of packages, never a package itself, so a candidate whose would-be root has one is rejected.

func ResolvePythonImportPath ¶

func ResolvePythonImportPath(sourceFile, importPath string, suppliedFiles map[string]bool) []string

ResolvePythonImportPath resolves a Python import path to possible file paths.

A candidate matching sourceFile itself is never returned. This matters most for the bare-dots case (`from . import x` falling back to `.` when `x` isn't a real submodule, or a query scoped to fewer files than the whole project -- a single-file or single-commit `clarity show` -- simply doesn't have x's file in suppliedFiles even though it exists): resolving "." always means the enclosing package's own __init__.py, which is sourceFile itself whenever sourceFile IS that __init__.py. A file cannot depend on itself.

func ResolvePythonProjectImports ¶

func ResolvePythonProjectImports(
	absPath string,
	filePath string,
	ext string,
	suppliedFiles map[string]bool,
	contentReader vcs.ContentReader,
) ([]string, error)