@backthread/extractor 0.1.0

package/dist/framework/python/analyze.d.ts

@@ -0,0 +1,38 @@
+import { type CollectedNodes } from './py-ast.js';
+import type { ImportFromNode, ImportNode } from '@zzzen/pyright-internal/dist/parser/parseNodes.js';
+import type { FrameworkContext } from '../types.js';
+/** A Python source file (module or stub). */
+export declare function isPythonFile(language: string): boolean;
+/** Is `fileId` within the adapter's matched root (rootPath '' = whole repo)? */
+export declare function inScope(fileId: string, rootPath: string): boolean;
+/**
+ * A file's `localName → target file id` import map, resolving module paths with
+ * the extractor's path-anchored, nested-root-aware `syntacticResolve` (consistent
+ * with /988). Handles `import a.b as c`, `from pkg import submod` (prefers
+ * the submodule file), and `from pkg import symbol` (the symbol's module file).
+ * The tricky, load-bearing piece every Python adapter needs for cross-module edges.
+ */
+export declare function buildImportBindings(fromId: string, imports: ReadonlyArray<ImportNode | ImportFromNode>, internalIds: ReadonlySet<string>, roots: readonly string[]): Map<string, string>;
+/** One in-scope Python file: its collected nodes + its import bindings. */
+export interface ParsedPythonFile {
+    nodes: CollectedNodes;
+    bindings: Map<string, string>;
+}
+/** The parsed in-scope Python surface an adapter analyzes. */
+export interface PythonScope {
+    /** In-scope Python file ids (from the graph, post-noise-filter). */
+    pyFiles: string[];
+    /** The resolution id set (all in-scope Python files). */
+    internalIds: ReadonlySet<string>;
+    /** Inferred first-party source roots (nested-package aware). */
+    roots: readonly string[];
+    /** fileId → parsed nodes + import bindings (unparseable files are omitted). */
+    parsed: Map<string, ParsedPythonFile>;
+}
+/**
+ * Parse every in-scope Python file once and build its import bindings — the
+ * common first step of every Python framework adapter's analysis. Reads source
+ * server-side (never-store-source); a file that can't be read/parsed is skipped.
+ */
+export declare function parsePythonScope(ctx: FrameworkContext): PythonScope;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/framework/python/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/framework/python/analyze.ts"],"names":[],"mappings":"AASA,OAAO,EAAiC,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EAEX,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,CAAC,UAAU,GAAG,cAAc,CAAC,EACnD,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAsCrB;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yDAAyD;IACzD,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,gEAAgE;IAChE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,+EAA+E;IAC/E,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,WAAW,CAqBnE"}

package/dist/framework/python/analyze.js

@@ -0,0 +1,98 @@
+// Shared Python framework-adapter core (+). The reusable helpers the
+// FastAPI adapter established, promoted so the Django / Flask / ORM /
+// Celery / … fleet share ONE cross-module resolver + ONE parse-scope setup
+// instead of each reinventing them. All install-free + deterministic (pure
+// syntactic Pyright parse via ./py-ast.js; never executes repo code).
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { inferSourceRoots, syntacticResolve } from '../../graph/python-adapter.js';
+import { collectNodes, parsePython, PN } from './py-ast.js';
+/** A Python source file (module or stub). */
+export function isPythonFile(language) {
+    return language === 'py' || language === 'pyi';
+}
+/** Is `fileId` within the adapter's matched root (rootPath '' = whole repo)? */
+export function inScope(fileId, rootPath) {
+    if (rootPath === '')
+        return true;
+    return fileId === rootPath || fileId.startsWith(`${rootPath}/`);
+}
+/**
+ * A file's `localName → target file id` import map, resolving module paths with
+ * the extractor's path-anchored, nested-root-aware `syntacticResolve` (consistent
+ * with /988). Handles `import a.b as c`, `from pkg import submod` (prefers
+ * the submodule file), and `from pkg import symbol` (the symbol's module file).
+ * The tricky, load-bearing piece every Python adapter needs for cross-module edges.
+ */
+export function buildImportBindings(fromId, imports, internalIds, roots) {
+    const map = new Map();
+    for (const imp of imports) {
+        if (imp.nodeType === PN.Import) {
+            // `import a.b.c as d` → d; `import a.b` → the top package name `a`. LIMITATION
+            // (accepted): a non-aliased `import a.b.c` binds only `a` (→ its __init__), so a
+            // later `a.b.c.x` access resolves imprecisely — rare; the `from … import x`
+            // forms below resolve exactly.
+            for (const entry of imp.d.list) {
+                const parts = entry.d.module.d.nameParts.map((p) => p.d.value);
+                if (parts.length === 0)
+                    continue;
+                const dotted = parts.join('.');
+                const local = entry.d.alias ? entry.d.alias.d.value : parts[0];
+                const target = entry.d.alias
+                    ? syntacticResolve(dotted, fromId, internalIds, roots)
+                    : syntacticResolve(parts[0], fromId, internalIds, roots);
+                if (target)
+                    map.set(local, target);
+            }
+            continue;
+        }
+        if (imp.nodeType !== PN.ImportFrom)
+            continue;
+        const from = imp;
+        const dots = '.'.repeat(from.d.module.d.leadingDots);
+        const body = from.d.module.d.nameParts.map((p) => p.d.value).join('.');
+        const modulePrefix = dots + body; // '' | 'app.api.routes' | '.routers' | '.'
+        for (const spec of from.d.imports) {
+            const imported = spec.d.name.d.value;
+            const local = spec.d.alias ? spec.d.alias.d.value : imported;
+            // Prefer the SUBMODULE resolution (`from app.api.routes import users` →
+            // users.py); fall back to the MODULE (`from …users import symbol` → users.py).
+            const submodule = modulePrefix ? `${modulePrefix}.${imported}` : imported;
+            const target = syntacticResolve(submodule, fromId, internalIds, roots) ??
+                (modulePrefix ? syntacticResolve(modulePrefix, fromId, internalIds, roots) : undefined);
+            if (target)
+                map.set(local, target);
+        }
+    }
+    return map;
+}
+/**
+ * Parse every in-scope Python file once and build its import bindings — the
+ * common first step of every Python framework adapter's analysis. Reads source
+ * server-side (never-store-source); a file that can't be read/parsed is skipped.
+ */
+export function parsePythonScope(ctx) {
+    const { repoDir, rootPath, graph } = ctx;
+    const pyFiles = graph.files
+        .filter((f) => isPythonFile(f.language) && inScope(f.id, rootPath))
+        .map((f) => f.id);
+    const internalIds = new Set(pyFiles);
+    const roots = inferSourceRoots(internalIds);
+    const parsed = new Map();
+    for (const id of pyFiles) {
+        let text;
+        try {
+            text = readFileSync(join(repoDir, id), 'utf8');
+        }
+        catch {
+            continue;
+        }
+        const tree = parsePython(text);
+        if (!tree)
+            continue;
+        const nodes = collectNodes(tree);
+        parsed.set(id, { nodes, bindings: buildImportBindings(id, nodes.imports, internalIds, roots) });
+    }
+    return { pyFiles, internalIds, roots, parsed };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/framework/python/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/framework/python/analyze.ts"],"names":[],"mappings":"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"}

package/dist/framework/python/py-ast.d.ts

@@ -0,0 +1,130 @@
+import type { AssignmentNode, BinaryOperationNode, CallNode, ClassNode, ExpressionNode, FunctionNode, ImportFromNode, ImportNode, ModuleNode, ParseNode, TypeAnnotationNode } from '@zzzen/pyright-internal/dist/parser/parseNodes.js';
+export declare const PN: {
+    readonly Assignment: 3;
+    readonly BinaryOperation: 7;
+    readonly Call: 9;
+    readonly Class: 10;
+    readonly Constant: 14;
+    readonly Dictionary: 18;
+    readonly DictionaryKeyEntry: 20;
+    readonly Import: 23;
+    readonly Index: 27;
+    readonly ImportFrom: 25;
+    readonly Function: 31;
+    readonly List: 34;
+    readonly MemberAccess: 35;
+    readonly Module: 36;
+    readonly Name: 38;
+    readonly StatementList: 47;
+    readonly StringList: 48;
+    readonly String: 49;
+    readonly TypeAnnotation: 54;
+};
+/** A repo file's collected top-level-relevant nodes (recursive — nested `if:`
+ *  blocks matter, e.g. an env-gated `include_router`). `classes` +
+ *  `typeAnnotations` were added for the ORM entity pass; `binaryOps`
+ * collects EVERY binary-operation node (a >> b, a << b, a + b, …) so
+ *  an adapter that reads operator wiring — the Airflow `a >> b` / `a << b`
+ *  task-dependency DSL — can interpret it without a second parse. Existing
+ *  consumers read only the fields they need, so each addition is backward-safe. */
+export interface CollectedNodes {
+    assignments: AssignmentNode[];
+    functions: FunctionNode[];
+    calls: CallNode[];
+    imports: (ImportNode | ImportFromNode)[];
+    classes: ClassNode[];
+    typeAnnotations: TypeAnnotationNode[];
+    binaryOps: BinaryOperationNode[];
+}
+/**
+ * Parse one Python file's text into a Pyright module node, or undefined on any
+ * parse failure (degrade-not-throw — one unparseable file must never sink the
+ * adapter). The `Module` node-type canary fails loud if the pinned enum drifts.
+ */
+export declare function parsePython(text: string): ModuleNode | undefined;
+/** Recursively collect assignments / functions / calls / imports from a module. */
+export declare function collectNodes(tree: ModuleNode): CollectedNodes;
+/** A Name node's identifier value, or undefined. */
+export declare function nameValue(n: ParseNode | undefined): string | undefined;
+/** A pure Name / MemberAccess chain → `{ root, path }` (`a.b.c` → root `a`, path
+ *  `['b','c']`); undefined if the expression isn't a plain dotted-name chain. */
+export declare function memberChain(n: ParseNode | undefined): {
+    root: string;
+    path: string[];
+} | undefined;
+/** The callee chain of a call expression (`x.include_router(...)` → root `x`,
+ *  path `['include_router']`); undefined for a non-dotted-name callee. */
+export declare function callCallee(call: CallNode): {
+    root: string;
+    path: string[];
+} | undefined;
+/** A call's callee, IF the whole callee is itself a call (`Foo()(...)`). */
+export declare function calleeCall(call: CallNode): CallNode | undefined;
+/** The concatenated value of a string-literal expression (adjacent literals
+ *  join; f-strings are skipped), or undefined if it isn't a plain string. */
+export declare function stringValue(expr: ExpressionNode | undefined): string | undefined;
+/** The value expression of a call's keyword argument `name=…`, or undefined. */
+export declare function keywordArg(call: CallNode, name: string): ExpressionNode | undefined;
+/** A call's positional argument value expressions, in order. */
+export declare function positionalArgs(call: CallNode): ExpressionNode[];
+/** The first string literal in a list-literal expression (`["users", …]` →
+ *  `'users'`), or undefined if it isn't a list or its first item isn't a string. */
+export declare function firstListString(expr: ExpressionNode | undefined): string | undefined;
+/** A class definition's name identifier, or undefined. */
+export declare function className(cls: ClassNode): string | undefined;
+/** A class's POSITIONAL base-class expressions as `{ root, path }` chains
+ *  (`class X(models.Model)` → `{ root:'models', path:['Model'] }`); keyword
+ *  arguments (`table=True`, `metaclass=…`) are excluded. Non-dotted-name bases
+ *  are dropped. */
+export declare function classBaseChains(cls: ClassNode): Array<{
+    root: string;
+    path: string[];
+}>;
+/** The value expression of a class's keyword argument `name=…` (`table=True`),
+ *  or undefined. */
+export declare function classKeywordArg(cls: ClassNode, name: string): ExpressionNode | undefined;
+/** Walk a class BODY (its suite) into the same collected-node shape — the
+ *  per-class attribute assignments / field calls / `Mapped[…]` annotations an
+ *  entity detector inspects. */
+export declare function collectClassBody(cls: ClassNode): CollectedNodes;
+/** The FunctionNodes declared DIRECTLY in a class body (its methods) — NOT nested
+ *  functions inside those methods, and unlike `collectClassBody().functions` which
+ *  recurses. Used by the GraphQL adapter to find field-resolver
+ *  methods without descending into their bodies. */
+export declare function classDirectFunctions(cls: ClassNode): FunctionNode[];
+/** The AssignmentNodes declared DIRECTLY in a class body (its class-level field
+ *  assignments, e.g. graphene's `user = graphene.Field(User)`) — NOT assignments
+ *  inside methods (which `collectClassBody().assignments` would include). Bare
+ *  annotations (`user: User` with no `=`) are not assignments and are excluded. */
+export declare function classDirectAssignments(cls: ClassNode): AssignmentNode[];
+/** The head of a (possibly subscripted) type expression as a `{ root, path }`
+ *  chain: `Mapped[list["X"]]` → the `Mapped` chain; a plain `Foo`/`a.Foo` → its
+ *  own chain. Undefined when the head isn't a dotted-name. */
+export declare function annotationChain(expr: ExpressionNode | undefined): {
+    root: string;
+    path: string[];
+} | undefined;
+/** The subscript argument value expressions of an index expression
+ *  (`Mapped[list["X"]]` → `[ list["X"] ]`), or `[]` when it isn't a subscript. */
+export declare function subscriptArgs(expr: ExpressionNode | undefined): ExpressionNode[];
+/** True iff `expr` is the boolean literal `True` (for `table=True`). */
+export declare function isTrueConstant(expr: ExpressionNode | undefined): boolean;
+/** A list-literal expression's item expressions (`[a, b.c, D()]` → the three
+ *  item nodes), or `[]` if it isn't a list. */
+export declare function listItems(expr: ExpressionNode | undefined): ExpressionNode[];
+/** The RHS value expression of a DIRECT class-body assignment (`class C: path =
+ *  "/x"` → the `"/x"` expr for name `'path'`), or undefined. Only the class's own
+ *  top-level body is inspected (not nested classes/methods); the first match wins. */
+export declare function classAttr(cls: ClassNode, name: string): ExpressionNode | undefined;
+/** The value of a DIRECT class-body STRING assignment (`class C: path = "/x"` →
+ *  `'/x'`), or undefined if absent / not a plain string literal. */
+export declare function classAttrString(cls: ClassNode, name: string): string | undefined;
+/** A dict literal's plain `key: value` entries, in source order (`{**spread}`
+ *  expand entries are skipped). Empty for a non-dict expression. The key/value
+ *  are raw expressions — resolve string keys/values with `stringValue`. Used by
+ *  the Celery adapter to read a `beat_schedule = {…}` config statically. */
+export declare function dictEntries(expr: ExpressionNode | undefined): Array<{
+    keyExpr: ExpressionNode;
+    valueExpr: ExpressionNode;
+}>;
+//# sourceMappingURL=py-ast.d.ts.map

package/dist/framework/python/py-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"py-ast.d.ts","sourceRoot":"","sources":["../../../src/framework/python/py-ast.ts"],"names":[],"mappings":"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"}

package/dist/framework/python/py-ast.js

@@ -0,0 +1,344 @@
+// minimal Pyright parse-tree helpers for the FastAPI adapter.
+//
+// Drives Pyright's PARSER ONLY — a pure, install-free SYNTACTIC parse of one
+// file's text (no Program, no binding, no type checker, no venv, no subprocess,
+// never executes repo code). This mirrors 's pure-static discipline and
+// reuses Pyright's own parser rather than a second grammar (the tree-sitter WASM
+// dead-end, ) — no native binary, so it runs identically local + in the
+// destroy-on-exit container.
+//
+// `ParseNodeType` is a `const enum` (erased from the .d.ts, and unimportable under
+// isolatedModules), so — exactly like 's `IMPORT_TYPE_LOCAL` — we PIN the
+// handful of node-type values we branch on. `parsePython()` asserts the module
+// node's type equals the pinned `Module`, a fail-loud canary if a future exactly-
+// pinned pyright bump ever renumbers the enum.
+import { Parser, ParseOptions } from '@zzzen/pyright-internal/dist/parser/parser.js';
+import { DiagnosticSink } from '@zzzen/pyright-internal/dist/common/diagnosticSink.js';
+import { ParseTreeWalker } from '@zzzen/pyright-internal/dist/analyzer/parseTreeWalker.js';
+// Pinned ParseNodeType values (parser/parseNodes.js). The dep is pinned EXACTLY,
+// so these are stable; the canary in parsePython() catches any drift.
+export const PN = {
+    Assignment: 3,
+    BinaryOperation: 7,
+    Call: 9,
+    Class: 10,
+    Constant: 14,
+    Dictionary: 18,
+    DictionaryKeyEntry: 20,
+    Import: 23,
+    Index: 27,
+    ImportFrom: 25,
+    Function: 31,
+    List: 34,
+    MemberAccess: 35,
+    Module: 36,
+    Name: 38,
+    StatementList: 47,
+    StringList: 48,
+    String: 49,
+    TypeAnnotation: 54,
+};
+// KeywordType values (tokenizerTypes.js) for the boolean constant literals — used
+// to read `table=True` (SQLModel) statically. Pinned like the ParseNodeType set.
+const KW_TRUE = 33;
+class NodeCollector extends ParseTreeWalker {
+    out = {
+        assignments: [],
+        functions: [],
+        calls: [],
+        imports: [],
+        classes: [],
+        typeAnnotations: [],
+        binaryOps: [],
+    };
+    visitAssignment(node) {
+        this.out.assignments.push(node);
+        return true;
+    }
+    visitFunction(node) {
+        this.out.functions.push(node);
+        return true;
+    }
+    visitCall(node) {
+        this.out.calls.push(node);
+        return true;
+    }
+    visitImport(node) {
+        this.out.imports.push(node);
+        return true;
+    }
+    visitImportFrom(node) {
+        this.out.imports.push(node);
+        return true;
+    }
+    visitClass(node) {
+        this.out.classes.push(node);
+        return true;
+    }
+    visitTypeAnnotation(node) {
+        this.out.typeAnnotations.push(node);
+        return true;
+    }
+    visitBinaryOperation(node) {
+        this.out.binaryOps.push(node);
+        return true;
+    }
+}
+/**
+ * Parse one Python file's text into a Pyright module node, or undefined on any
+ * parse failure (degrade-not-throw — one unparseable file must never sink the
+ * adapter). The `Module` node-type canary fails loud if the pinned enum drifts.
+ */
+export function parsePython(text) {
+    try {
+        const parser = new Parser();
+        const result = parser.parseSourceFile(text, new ParseOptions(), new DiagnosticSink());
+        const tree = result.parserOutput.parseTree;
+        if (!tree || tree.nodeType !== PN.Module) {
+            if (tree && tree.nodeType !== PN.Module) {
+                throw new Error(`Pyright ParseNodeType pin drift: module node is ${tree.nodeType}, expected ${PN.Module}`);
+            }
+            return undefined;
+        }
+        return tree;
+    }
+    catch (err) {
+        // A pin-drift canary is a real error worth surfacing; a genuine parse failure
+        // is expected noise. Re-throw the canary, swallow the rest.
+        if (err instanceof Error && err.message.startsWith('Pyright ParseNodeType pin drift'))
+            throw err;
+        return undefined;
+    }
+}
+/** Recursively collect assignments / functions / calls / imports from a module. */
+export function collectNodes(tree) {
+    const collector = new NodeCollector();
+    collector.walk(tree);
+    return collector.out;
+}
+// ---------------------------------------------------------------------------
+// Typed accessors (all guard on the pinned nodeType, so a wrong-shaped node
+// degrades to undefined rather than throwing).
+function isName(n) {
+    return !!n && n.nodeType === PN.Name;
+}
+function isMemberAccess(n) {
+    return !!n && n.nodeType === PN.MemberAccess;
+}
+function isCall(n) {
+    return !!n && n.nodeType === PN.Call;
+}
+/** A Name node's identifier value, or undefined. */
+export function nameValue(n) {
+    return isName(n) ? n.d.value : undefined;
+}
+/** A pure Name / MemberAccess chain → `{ root, path }` (`a.b.c` → root `a`, path
+ *  `['b','c']`); undefined if the expression isn't a plain dotted-name chain. */
+export function memberChain(n) {
+    if (isName(n))
+        return { root: n.d.value, path: [] };
+    if (isMemberAccess(n)) {
+        const base = memberChain(n.d.leftExpr);
+        if (!base)
+            return undefined;
+        return { root: base.root, path: [...base.path, n.d.member.d.value] };
+    }
+    return undefined;
+}
+/** The callee chain of a call expression (`x.include_router(...)` → root `x`,
+ *  path `['include_router']`); undefined for a non-dotted-name callee. */
+export function callCallee(call) {
+    return memberChain(call.d.leftExpr);
+}
+/** A call's callee, IF the whole callee is itself a call (`Foo()(...)`). */
+export function calleeCall(call) {
+    return isCall(call.d.leftExpr) ? call.d.leftExpr : undefined;
+}
+/** The concatenated value of a string-literal expression (adjacent literals
+ *  join; f-strings are skipped), or undefined if it isn't a plain string. */
+export function stringValue(expr) {
+    if (!expr)
+        return undefined;
+    if (expr.nodeType === PN.StringList) {
+        const parts = [];
+        for (const s of expr.d.strings) {
+            if (s.nodeType === PN.String)
+                parts.push(s.d.value);
+            else
+                return undefined; // an f-string component → not a static literal
+        }
+        return parts.join('');
+    }
+    if (expr.nodeType === PN.String)
+        return expr.d.value;
+    return undefined;
+}
+/** The value expression of a call's keyword argument `name=…`, or undefined. */
+export function keywordArg(call, name) {
+    for (const arg of call.d.args) {
+        if (arg.d.name && arg.d.name.d.value === name)
+            return arg.d.valueExpr;
+    }
+    return undefined;
+}
+/** A call's positional argument value expressions, in order. */
+export function positionalArgs(call) {
+    return call.d.args.filter((a) => !a.d.name).map((a) => a.d.valueExpr);
+}
+/** The first string literal in a list-literal expression (`["users", …]` →
+ *  `'users'`), or undefined if it isn't a list or its first item isn't a string. */
+export function firstListString(expr) {
+    if (!expr || expr.nodeType !== PN.List)
+        return undefined;
+    const items = expr.d.items;
+    return items.length > 0 ? stringValue(items[0]) : undefined;
+}
+// ---------------------------------------------------------------------------
+// Class + type-annotation accessors (the ORM entity pass; generic
+// Python-AST primitives, reusable by any class/annotation-driven adapter).
+/** A class definition's name identifier, or undefined. */
+export function className(cls) {
+    return nameValue(cls.d.name);
+}
+/** A class's POSITIONAL base-class expressions as `{ root, path }` chains
+ *  (`class X(models.Model)` → `{ root:'models', path:['Model'] }`); keyword
+ *  arguments (`table=True`, `metaclass=…`) are excluded. Non-dotted-name bases
+ *  are dropped. */
+export function classBaseChains(cls) {
+    const out = [];
+    for (const arg of cls.d.arguments) {
+        if (arg.d.name)
+            continue; // keyword arg, not a base
+        const chain = memberChain(arg.d.valueExpr);
+        if (chain)
+            out.push(chain);
+    }
+    return out;
+}
+/** The value expression of a class's keyword argument `name=…` (`table=True`),
+ *  or undefined. */
+export function classKeywordArg(cls, name) {
+    for (const arg of cls.d.arguments) {
+        if (arg.d.name && arg.d.name.d.value === name)
+            return arg.d.valueExpr;
+    }
+    return undefined;
+}
+/** Walk a class BODY (its suite) into the same collected-node shape — the
+ *  per-class attribute assignments / field calls / `Mapped[…]` annotations an
+ *  entity detector inspects. */
+export function collectClassBody(cls) {
+    const collector = new NodeCollector();
+    collector.walk(cls.d.suite);
+    return collector.out;
+}
+/** The FunctionNodes declared DIRECTLY in a class body (its methods) — NOT nested
+ *  functions inside those methods, and unlike `collectClassBody().functions` which
+ *  recurses. Used by the GraphQL adapter to find field-resolver
+ *  methods without descending into their bodies. */
+export function classDirectFunctions(cls) {
+    const out = [];
+    const suite = cls.d.suite;
+    if (!suite || !suite.d)
+        return out;
+    for (const stmt of suite.d.statements) {
+        if (stmt.nodeType === PN.Function)
+            out.push(stmt);
+    }
+    return out;
+}
+/** The AssignmentNodes declared DIRECTLY in a class body (its class-level field
+ *  assignments, e.g. graphene's `user = graphene.Field(User)`) — NOT assignments
+ *  inside methods (which `collectClassBody().assignments` would include). Bare
+ *  annotations (`user: User` with no `=`) are not assignments and are excluded. */
+export function classDirectAssignments(cls) {
+    const out = [];
+    const suite = cls.d.suite;
+    if (!suite || !suite.d)
+        return out;
+    for (const stmt of suite.d.statements) {
+        // Simple statements sit inside a StatementList line; class-body fields are
+        // assignments within those lines.
+        if (stmt.nodeType !== PN.StatementList)
+            continue;
+        for (const s of stmt.d.statements) {
+            if (s.nodeType === PN.Assignment)
+                out.push(s);
+        }
+    }
+    return out;
+}
+/** The head of a (possibly subscripted) type expression as a `{ root, path }`
+ *  chain: `Mapped[list["X"]]` → the `Mapped` chain; a plain `Foo`/`a.Foo` → its
+ *  own chain. Undefined when the head isn't a dotted-name. */
+export function annotationChain(expr) {
+    if (!expr)
+        return undefined;
+    if (expr.nodeType === PN.Index)
+        return memberChain(expr.d.leftExpr);
+    return memberChain(expr);
+}
+/** The subscript argument value expressions of an index expression
+ *  (`Mapped[list["X"]]` → `[ list["X"] ]`), or `[]` when it isn't a subscript. */
+export function subscriptArgs(expr) {
+    if (!expr || expr.nodeType !== PN.Index)
+        return [];
+    return expr.d.items.map((a) => a.d.valueExpr);
+}
+/** True iff `expr` is the boolean literal `True` (for `table=True`). */
+export function isTrueConstant(expr) {
+    return (!!expr &&
+        expr.nodeType === PN.Constant &&
+        expr.d.constType === KW_TRUE);
+}
+// ---------------------------------------------------------------------------
+// List + direct class-attribute accessors (Litestar's `route_handlers`
+// list + a Controller's class-body `path`/`tags`; generic, reusable primitives).
+/** A list-literal expression's item expressions (`[a, b.c, D()]` → the three
+ *  item nodes), or `[]` if it isn't a list. */
+export function listItems(expr) {
+    if (!expr || expr.nodeType !== PN.List)
+        return [];
+    return expr.d.items;
+}
+/** The RHS value expression of a DIRECT class-body assignment (`class C: path =
+ *  "/x"` → the `"/x"` expr for name `'path'`), or undefined. Only the class's own
+ *  top-level body is inspected (not nested classes/methods); the first match wins. */
+export function classAttr(cls, name) {
+    for (const stmt of cls.d.suite.d.statements) {
+        // Simple statements are wrapped in a StatementList; handle a bare Assignment too.
+        const assigns = stmt.nodeType === PN.StatementList
+            ? stmt.d.statements
+            : [stmt];
+        for (const inner of assigns) {
+            if (inner.nodeType !== PN.Assignment)
+                continue;
+            const a = inner;
+            if (nameValue(a.d.leftExpr) === name)
+                return a.d.rightExpr;
+        }
+    }
+    return undefined;
+}
+/** The value of a DIRECT class-body STRING assignment (`class C: path = "/x"` →
+ *  `'/x'`), or undefined if absent / not a plain string literal. */
+export function classAttrString(cls, name) {
+    return stringValue(classAttr(cls, name));
+}
+/** A dict literal's plain `key: value` entries, in source order (`{**spread}`
+ *  expand entries are skipped). Empty for a non-dict expression. The key/value
+ *  are raw expressions — resolve string keys/values with `stringValue`. Used by
+ *  the Celery adapter to read a `beat_schedule = {…}` config statically. */
+export function dictEntries(expr) {
+    if (!expr || expr.nodeType !== PN.Dictionary)
+        return [];
+    const out = [];
+    for (const item of expr.d.items) {
+        if (item.nodeType !== PN.DictionaryKeyEntry)
+            continue; // skip ** expand entries
+        const entry = item;
+        out.push({ keyExpr: entry.d.keyExpr, valueExpr: entry.d.valueExpr });
+    }
+    return out;
+}
+//# sourceMappingURL=py-ast.js.map

package/dist/framework/python/py-ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"py-ast.js","sourceRoot":"","sources":["../../../src/framework/python/py-ast.ts"],"names":[],"mappings":"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"}