@suss/adapter-python 0.33.1 → 0.34.0

package/grammar/README.md

@@ -2,20 +2,21 @@
 
 `tree-sitter-python.wasm` is the compiled Python grammar for
 [web-tree-sitter](https://www.npmjs.com/package/web-tree-sitter). It is
-a checked-in binary asset, not a build output: `src/parser.ts` loads it
-by path at run time (`Language.load(...)`), so the file has to exist on
-disk next to the compiled adapter, the same way `web-tree-sitter` ships
-its own core `.wasm` next to its JS.
+a binary checked into the repository, and the build does not produce
+it. `src/parser.ts` loads it by path at run time (`Language.load(...)`),
+so the file has to exist on disk next to the compiled adapter. This is
+the same way `web-tree-sitter` ships its own core `.wasm` next to its JS.
 
-The adapter depends only on `web-tree-sitter` (pure WASM, no native
-bindings, no install script). It does not depend on the
-`tree-sitter-python` npm package, because that package's `install`
-script runs `node-gyp-build` to load a native binding, which is
-unnecessary here and the kind of native-toolchain surface the
-language-adapters proposal rules out. This file is the one part of
-that package v0 actually needs, taken out on its own.
+The adapter depends only on `web-tree-sitter`, which is pure WASM with
+no native bindings and no install script. It does not depend on the
+`tree-sitter-python` npm package. That package's `install` script runs
+`node-gyp-build` to load a native binding, which this adapter does not
+need, and the language-adapters proposal rules out that kind of native
+toolchain dependency. This file is the one part of that package v0
+needs, copied out on its own.
 
-Provenance, so a grammar bump is a deliberate, checkable act:
+The provenance is recorded here so that a grammar bump is a deliberate
+change someone can check:
 
 - Source: `tree-sitter-python` npm package, version `0.23.6`.
 - File: `tree-sitter-python.wasm` from the package root (built by that
@@ -23,15 +24,17 @@ Provenance, so a grammar bump is a deliberate, checkable act:
 - SHA-256: `8c93692fb368e288a5824cee55773c9b3602804f513bda48c97661e52e9c2da2`.
 
 tree-sitter-python is MIT-licensed. [`NOTICE`](./NOTICE) in this
-directory reproduces its copyright and permission notice in full, and
-ships in the published tarball alongside the `.wasm` file (both live
-under `grammar/`, which the package's `files` field includes), so the
-attribution its license requires travels with the binary it covers.
+directory reproduces its copyright and permission notice in full. It
+ships in the published tarball alongside the `.wasm` file, because both
+live under `grammar/`, which the package's `files` field includes. The
+attribution its license requires therefore travels with the binary it
+covers.
 
-To pick up a newer grammar: `npm pack tree-sitter-python@<version>`,
-extract it, copy `tree-sitter-python.wasm` here, update the version and
-hash above, check `NOTICE` still matches that version's `LICENSE` file,
-and re-run the adapter's test suite. A grammar change that renames or
-restructures a node type used in `src/ast.ts` will fail loudly there.
-The fuzzer's parse-failure-rate reporting (per the language-adapters
-proposal) is the longer-term signal for when a bump is worth doing.
+To pick up a newer grammar, run `npm pack tree-sitter-python@<version>`
+and extract it. Copy `tree-sitter-python.wasm` here, update the version
+and hash above, check that `NOTICE` still matches that version's
+`LICENSE` file, and re-run the adapter's test suite. A grammar change
+that renames or restructures a node type used in `src/ast.ts` will fail
+loudly there. Over the longer term, the fuzzer's parse-failure-rate
+reporting (per the language-adapters proposal) is the signal for when a
+bump is needed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/adapter-python",
-  "version": "0.33.1",
+  "version": "0.34.0",
   "type": "module",
   "description": "Read a Python codebase with suss and check what each FastAPI or Flask route returns against the clients, specs and infrastructure that depend on it.",
   "keywords": [
@@ -15,7 +15,7 @@
   ],
   "license": "Apache-2.0",
   "author": "Nimbus Cloud AI LLC",
-  "homepage": "https://github.com/nimbuscloud-ai/suss/tree/main/packages/adapter/python#readme",
+  "homepage": "https://suss.sh",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nimbuscloud-ai/suss.git",
@@ -49,13 +49,14 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@suss/behavioral-ir": "0.33.1",
-    "@suss/datalog": "0.33.1",
-    "@suss/extractor": "0.33.1",
-    "@suss/ir-core": "0.33.1",
-    "@suss/resolution": "0.33.1",
-    "@suss/sql": "0.33.1",
-    "@suss/values": "0.33.1",
+    "@suss/behavioral-ir": "0.34.0",
+    "@suss/datalog": "0.34.0",
+    "@suss/extractor": "0.34.0",
+    "@suss/ir-core": "0.34.0",
+    "@suss/resolution": "0.34.0",
+    "@suss/sql": "0.34.0",
+    "@suss/values": "0.34.0",
+    "smol-toml": "^1.4.2",
     "web-tree-sitter": "^0.26.11"
   },
   "devDependencies": {