@contractkit/plugin-python 0.9.4 → 0.10.0

package/.turbo/turbo-build$colon$ci.log

@@ -1,9 +1,9 @@
 
-> @contractkit/plugin-python@0.9.4 build:ci /home/runner/work/ContractKit/ContractKit/packages/plugin-python
+> @contractkit/plugin-python@0.10.0 build:ci /home/runner/work/ContractKit/ContractKit/packages/plugin-python
 > eslint --max-warnings=0 && pnpm run build
 
 
-> @contractkit/plugin-python@0.9.4 build /home/runner/work/ContractKit/ContractKit/packages/plugin-python
+> @contractkit/plugin-python@0.10.0 build /home/runner/work/ContractKit/ContractKit/packages/plugin-python
 > tsup src/index.ts --format esm --sourcemap --dts && tsc --emitDeclarationOnly --declaration
 
 CLI Building entry: src/index.ts
@@ -11,9 +11,9 @@
 CLI tsup v8.5.1
 CLI Target: esnext
 ESM Build start
-ESM dist/index.js     36.84 KB
-ESM dist/index.js.map 76.54 KB
-ESM ⚡️ Build success in 184ms
+ESM dist/index.js     42.33 KB
+ESM dist/index.js.map 89.19 KB
+ESM ⚡️ Build success in 231ms
 DTS Build start
-DTS ⚡️ Build success in 4343ms
-DTS dist/index.d.ts 801.00 B
+DTS ⚡️ Build success in 4449ms
+DTS dist/index.d.ts 1.10 KB

package/.turbo/turbo-test$colon$ci.log

@@ -1,18 +1,18 @@
 
-> @contractkit/plugin-python@0.9.4 test:ci /home/runner/work/ContractKit/ContractKit/packages/plugin-python
+> @contractkit/plugin-python@0.10.0 test:ci /home/runner/work/ContractKit/ContractKit/packages/plugin-python
 > vitest run --coverage
 
 
  RUN  v4.1.5 /home/runner/work/ContractKit/ContractKit/packages/plugin-python
       Coverage enabled with v8
 
- ✓ tests/codegen-models.test.ts (32 tests) 130ms
- ✓ tests/codegen-client.test.ts (27 tests) 63ms
+ ✓ tests/codegen-models.test.ts (32 tests) 126ms
+ ✓ tests/codegen-client.test.ts (27 tests) 98ms
 
  Test Files  2 passed (2)
       Tests  59 passed (59)
-   Start at  12:37:07
-   Duration  4.97s (transform 1.83s, setup 0ms, import 7.12s, tests 193ms, environment 0ms)
+   Start at  11:09:08
+   Duration  5.60s (transform 1.93s, setup 0ms, import 7.42s, tests 224ms, environment 0ms)
 
  % Coverage report from v8
 -------------------|---------|----------|---------|---------|-------------------

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @contractkit/contractkit-plugin-python
 
+## 0.10.0
+
+### Minor Changes
+
+- 10ca07b: Add per-output incremental caching to the Bruno, Python, and TypeScript plugins. Editing a single contract or operation no longer regenerates every output file — only the units whose transitive inputs actually changed are re-rendered, with the rest reused from a per-plugin manifest. `@contractkit/core` exposes the shared utility (`runIncrementalCodegen`, `parseIncrementalManifest`, `hashFingerprint`, `collectTransitiveModelRefs`, manifest types) for plugin authors. `PluginContext` gains a `cacheEnabled` flag so plugins can honor `--force` / `cache: false`.
+
+### Patch Changes
+
+- Updated dependencies [10ca07b]
+    - @contractkit/core@0.15.0
+
 ## 0.9.4
 
 ### Patch Changes

package/coverage/clover.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<coverage generated="1778071032453" clover="3.2.0">
-  <project timestamp="1778071032453" name="All files">
+<coverage generated="1778152153915" clover="3.2.0">
+  <project timestamp="1778152153915" name="All files">
     <metrics statements="538" coveredstatements="456" conditionals="416" coveredconditionals="320" methods="91" coveredmethods="78" elements="1045" coveredelements="854" complexity="0" loc="538" ncloc="538" packages="2" files="3" classes="3"/>
     <package name="src">
       <metrics statements="500" coveredstatements="421" conditionals="385" coveredconditionals="297" methods="66" coveredmethods="55"/>

package/coverage/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-06T12:37:12.412Z
+                at 2026-05-07T11:09:13.871Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/src/codegen-client.ts.html

@@ -2056,7 +2056,7 @@ class BaseClient:
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-06T12:37:12.412Z
+                at 2026-05-07T11:09:13.871Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/src/codegen-models.ts.html

@@ -1345,7 +1345,7 @@ export function deriveModelsModuleName(file: string): string {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-06T12:37:12.412Z
+                at 2026-05-07T11:09:13.871Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/src/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-06T12:37:12.412Z
+                at 2026-05-07T11:09:13.871Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/tests/helpers.ts.html

@@ -652,7 +652,7 @@ export function opRoot(routes: OpRouteNode[], file = 'payments.op.ck', meta: Rec
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-06T12:37:12.412Z
+                at 2026-05-07T11:09:13.871Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/tests/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-06T12:37:12.412Z
+                at 2026-05-07T11:09:13.871Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/dist/index.d.ts

@@ -11,6 +11,13 @@ export interface PythonSdkPluginConfig {
      */
     includeInternal?: boolean;
 }
+/**
+ * Bumped when the Python codegen output shape changes in a way that should
+ * invalidate every per-file fingerprint. Mixed into the manifest's
+ * `codegenVersion`, so a plugin upgrade forces full regeneration even when no
+ * `.ck` files have changed.
+ */
+export declare const PYTHON_CODEGEN_VERSION = "1";
 declare const plugin: ContractKitPlugin;
 export default plugin;
 export declare function createPythonSdkPlugin(config: PythonSdkPluginConfig, rootDir: string): ContractKitPlugin;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAW3D,MAAM,WAAW,qBAAqB;IAClC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAID,QAAA,MAAM,MAAM,EAAE,iBAOb,CAAC;AAEF,eAAe,MAAM,CAAC;AAItB,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAsGvG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,iBAAiB,EAOpB,MAAM,mBAAmB,CAAC;AAmB3B,MAAM,WAAW,qBAAqB;IAClC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAI1C,QAAA,MAAM,MAAM,EAAE,iBAMb,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAOvG"}

package/dist/index.js

@@ -2,7 +2,9 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/index.ts
-import { resolve, join } from "path";
+import { resolve, join, relative } from "path";
+import { existsSync, readFileSync, rmSync, readdirSync, rmdirSync } from "fs";
+import { runIncrementalCodegen, parseIncrementalManifest, emptyIncrementalManifest, hashFingerprint, collectTransitiveModelRefs, collectTypeRefs as collectTypeRefs2 } from "@contractkit/core";
 
 // src/codegen-models.ts
 import { computeModelsWithInput, topoSortModels, collectExternalRefs, collectExternalInputRefs } from "@contractkit/core";
@@ -943,103 +945,286 @@ class BaseClient:
 `;
 
 // src/index.ts
+var PYTHON_CODEGEN_VERSION = "1";
+var MANIFEST_FILENAME = ".contractkit-python-manifest.json";
 var plugin = {
   name: "python-sdk",
-  cacheKey: "python-sdk",
   async generateTargets(inputs, ctx) {
     const config = ctx.options;
-    return createPythonSdkPlugin(config, ctx.rootDir).generateTargets(inputs, ctx);
+    await runPythonCodegen(inputs, ctx, config, ctx.rootDir);
   }
 };
 var index_default = plugin;
 function createPythonSdkPlugin(config, rootDir) {
   return {
     name: "python-sdk",
-    cacheKey: `python-sdk:${JSON.stringify(config)}`,
-    async generateTargets({ contractRoots, opRoots, modelsWithInput: _modelsWithInput }, ctx) {
-      const modelsWithInput = _modelsWithInput;
-      const outDir = resolve(rootDir, config.baseDir ?? "python-sdk");
-      const modelModulePaths = /* @__PURE__ */ new Map();
-      const contractEntries = [];
-      for (const contractRoot of contractRoots) {
-        const moduleName = deriveModelsModuleName(contractRoot.file);
-        const outPath = join(outDir, `${moduleName}.py`);
-        contractEntries.push({
-          moduleName,
-          outPath,
-          root: contractRoot
-        });
-        for (const model of contractRoot.models) {
-          modelModulePaths.set(model.name, `.${moduleName}`);
-          if (modelsWithInput.has(model.name)) {
-            modelModulePaths.set(`${model.name}Input`, `.${moduleName}`);
-          }
-        }
-      }
-      for (const { moduleName, outPath, root } of contractEntries) {
-        const content = generatePydanticModels(root, {
-          modelModulePaths,
-          currentModule: `.${moduleName}`,
-          modelsWithInput
-        });
-        ctx.emitFile(outPath, content);
+    async generateTargets(inputs, ctx) {
+      await runPythonCodegen(inputs, ctx, config, rootDir);
+    }
+  };
+}
+__name(createPythonSdkPlugin, "createPythonSdkPlugin");
+async function runPythonCodegen(inputs, ctx, config, rootDir) {
+  const { contractRoots, opRoots } = inputs;
+  const modelsWithInput = inputs.modelsWithInput;
+  const outDir = resolve(rootDir, config.baseDir ?? "python-sdk");
+  const modelModulePaths = /* @__PURE__ */ new Map();
+  const modelMap = /* @__PURE__ */ new Map();
+  const contractEntries = [];
+  for (const root of contractRoots) {
+    const moduleName = deriveModelsModuleName(root.file);
+    contractEntries.push({
+      moduleName,
+      relPath: `${moduleName}.py`,
+      root
+    });
+    for (const model of root.models) {
+      modelMap.set(model.name, model);
+      modelModulePaths.set(model.name, `.${moduleName}`);
+      if (modelsWithInput.has(model.name)) {
+        modelModulePaths.set(`${model.name}Input`, `.${moduleName}`);
       }
-      const clientInfos = [];
-      for (const opRoot of opRoots) {
-        if (!hasPublicOperations(opRoot, config.includeInternal)) continue;
-        const moduleName = deriveClientModuleName(opRoot.file);
-        const outPath = join(outDir, `${moduleName}.py`);
-        clientInfos.push({
-          moduleName,
-          className: deriveClientClassName(opRoot.file),
-          propertyName: deriveClientPropertyName(opRoot.file)
-        });
-        ctx.emitFile(outPath, generatePythonClient(opRoot, {
-          modelModulePaths,
-          currentModule: `.${moduleName}`,
-          modelsWithInput,
-          includeInternal: config.includeInternal
-        }));
+    }
+  }
+  const modelsWithInputArray = [
+    ...modelsWithInput
+  ].sort();
+  const prevManifest = ctx.cacheEnabled ? readManifest(outDir) : emptyIncrementalManifest(PYTHON_CODEGEN_VERSION);
+  const units = [];
+  for (const { moduleName, relPath, root } of contractEntries) {
+    const ownNames = new Set(root.models.map((m) => m.name));
+    const externalRefs = collectExternalRefsFromContract(root, ownNames);
+    const referencedModulePaths = {};
+    for (const ref of [
+      ...externalRefs
+    ].sort()) {
+      const path = modelModulePaths.get(ref);
+      if (path) referencedModulePaths[ref] = path;
+      const inputPath = modelModulePaths.get(`${ref}Input`);
+      if (inputPath) referencedModulePaths[`${ref}Input`] = inputPath;
+    }
+    const relevantInputModels = modelsWithInputArray.filter((name) => ownNames.has(name) || externalRefs.has(name));
+    const fingerprint = hashFingerprint({
+      kind: "models",
+      v: PYTHON_CODEGEN_VERSION,
+      relPath,
+      currentModule: `.${moduleName}`,
+      root,
+      referencedModulePaths,
+      modelsWithInput: relevantInputModels
+    });
+    units.push({
+      key: `models::${relPath}`,
+      fingerprint,
+      render: /* @__PURE__ */ __name(() => [
+        {
+          relativePath: relPath,
+          content: generatePydanticModels(root, {
+            modelModulePaths,
+            currentModule: `.${moduleName}`,
+            modelsWithInput
+          })
+        }
+      ], "render")
+    });
+  }
+  const clientInfos = [];
+  for (const root of opRoots) {
+    if (!hasPublicOperations(root, config.includeInternal)) continue;
+    const moduleName = deriveClientModuleName(root.file);
+    const relPath = `${moduleName}.py`;
+    clientInfos.push({
+      moduleName,
+      className: deriveClientClassName(root.file),
+      propertyName: deriveClientPropertyName(root.file)
+    });
+    const referencedModels = collectOpRootModelRefs(root, modelMap);
+    const referencedModulePaths = {};
+    for (const ref of [
+      ...referencedModels
+    ].sort()) {
+      const path = modelModulePaths.get(ref);
+      if (path) referencedModulePaths[ref] = path;
+      const inputPath = modelModulePaths.get(`${ref}Input`);
+      if (inputPath) referencedModulePaths[`${ref}Input`] = inputPath;
+    }
+    const relevantInputModels = modelsWithInputArray.filter((name) => referencedModels.has(name));
+    const fingerprint = hashFingerprint({
+      kind: "client",
+      v: PYTHON_CODEGEN_VERSION,
+      relPath,
+      currentModule: `.${moduleName}`,
+      root,
+      referencedModulePaths,
+      modelsWithInput: relevantInputModels,
+      includeInternal: config.includeInternal ?? false
+    });
+    units.push({
+      key: `client::${relPath}`,
+      fingerprint,
+      render: /* @__PURE__ */ __name(() => [
+        {
+          relativePath: relPath,
+          content: generatePythonClient(root, {
+            modelModulePaths,
+            currentModule: `.${moduleName}`,
+            modelsWithInput,
+            includeInternal: config.includeInternal
+          })
+        }
+      ], "render")
+    });
+  }
+  const sdkClassName = config.packageName ? config.packageName.split(/[-._\s]+/).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("") + "Sdk" : "Sdk";
+  const initLines = [
+    "# Auto-generated by contractkit-plugin-python-sdk. Do not edit manually.",
+    "from ._base_client import BaseClient, SdkError"
+  ];
+  for (const c of clientInfos) {
+    initLines.push(`from .${c.moduleName} import ${c.className}`);
+  }
+  initLines.push("");
+  initLines.push("");
+  if (clientInfos.length > 0) {
+    initLines.push(`class ${sdkClassName}(BaseClient):`);
+    initLines.push(`    def __init__(self, base_url: str, headers: dict[str, str] | None = None):`);
+    initLines.push(`        super().__init__(base_url, headers)`);
+    for (const c of clientInfos) {
+      initLines.push(`        self.${c.propertyName} = ${c.className}(base_url, headers)`);
+    }
+    initLines.push("");
+  } else {
+    initLines.push(`class ${sdkClassName}(BaseClient):`);
+    initLines.push(`    pass`);
+    initLines.push("");
+  }
+  const allNames = [
+    "BaseClient",
+    "SdkError",
+    sdkClassName,
+    ...clientInfos.map((c) => c.className)
+  ];
+  initLines.push(`__all__ = [${allNames.map((n) => JSON.stringify(n)).join(", ")}]`);
+  initLines.push("");
+  const globalFiles = [
+    {
+      relativePath: "_base_client.py",
+      content: BASE_CLIENT_PY
+    },
+    {
+      relativePath: "requirements.txt",
+      content: "httpx\npydantic>=2.0\n"
+    },
+    {
+      relativePath: "__init__.py",
+      content: initLines.join("\n")
+    }
+  ];
+  const result = runIncrementalCodegen({
+    codegenVersion: PYTHON_CODEGEN_VERSION,
+    manifestFilename: MANIFEST_FILENAME,
+    prevManifest,
+    globalFiles,
+    units,
+    fileExists: /* @__PURE__ */ __name((relPath) => existsSync(resolve(outDir, relPath)), "fileExists")
+  });
+  deleteStalePaths(outDir, result.deletedPaths);
+  for (const { relativePath, content } of result.filesToWrite) {
+    ctx.emitFile(resolve(outDir, relativePath), content);
+  }
+  void relative;
+}
+__name(runPythonCodegen, "runPythonCodegen");
+function collectExternalRefsFromContract(root, ownNames) {
+  const refs = /* @__PURE__ */ new Set();
+  for (const m of root.models) {
+    if (m.type) collectTypeRefs2(m.type, refs);
+    for (const f of m.fields) collectTypeRefs2(f.type, refs);
+    if (m.bases) {
+      for (const b of m.bases) refs.add(b);
+    }
+  }
+  for (const own of ownNames) refs.delete(own);
+  return refs;
+}
+__name(collectExternalRefsFromContract, "collectExternalRefsFromContract");
+function collectOpRootModelRefs(root, modelMap) {
+  const seeds = [];
+  for (const route of root.routes) {
+    if (route.params) seeds.push(...paramSourceTypes(route.params));
+    for (const op of route.operations) {
+      if (op.query) seeds.push(...paramSourceTypes(op.query));
+      if (op.headers) seeds.push(...paramSourceTypes(op.headers));
+      if (op.request) {
+        for (const body of op.request.bodies) seeds.push(body.bodyType);
       }
-      ctx.emitFile(join(outDir, "_base_client.py"), BASE_CLIENT_PY);
-      ctx.emitFile(join(outDir, "requirements.txt"), "httpx\npydantic>=2.0\n");
-      const sdkClassName = config.packageName ? config.packageName.split(/[-._\s]+/).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("") + "Sdk" : "Sdk";
-      const initLines = [
-        "# Auto-generated by contractkit-plugin-python-sdk. Do not edit manually.",
-        "from ._base_client import BaseClient, SdkError"
-      ];
-      for (const c of clientInfos) {
-        initLines.push(`from .${c.moduleName} import ${c.className}`);
+      for (const resp of op.responses) {
+        if (resp.bodyType) seeds.push(resp.bodyType);
+        if (resp.headers) {
+          for (const h of resp.headers) seeds.push(h.type);
+        }
       }
-      initLines.push("");
-      initLines.push("");
-      if (clientInfos.length > 0) {
-        initLines.push(`class ${sdkClassName}(BaseClient):`);
-        initLines.push(`    def __init__(self, base_url: str, headers: dict[str, str] | None = None):`);
-        initLines.push(`        super().__init__(base_url, headers)`);
-        for (const c of clientInfos) {
-          initLines.push(`        self.${c.propertyName} = ${c.className}(base_url, headers)`);
+    }
+  }
+  return collectTransitiveModelRefs(seeds, modelMap);
+}
+__name(collectOpRootModelRefs, "collectOpRootModelRefs");
+function paramSourceTypes(src) {
+  const out = [];
+  if (src.kind === "params") {
+    for (const n of src.nodes) out.push(n.type);
+  } else if (src.kind === "ref") {
+    out.push({
+      kind: "ref",
+      name: src.name
+    });
+  } else if (src.kind === "type") {
+    out.push(src.node);
+  }
+  return out;
+}
+__name(paramSourceTypes, "paramSourceTypes");
+function readManifest(outDir) {
+  const manifestPath = resolve(outDir, MANIFEST_FILENAME);
+  if (!existsSync(manifestPath)) return emptyIncrementalManifest(PYTHON_CODEGEN_VERSION);
+  try {
+    return parseIncrementalManifest(readFileSync(manifestPath, "utf-8"));
+  } catch {
+    return emptyIncrementalManifest(PYTHON_CODEGEN_VERSION);
+  }
+}
+__name(readManifest, "readManifest");
+function deleteStalePaths(outDir, relPaths) {
+  if (relPaths.length === 0) return;
+  const removedDirs = /* @__PURE__ */ new Set();
+  for (const rel of relPaths) {
+    const abs = resolve(outDir, rel);
+    if (existsSync(abs)) {
+      rmSync(abs, {
+        force: true
+      });
+      removedDirs.add(join(abs, ".."));
+    }
+  }
+  for (const dir of removedDirs) {
+    let current = dir;
+    while (current.startsWith(outDir) && current !== outDir) {
+      try {
+        if (readdirSync(current).length === 0) {
+          rmdirSync(current);
+          current = join(current, "..");
+        } else {
+          break;
         }
-        initLines.push("");
-      } else {
-        initLines.push(`class ${sdkClassName}(BaseClient):`);
-        initLines.push(`    pass`);
-        initLines.push("");
+      } catch {
+        break;
       }
-      const allNames = [
-        "BaseClient",
-        "SdkError",
-        sdkClassName,
-        ...clientInfos.map((c) => c.className)
-      ];
-      initLines.push(`__all__ = [${allNames.map((n) => JSON.stringify(n)).join(", ")}]`);
-      initLines.push("");
-      ctx.emitFile(join(outDir, "__init__.py"), initLines.join("\n"));
     }
-  };
+  }
 }
-__name(createPythonSdkPlugin, "createPythonSdkPlugin");
+__name(deleteStalePaths, "deleteStalePaths");
 export {
+  PYTHON_CODEGEN_VERSION,
   createPythonSdkPlugin,
   index_default as default
 };