@descryy/adapter-python 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,117 @@
+/**
+ * HTTP calls made *from* Python — the caller half of the contract join.
+ *
+ * ```
+ *   API_ROUTE ──SERVES_API──▶ API_ENDPOINT ◀──USES_API── caller
+ * ```
+ *
+ * `routes.ts` produces the provider half. This produces the consumer half, and
+ * until it existed `adapter-python` declared no `USES_API` at all, so golden
+ * pattern 08 was skipped rather than passed — declared incapacity, per DEC-043.
+ *
+ * ## What counts as evidence
+ *
+ * **Provenance, never the name.** `requests.get(...)` is only an HTTP call when
+ * `requests` resolves, through this file's own import table, to the `requests`
+ * package. A local object called `requests`, or a `client.get()` on something
+ * this reader cannot trace, is not one — and `client.get()` is the single most
+ * common false positive available here, because every Django and Flask test
+ * suite in existence calls `client.get("/orders/1")` on a **test client** that
+ * makes no HTTP request at all. A census of the reference set found 1,970 such
+ * call sites in `django` and 310 in `flask`, against **one** file in either that
+ * imports `requests`. Matching on the verb name would have produced 2,280 edges
+ * to endpoints nothing serves.
+ *
+ * ## What is refused
+ *
+ * A path that is not a literal or an f-string · a path that is not
+ * repository-relative, which is an outbound call to somebody else's service and
+ * has no route on this side of the join · a `request()` whose verb is not a
+ * literal. Each is a ledger row.
+ */
+import type { PyCall } from "./extract.ts";
+/** The packages whose module-level verbs are HTTP calls. */
+export declare const CLIENT_MODULES: ReadonlySet<string>;
+/** Constructors whose result is a reusable client bound to a local. */
+export declare const SESSION_CONSTRUCTORS: ReadonlySet<string>;
+/** Verb methods, by the name the package exports. */
+export declare const CLIENT_VERBS: ReadonlyMap<string, string>;
+export interface ClientCall {
+    readonly file: string;
+    readonly line: number;
+    readonly method: string;
+    /** The path, normalised to `{param}` for every interpolation. */
+    readonly path: string;
+    /** As written, for the ledger and for an adjudicator. */
+    readonly rawPath: string;
+    readonly scope: readonly string[];
+    /** `requests.get`, `session.post` — what the call site wrote. */
+    readonly client: string;
+}
+export interface ClientRefusal {
+    readonly file: string;
+    readonly line: number;
+    readonly rawTarget: string;
+    readonly reason: "callPathNotLiteral" | "callPathNotRelative" | "callMethodNotLiteral" | "callBaseUnresolved" | "callBaseIsExternalHost" | "callPathFromLocal";
+    /** DEC-242's `attrs.blockedBy` — the literal blocking expression, or `null`. */
+    readonly blockedBy: string | null;
+    /** DEC-242's `attrs.refusalClass` — `undefined` means unclassified, never askable. */
+    readonly refusalClass: BaseRefusalClass | "out-of-scope" | undefined;
+    /**
+     * Diagnostic only, not part of DEC-242 — see `adapter-rust/src/client.ts`'s
+     * own doc for what this is and why it is not shipped as part of the
+     * contract. Present only on the generic fallthrough of `diagnoseArgument`.
+     */
+    readonly argumentKind?: "field" | "call" | "concatenation" | "other";
+}
+export type BaseRefusalClass = "value-unknown" | "varies-per-call" | "capability-gap";
+/**
+ * An f-string whose first element is an interpolation: `f"{BASE}/orders/{id}"`.
+ *
+ * **This is the shape a Python service actually writes**, and until this was
+ * added the reader refused every one of them as "not a literal". Counted across
+ * five reference repositories: 283 module-level `requests`/`httpx` verb calls,
+ * of which **not one** takes a repository-relative literal and **78** take this
+ * form. The extractor was built for a shape the corpus does not contain, and no
+ * precision draw could have said so — there were no edges to sample.
+ *
+ * Returns the base expression as written and the remainder as a template. The
+ * remainder must begin with `/`, because `f"{base}orders"` is a base whose own
+ * trailing slash decides the path and this reader cannot see it.
+ */
+export declare function assemblyOfSource(raw: string): {
+    base: string;
+    suffix: string;
+} | undefined;
+/**
+ * A path argument's source text as a template, or `undefined`.
+ *
+ * `f"/orders/{order_id}"` becomes `/orders/{param}`, which is what
+ * `normaliseEndpointPath` produces from the provider's `/orders/{order_id}` —
+ * the two must agree or the join does not happen. `{{` is an escaped brace and
+ * is not an interpolation.
+ *
+ * Deliberately narrow: one string, no implicit concatenation, no `%` or
+ * `.format()`. Each of those is a path assembled somewhere else, and a template
+ * guessed from half of it is an endpoint that does not exist.
+ */
+export declare function templateOfSource(raw: string): string | undefined;
+/**
+ * Locals holding a session or client constructed from one of these packages.
+ *
+ * `s = requests.Session()` and `c = httpx.Client()`. The construction is the
+ * evidence; a local *called* `session` is not.
+ */
+export declare function clientLocalsIn(calls: readonly PyCall[], localOfCall: (call: PyCall) => string | undefined, moduleOfImport: (name: string) => string | undefined): Map<string, string>;
+/** Every HTTP call written in one file, and every one refused. */
+export declare function clientCallsIn(file: string, calls: readonly PyCall[], moduleOfImport: (name: string) => string | undefined, clientLocals: ReadonlyMap<string, string>, 
+/** Module-scope `NAME = "literal"` in this file, for base resolution. */
+constants?: ReadonlyMap<string, string>, 
+/** `scope::name` -> source text, for a path assembled a few lines earlier. */
+localStrings?: ReadonlyMap<string, string>, 
+/** `scope.join(".")` -> parameter names, for DEC-242's varies-per-call. */
+functionParams?: ReadonlyMap<string, ReadonlySet<string>>): {
+    readonly calls: ClientCall[];
+    readonly refusals: ClientRefusal[];
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,347 @@
+/**
+ * HTTP calls made *from* Python — the caller half of the contract join.
+ *
+ * ```
+ *   API_ROUTE ──SERVES_API──▶ API_ENDPOINT ◀──USES_API── caller
+ * ```
+ *
+ * `routes.ts` produces the provider half. This produces the consumer half, and
+ * until it existed `adapter-python` declared no `USES_API` at all, so golden
+ * pattern 08 was skipped rather than passed — declared incapacity, per DEC-043.
+ *
+ * ## What counts as evidence
+ *
+ * **Provenance, never the name.** `requests.get(...)` is only an HTTP call when
+ * `requests` resolves, through this file's own import table, to the `requests`
+ * package. A local object called `requests`, or a `client.get()` on something
+ * this reader cannot trace, is not one — and `client.get()` is the single most
+ * common false positive available here, because every Django and Flask test
+ * suite in existence calls `client.get("/orders/1")` on a **test client** that
+ * makes no HTTP request at all. A census of the reference set found 1,970 such
+ * call sites in `django` and 310 in `flask`, against **one** file in either that
+ * imports `requests`. Matching on the verb name would have produced 2,280 edges
+ * to endpoints nothing serves.
+ *
+ * ## What is refused
+ *
+ * A path that is not a literal or an f-string · a path that is not
+ * repository-relative, which is an outbound call to somebody else's service and
+ * has no route on this side of the join · a `request()` whose verb is not a
+ * literal. Each is a ledger row.
+ */
+/** The packages whose module-level verbs are HTTP calls. */
+export const CLIENT_MODULES = new Set(["requests", "httpx", "aiohttp"]);
+/** Constructors whose result is a reusable client bound to a local. */
+export const SESSION_CONSTRUCTORS = new Set([
+    "Session",
+    "Client",
+    "AsyncClient",
+    "ClientSession",
+]);
+/** Verb methods, by the name the package exports. */
+export const CLIENT_VERBS = new Map([
+    ["get", "GET"],
+    ["post", "POST"],
+    ["put", "PUT"],
+    ["patch", "PATCH"],
+    ["delete", "DELETE"],
+    ["head", "HEAD"],
+    ["options", "OPTIONS"],
+]);
+const CAPABILITY_GAP = { blockedBy: null, refusalClass: "capability-gap" };
+const VARIES_PER_CALL = { blockedBy: null, refusalClass: "varies-per-call" };
+/** `os.environ["X"]`/`os.environ['X']`, `os.environ.get("X")`, `os.getenv("X")`. */
+const ENV_READ_PATTERNS = [
+    /^os\.environ\[\s*['"][^'"]*['"]\s*\]$/,
+    /^os\.environ\.get\(\s*['"][^'"]*['"].*\)$/,
+    /^os\.getenv\(\s*['"][^'"]*['"].*\)$/,
+];
+/** Same heuristic as every other adapter's — see `adapter-rust/src/client.ts`'s doc. */
+function argumentKindOf(text) {
+    if (text.endsWith(")") && text.includes("("))
+        return "call";
+    if (text.includes("+"))
+        return "concatenation";
+    if (/^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)*$/.test(text))
+        return "field";
+    return "other";
+}
+/**
+ * Why an argument (a direct path argument, or an f-string's interpolated
+ * base) could not be read as a literal — a bare identifier that is the
+ * enclosing function's own parameter, a known environment-read expression,
+ * or something this reader does not trace.
+ */
+function diagnoseArgument(text, parameterNames) {
+    if (text === undefined)
+        return CAPABILITY_GAP;
+    const trimmed = text.trim();
+    if (/^[A-Za-z_][A-Za-z0-9_]*$/.test(trimmed) && parameterNames.has(trimmed))
+        return VARIES_PER_CALL;
+    if (ENV_READ_PATTERNS.some((pattern) => pattern.test(trimmed))) {
+        return { blockedBy: trimmed, refusalClass: "value-unknown" };
+    }
+    return { ...CAPABILITY_GAP, argumentKind: argumentKindOf(trimmed) };
+}
+/**
+ * An f-string whose first element is an interpolation: `f"{BASE}/orders/{id}"`.
+ *
+ * **This is the shape a Python service actually writes**, and until this was
+ * added the reader refused every one of them as "not a literal". Counted across
+ * five reference repositories: 283 module-level `requests`/`httpx` verb calls,
+ * of which **not one** takes a repository-relative literal and **78** take this
+ * form. The extractor was built for a shape the corpus does not contain, and no
+ * precision draw could have said so — there were no edges to sample.
+ *
+ * Returns the base expression as written and the remainder as a template. The
+ * remainder must begin with `/`, because `f"{base}orders"` is a base whose own
+ * trailing slash decides the path and this reader cannot see it.
+ */
+export function assemblyOfSource(raw) {
+    const text = raw.trim();
+    const match = /^[rRbB]*[fF][rRbB]*("""|'''|"|')([\s\S]*)\1$/.exec(text);
+    if (match === null)
+        return undefined;
+    const body = match[2];
+    if (body.includes("\n") || !body.startsWith("{"))
+        return undefined;
+    const close = body.indexOf("}");
+    if (close < 0)
+        return undefined;
+    const base = body.slice(1, close).trim();
+    // A format spec or conversion (`{x!r}`, `{x:>10}`) is not a name this reader
+    // can resolve, and neither is an expression with a call in it.
+    if (base === "" || /[!:(]/.test(base))
+        return undefined;
+    const rest = templateOfSource(`f"${body.slice(close + 1)}"`);
+    if (rest === undefined || !rest.startsWith("/"))
+        return undefined;
+    return { base, suffix: rest };
+}
+/** `https://host/api` -> `/api`; `/api` -> `/api`; anything else -> undefined. */
+function pathOfBase(value) {
+    if (value.startsWith("/"))
+        return { path: value.replace(/\/$/, ""), external: false };
+    const url = /^[a-zA-Z][\w+.-]*:\/\/[^/]+(\/.*)?$/.exec(value);
+    if (url === null)
+        return undefined;
+    return { path: (url[1] ?? "").replace(/\/$/, ""), external: true };
+}
+/**
+ * A path argument's source text as a template, or `undefined`.
+ *
+ * `f"/orders/{order_id}"` becomes `/orders/{param}`, which is what
+ * `normaliseEndpointPath` produces from the provider's `/orders/{order_id}` —
+ * the two must agree or the join does not happen. `{{` is an escaped brace and
+ * is not an interpolation.
+ *
+ * Deliberately narrow: one string, no implicit concatenation, no `%` or
+ * `.format()`. Each of those is a path assembled somewhere else, and a template
+ * guessed from half of it is an endpoint that does not exist.
+ */
+export function templateOfSource(raw) {
+    const text = raw.trim();
+    const match = /^(?:[rRbB]*[fF][rRbB]*|[rRbB]*)?("""|'''|"|')([\s\S]*)\1$/.exec(text);
+    if (match === null)
+        return undefined;
+    const body = match[2];
+    if (body.includes("\n"))
+        return undefined;
+    let out = "";
+    for (let i = 0; i < body.length; i += 1) {
+        const ch = body[i];
+        if (ch === "{" && body[i + 1] === "{") {
+            out += "{";
+            i += 1;
+            continue;
+        }
+        if (ch === "}" && body[i + 1] === "}") {
+            out += "}";
+            i += 1;
+            continue;
+        }
+        if (ch === "{") {
+            const close = body.indexOf("}", i);
+            if (close < 0)
+                return undefined;
+            out += "{param}";
+            i = close;
+            continue;
+        }
+        out += ch;
+    }
+    return out;
+}
+/**
+ * Locals holding a session or client constructed from one of these packages.
+ *
+ * `s = requests.Session()` and `c = httpx.Client()`. The construction is the
+ * evidence; a local *called* `session` is not.
+ */
+export function clientLocalsIn(calls, localOfCall, moduleOfImport) {
+    const locals = new Map();
+    for (const call of calls) {
+        if (call.callee === null)
+            continue;
+        const leaf = call.callee.includes(".")
+            ? call.callee.slice(call.callee.lastIndexOf(".") + 1)
+            : call.callee;
+        if (!SESSION_CONSTRUCTORS.has(leaf))
+            continue;
+        const root = call.callee.split(".")[0];
+        const module = call.callee.includes(".") ? root : moduleOfImport(root);
+        const resolved = module === undefined ? undefined : moduleOfImport(root) ?? module;
+        if (resolved === undefined || !CLIENT_MODULES.has(resolved.split(".")[0]))
+            continue;
+        const local = localOfCall(call);
+        if (local !== undefined)
+            locals.set(local, resolved.split(".")[0]);
+    }
+    return locals;
+}
+/** Every HTTP call written in one file, and every one refused. */
+export function clientCallsIn(file, calls, moduleOfImport, clientLocals, 
+/** Module-scope `NAME = "literal"` in this file, for base resolution. */
+constants = new Map(), 
+/** `scope::name` -> source text, for a path assembled a few lines earlier. */
+localStrings = new Map(), 
+/** `scope.join(".")` -> parameter names, for DEC-242's varies-per-call. */
+functionParams = new Map()) {
+    const found = [];
+    const refusals = [];
+    for (const call of calls) {
+        const receiver = call.receiver;
+        const attribute = call.attribute;
+        if (receiver === null || attribute === null)
+            continue;
+        // The receiver is either the package itself, or a local this file
+        // constructed a session on. Both are provenance; neither is a name.
+        const viaModule = CLIENT_MODULES.has(moduleOfImport(receiver)?.split(".")[0] ?? "")
+            ? moduleOfImport(receiver).split(".")[0]
+            : undefined;
+        const viaLocal = clientLocals.get(receiver);
+        const package_ = viaModule ?? viaLocal;
+        if (package_ === undefined)
+            continue;
+        const paramsHere = functionParams.get(call.scope.join(".")) ?? new Set();
+        let method = CLIENT_VERBS.get(attribute);
+        let pathIndex = 0;
+        if (method === undefined) {
+            // `requests.request("POST", url)` — the verb is the first argument, and
+            // it is a fact only when it is written as a literal.
+            if (attribute !== "request")
+                continue;
+            const verb = call.hasLiterals[0] === true ? String(call.literals[0]) : undefined;
+            if (verb === undefined || !CLIENT_VERBS.has(verb.toLowerCase())) {
+                refusals.push({
+                    file,
+                    line: call.line,
+                    rawTarget: `${receiver}.${attribute}`,
+                    reason: "callMethodNotLiteral",
+                    // The verb, not a value — never a per-call or environment fact.
+                    ...CAPABILITY_GAP,
+                });
+                continue;
+            }
+            method = verb.toUpperCase();
+            pathIndex = 1;
+        }
+        const rawPath = call.args[pathIndex];
+        if (rawPath === undefined)
+            continue;
+        let path;
+        // `url = f"{BASE}/orders"` two lines above `requests.get(url)`. One hop and
+        // only one: the local must be bound **in the same scope**, because two
+        // functions in one file each binding `url` are two different paths and
+        // merging them attaches a caller to an endpoint it never reaches. A local
+        // bound twice in one scope is not resolved either — the last write wins in
+        // this map and that is a guess, so the shape is left to the ledger.
+        const source = call.hasLiterals[pathIndex] === true
+            ? undefined
+            : localStrings.get(`${call.scope.join(".")}::${rawPath.trim()}`);
+        const written = source ?? rawPath;
+        if (call.hasLiterals[pathIndex] === true) {
+            path = String(call.literals[pathIndex]);
+        }
+        else {
+            // **The assembly is tried before the plain template, and the order is the
+            // whole fix.** `templateOfSource` happily reads
+            // `f"{BASE}/orders/{id}"` as the template `{param}/orders/{param}`, which
+            // then fails the leading-slash test and files as *"an absolute URL"* — a
+            // refusal that is not merely wrong but points at the wrong work. Every one
+            // of the 78 base-carrying calls in the reference set landed there.
+            const assembly = assemblyOfSource(written);
+            if (assembly !== undefined) {
+                const value = constants.get(assembly.base);
+                const resolved = value === undefined ? undefined : pathOfBase(value);
+                if (resolved === undefined) {
+                    refusals.push({
+                        file,
+                        line: call.line,
+                        rawTarget: assembly.base,
+                        reason: "callBaseUnresolved",
+                        ...diagnoseArgument(assembly.base, paramsHere),
+                    });
+                    continue;
+                }
+                if (resolved.external) {
+                    // DEC-014 makes an endpoint fileless and host-free, so `/v1/charges`
+                    // on Stripe and `/v1/charges` here are one node. Claiming it would
+                    // join this caller to a local route it never reaches.
+                    refusals.push({
+                        file,
+                        line: call.line,
+                        rawTarget: value,
+                        reason: "callBaseIsExternalHost",
+                        blockedBy: null,
+                        refusalClass: "out-of-scope",
+                    });
+                    continue;
+                }
+                path = `${resolved.path}${assembly.suffix}`;
+            }
+            else {
+                path = templateOfSource(written);
+            }
+        }
+        if (path === undefined) {
+            // A bare name gets its own row. 73 of the 283 calls in the reference set
+            // pass `url`, assembled a few lines earlier, and reading them as "not a
+            // literal" files them with genuinely opaque paths — one number for two
+            // populations, only one of which is reachable by further work.
+            const bare = /^[A-Za-z_][A-Za-z0-9_.]*$/.test(rawPath.trim());
+            refusals.push({
+                file,
+                line: call.line,
+                rawTarget: bare ? rawPath.trim() : `${receiver}.${attribute}`,
+                reason: bare ? "callPathFromLocal" : "callPathNotLiteral",
+                ...diagnoseArgument(rawPath.trim(), paramsHere),
+            });
+            continue;
+        }
+        if (!path.startsWith("/")) {
+            // An absolute URL names a host this repository does not serve, so there
+            // is no route on this side of the join for it to meet.
+            refusals.push({
+                file,
+                line: call.line,
+                rawTarget: path,
+                reason: "callPathNotRelative",
+                blockedBy: null,
+                refusalClass: "out-of-scope",
+            });
+            continue;
+        }
+        found.push({
+            file,
+            line: call.line,
+            method,
+            path,
+            rawPath,
+            scope: call.scope,
+            client: `${receiver}.${attribute}`,
+        });
+    }
+    return { calls: found, refusals };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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