@suss/adapter-python 0.12.0 → 0.13.0

package/README.md

@@ -81,6 +81,20 @@ FastAPI has no column here: its app has no prefix of its own, and the pack decla
 | `""`, `None`, `False`, `0` | the blueprint's prefix + the rest | unstated |
 | a name or a call | whatever it evaluates to | unreadable |
 
+### A call that spreads a dictionary
+
+`Api(**build_authorizations())` and `include_router(router, **options)`
+spread a value the call does not write out. The reader skips the spread
+and reads the keywords that are written, so the routes underneath keep
+their paths.
+
+That leaves one thing it cannot see. If the dictionary sets the prefix
+keyword itself, the composed path is wrong, and nothing in the output
+says so. Reading the prefix as unknown instead would be correct and would
+cost every route under every call that spreads a config dictionary, which
+is most of them. Propagating the uncertainty rather than choosing between
+the two is the work that would settle this.
+
 **At the registration** (`app.register_blueprint(bp, ...)`), which the reader consults only to abstain:
 
 | Written | flask-restx serves | The reader says |

package/dist/index.cjs

@@ -622,6 +622,9 @@ function readCallArguments(argumentList) {
       }
       continue;
     }
+    if (child.type === "dictionary_splat" || child.type === "list_splat") {
+      continue;
+    }
     args.push(readArg(child));
   }
   return { args, keywordArgs };
@@ -19248,7 +19251,8 @@ function recordMountStatement(stmt, position, scan) {
     scan.composition,
     position.site
   );
-  for (const target of mountedConstructions(args[0], position, scan)) {
+  const mounted = args[0] ?? (scan.composition.routerKeyword === void 0 ? void 0 : keywordArgs[scan.composition.routerKeyword]);
+  for (const target of mountedConstructions(mounted, position, scan)) {
     recordMount(scan.index, target, state);
   }
 }

package/dist/index.d.cts

@@ -304,6 +304,12 @@ interface RouterComposition {
     routerConstructorName: string;
     /** Method that mounts a router onto the app, FastAPI's `include_router`. */
     includeMethodName: string;
+    /**
+     * What the mount method calls its router parameter, FastAPI's `router`.
+     * A call that passes the router by keyword rather than by position is
+     * read through this. Unset reads the first argument only.
+     */
+    routerKeyword?: string;
     /** One keyword serves the constructor and the mount alike. A library that spells them apart needs two fields here. */
     prefixKeyword: string;
     /** Default "prefixes". */

package/dist/index.d.ts

@@ -304,6 +304,12 @@ interface RouterComposition {
     routerConstructorName: string;
     /** Method that mounts a router onto the app, FastAPI's `include_router`. */
     includeMethodName: string;
+    /**
+     * What the mount method calls its router parameter, FastAPI's `router`.
+     * A call that passes the router by keyword rather than by position is
+     * read through this. Unset reads the first argument only.
+     */
+    routerKeyword?: string;
     /** One keyword serves the constructor and the mount alike. A library that spells them apart needs two fields here. */
     prefixKeyword: string;
     /** Default "prefixes". */

package/dist/index.js

@@ -568,6 +568,9 @@ function readCallArguments(argumentList) {
       }
       continue;
     }
+    if (child.type === "dictionary_splat" || child.type === "list_splat") {
+      continue;
+    }
     args.push(readArg(child));
   }
   return { args, keywordArgs };
@@ -19204,7 +19207,8 @@ function recordMountStatement(stmt, position, scan) {
     scan.composition,
     position.site
   );
-  for (const target of mountedConstructions(args[0], position, scan)) {
+  const mounted = args[0] ?? (scan.composition.routerKeyword === void 0 ? void 0 : keywordArgs[scan.composition.routerKeyword]);
+  for (const target of mountedConstructions(mounted, position, scan)) {
     recordMount(scan.index, target, state);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/adapter-python",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "type": "module",
   "description": "Python language adapter for suss — parses source with tree-sitter (WASM), resolves names with a lexical binder, and emits raw extractions for the suss pipeline.",
   "keywords": [
@@ -47,10 +47,10 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@suss/behavioral-ir": "0.12.0",
-    "@suss/datalog": "0.12.0",
-    "@suss/extractor": "0.12.0",
-    "@suss/sql": "0.12.0",
+    "@suss/behavioral-ir": "0.13.0",
+    "@suss/datalog": "0.13.0",
+    "@suss/extractor": "0.13.0",
+    "@suss/sql": "0.13.0",
     "web-tree-sitter": "^0.26.11"
   },
   "devDependencies": {