Function pythonBindsLocally

src/resolution/name-matcher.ts:583–601

* Whether `name`, read at the ref, is bound by the calling function or one that * encloses it (parameter, assignment, loop, `as`, lambda, import) rather than * being the module global. With `importsBind` false, an import of the name is * not a shadow: it binds the same module the file imports.

(name: string, ref: UnresolvedRef, context: ResolutionContext, importsBind: boolean)

 * not a shadow: it binds the same module the file imports.
 */
function pythonBindsLocally(name: string, ref: UnresolvedRef, context: ResolutionContext, importsBind: boolean): boolean {
  const lines = pythonMemberLines(ref.filePath, context);
  const statements = pythonStatementStarts(ref.filePath, context);
  const param = new RegExp(`[(,]\\s*\\*{0,2}${name}\\s*[:=,)]`);
  const scopes = context.getNodesInFile(ref.filePath).filter(n =>
    (n.kind === 'function' || n.kind === 'method') && n.startLine <= ref.line && n.endLine >= ref.line)
    .sort((a, b) => b.startLine - a.startLine);
  for (const scope of scopes) {
    const own = pythonOwnLines(scope, ref.filePath, context);
    const bindings = own.flatMap(i => pythonLineBindings(lines, i, statements, name));
    if (bindings.some(b => b.kind === 'global')) return false;
    const def = own.find(i => /^\s*(?:async\s+)?def\b/.test(lines[i]!));
    let header = scope.signature ?? '';
    for (let j = def ?? lines.length; j < lines.length && (j === def || !statements[j]); j++) header += lines[j];
    if (param.test(header)) return true;
    if (bindings.some(b => b.kind !== 'global' && (b.kind !== 'import' || importsBind))) return true;
  }
  return false;
}

/** Distinct sources a file imports `name` from, at any scope (`from a import x` → `a:x`). */
function pythonImportKeys(name: string, filePath: string, context: ResolutionContext): Set<string> {