@contractkit/plugin-python 0.9.1

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

@@ -0,0 +1,35 @@
+
+
+> @contractkit/plugin-python@0.9.0 build:ci /Users/robert/projects/contractkit/packages/plugin-python
+> eslint --max-warnings=0 && pnpm run build
+
+=============
+
+
+WARNING: You are currently running a version of TypeScript which is not officially supported by @typescript-eslint/typescript-estree.
+
+
+* @typescript-eslint/typescript-estree version: 8.57.2
+* Supported TypeScript versions: >=4.8.4 <6.0.0
+* Your TypeScript version: 6.0.2
+
+
+Please only submit bug reports when using the officially supported version.
+
+
+=============
+
+> @contractkit/plugin-python@0.9.0 build /Users/robert/projects/contractkit/packages/plugin-python
+> tsup src/index.ts --format esm --sourcemap --dts && tsc --emitDeclarationOnly --declaration
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+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 46ms
+DTS Build start
+DTS ⚡️ Build success in 602ms
+DTS dist/index.d.ts 801.00 B

package/.turbo/turbo-build.log

@@ -0,0 +1,15 @@
+
+> @contractkit/plugin-python@0.9.0 build /Users/robert/projects/contractkit/packages/plugin-python
+> tsup src/index.ts --format esm --sourcemap --dts && tsc --emitDeclarationOnly --declaration
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+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 97ms
+DTS Build start
+DTS ⚡️ Build success in 631ms
+DTS dist/index.d.ts 801.00 B

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

@@ -0,0 +1,59 @@
+
+
+> @contractkit/plugin-python@0.9.0 test:ci /Users/robert/projects/contractkit/packages/plugin-python
+> vitest run --coverage
+
+[?25l
+ RUN  v4.1.5 /Users/robert/projects/contractkit/packages/plugin-python
+      Coverage enabled with v8
+
+[?2026h
+ ❯ tests/codegen-models.test.ts [queued]
+
+ Test Files 0 passed (2)
+      Tests 0 passed (0)
+   Start at 08:51:08
+   Duration 308ms
+[?2026l[?2026h
+ ❯ tests/codegen-client.test.ts [queued]
+ ❯ tests/codegen-models.test.ts [queued]
+
+ Test Files 0 passed (2)
+      Tests 0 passed (0)
+   Start at 08:51:08
+   Duration 410ms
+[?2026l[?2026h
+ ❯ tests/codegen-client.test.ts [queued]
+ ❯ tests/codegen-models.test.ts 0/32
+
+ Test Files 0 passed (2)
+      Tests 0 passed (32)
+   Start at 08:51:08
+   Duration 750ms
+[?2026l[?2026h ✓ tests/codegen-models.test.ts (32 tests) 6ms
+
+ ❯ tests/codegen-client.test.ts 0/27
+
+ Test Files 1 passed (2)
+      Tests 32 passed (59)
+   Start at 08:51:08
+   Duration 951ms
+[?2026l ✓ tests/codegen-client.test.ts (27 tests) 9ms
+
+ Test Files  2 passed (2)
+      Tests  59 passed (59)
+   Start at  08:51:08
+   Duration  1.04s (transform 164ms, setup 0ms, import 968ms, tests 15ms, environment 0ms)
+
+ % Coverage report from v8
+--------------------|---------|----------|---------|---------|---------------------------------------------------------------------------------------------------
+File                | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s                                                                                 
+--------------------|---------|----------|---------|---------|---------------------------------------------------------------------------------------------------
+All files           |   82.67 |    76.92 |   85.71 |   84.75 |                                                                                                   
+ src                |   82.36 |    77.14 |   83.33 |    84.2 |                                                                                                   
+  codegen-client.ts |    82.6 |    77.92 |   86.48 |   83.33 | 60-64,139,218,225,246,331-335,345,363-364,372-373,382,405,438,442,458-465,472-473,487-507,540-541 
+  codegen-models.ts |   82.04 |    75.97 |   79.31 |   85.32 | 51,67-68,91,108-109,137-138,145-154,159-160,166-170,194-195,245,285,307,333,347-349,353           
+ tests              |   86.66 |    74.19 |      92 |    92.1 |                                                                                                   
+  helpers.ts        |   86.66 |    74.19 |      92 |    92.1 | 137-141,167                                                                                       
+--------------------|---------|----------|---------|---------|---------------------------------------------------------------------------------------------------
+[?25h

package/.turbo/turbo-test.log

@@ -0,0 +1,15 @@
+
+> @contractkit/plugin-python@0.9.0 test /Users/robert/projects/contractkit/packages/plugin-python
+> vitest run
+
+
+ RUN  v4.1.5 /Users/robert/projects/contractkit/packages/plugin-python
+
+ ✓ tests/codegen-models.test.ts (32 tests) 6ms
+ ✓ tests/codegen-client.test.ts (27 tests) 5ms
+
+ Test Files  2 passed (2)
+      Tests  59 passed (59)
+   Start at  08:51:33
+   Duration  442ms (transform 229ms, setup 0ms, import 563ms, tests 11ms, environment 0ms)
+

package/CHANGELOG.md

@@ -0,0 +1,118 @@
+# @contractkit/contractkit-plugin-python
+
+## 0.9.1
+
+### Patch Changes
+
+- 9269093: chore: update dependencies across multiple projects
+
+    This commit updates various dependencies in the package.json files for several projects, including:
+    - Upgraded `@changesets/cli`, `@types/node`, `@vitest/coverage-v8`, `eslint`, `prettier`, `turbo`, and `typescript` to their latest versions.
+    - Updated `@types/vscode`, `@vscode/vsce`, and `esbuild` in the vscode extension.
+    - Adjusted `@scalar/openapi-parser` and `yaml` in the openapi-to-ck package.
+    - Enhanced ESLint and TypeScript configurations in the config-eslint package.
+
+    These updates improve compatibility and maintainability across the codebase.
+
+- Updated dependencies [c9f2166]
+    - @contractkit/core@0.11.0
+
+## 0.9.0
+
+### Minor Changes
+
+- bbee232: prep for public release
+
+### Patch Changes
+
+- Updated dependencies [bbee232]
+    - @contractkit/core@0.10.0
+
+## 0.8.0
+
+### Minor Changes
+
+- e27b771: Add an `includeInternal: boolean` config option to every plugin so consumers can override whether `internal` operations are emitted. Defaults preserve today's behavior: server router and Bruno default to `true` (include); TS SDK, Python SDK, OpenAPI, and Markdown default to `false` (exclude).
+
+## 0.7.0
+
+### Minor Changes
+
+- d13614c: Enhance content type handling in contract DSL. This update introduces support for vendor JSON MIME types and improves the classification of content types, allowing for better handling of text and binary responses. The grammar has been updated to accept a wider range of MIME types, and tests have been added to ensure correct parsing and serialization behavior. Additionally, the code has been refactored to normalize content types for stable comparisons and to support multi-MIME request bodies.
+
+### Patch Changes
+
+- Updated dependencies [d13614c]
+    - @maroonedsoftware/contractkit@0.9.0
+
+## 0.6.0
+
+### Minor Changes
+
+- 888ded5: Enhance contract DSL with multi-base inheritance support and override modifier. This update introduces the ability to declare multiple base contracts, along with validation rules for field conflicts across bases. The `override` modifier is now required for redeclaring conflicting fields, and the documentation has been updated to reflect these changes. Tests have been added to ensure correct behavior for inheritance and modifier usage.
+
+### Patch Changes
+
+- Updated dependencies [353aa10]
+- Updated dependencies [888ded5]
+    - @maroonedsoftware/contractkit@0.8.0
+
+## 0.5.0
+
+### Minor Changes
+
+- 5d42e39: Enhance Python and TypeScript SDKs to support typed response headers. Updated the Python client to generate `TypedDict` for response headers and modified return types accordingly. The TypeScript SDK now includes runtime assertions for required headers and documents them in the generated markdown. Tests were added to verify the correct handling of response headers in both SDKs.
+
+## 0.4.2
+
+### Patch Changes
+
+- Updated dependencies [16ac3a7]
+    - @maroonedsoftware/contractkit@0.7.0
+
+## 0.4.1
+
+### Patch Changes
+
+- Updated dependencies [d3ea773]
+    - @maroonedsoftware/contractkit@0.6.0
+
+## 0.4.0
+
+### Minor Changes
+
+- 181dadb: Refactor request handling to support multiple content types in operations. Updated OpRequestNode to accept an array of bodies, modified related functions and tests to accommodate multi-MIME requests, and enhanced validation for nested structures in URL-encoded bodies. Improved code generation across various plugins to handle new request structure.
+
+### Patch Changes
+
+- Updated dependencies [181dadb]
+    - @maroonedsoftware/contractkit@0.5.0
+
+## 0.3.0
+
+### Minor Changes
+
+- ada5f84: Implement discriminated unions in ContractKit with validation and code generation support. Update README and tests to reflect new functionality, including parsing, rendering, and OpenAPI generation for discriminated unions.
+
+### Patch Changes
+
+- Updated dependencies [ada5f84]
+    - @maroonedsoftware/contractkit@0.4.0
+
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies [f396a68]
+    - @maroonedsoftware/contractkit@0.3.0
+
+## 0.2.0
+
+### Minor Changes
+
+- db7345b: updating to contractkit as the org
+
+### Patch Changes
+
+- Updated dependencies [db7345b]
+    - @contractkit/core@0.2.0

package/README.md

@@ -0,0 +1,86 @@
+# @contractkit/contractkit-plugin-python-sdk
+
+ContractKit plugin that generates a Python SDK from `.ck` contract and operation files. Produces [Pydantic v2](https://docs.pydantic.dev/latest/) models and [httpx](https://www.python-httpx.org/)-based client classes.
+
+## Installation
+
+```bash
+pnpm add @contractkit/contractkit-plugin-python-sdk
+```
+
+## Configuration
+
+```json
+{
+  "plugins": {
+    "@contractkit/contractkit-plugin-python-sdk": {
+      "baseDir": "python-sdk",
+      "packageName": "acme"
+    }
+  }
+}
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `baseDir` | `string` | `"python-sdk"` | Output directory relative to rootDir |
+| `packageName` | `string` | `"Sdk"` | Name used for the aggregator SDK class |
+
+## Output structure
+
+```
+python-sdk/
+├── __init__.py          # SDK aggregator class + __all__ exports
+├── _base_client.py      # Shared BaseClient and SdkError classes
+├── _models_<name>.py    # Pydantic v2 models (one file per .ck contract file)
+├── _client_<name>.py    # httpx client class (one file per .ck operation file)
+└── requirements.txt     # Runtime dependencies (httpx, pydantic>=2.0)
+```
+
+### Models (`_models_*.py`)
+
+Each `contract` declaration becomes a Pydantic v2 `BaseModel`. Contracts that have `readonly` or `writeonly` fields produce separate Input variants following the same rules as the TypeScript plugin:
+
+- **`Model`** — read model (no writeonly fields)
+- **`ModelInput`** — input model (no readonly fields)
+
+### Clients (`_client_*.py`)
+
+Each operation file with at least one public operation generates a client class. Methods correspond to HTTP verbs and are named from the `sdk:` field in the `.ck` source. Request and response bodies are typed with the generated Pydantic models.
+
+### Aggregator (`__init__.py`)
+
+The aggregator class (named from `packageName`) instantiates all client classes and exposes them as attributes. Pass the base URL and optional headers at construction time:
+
+```python
+from python_sdk import AcmeSdk
+
+sdk = AcmeSdk(base_url="https://api.acme.com", headers={"Authorization": "Bearer ..."})
+payment = sdk.payments.get_payment(id="pay_123")
+```
+
+### Base client (`_base_client.py`)
+
+Provides `BaseClient` (wraps `httpx.Client`) and `SdkError` (raised on non-2xx responses). All generated client classes inherit from `BaseClient`.
+
+## Runtime dependencies
+
+The generated SDK requires:
+
+```
+pydantic>=2.0
+httpx
+```
+
+## Programmatic use
+
+```typescript
+import { createPythonSdkPlugin } from '@contractkit/contractkit-plugin-python-sdk';
+
+const plugin = createPythonSdkPlugin({
+  baseDir: 'sdks/python',
+  packageName: 'acme',
+});
+```

package/coverage/base.css

@@ -0,0 +1,224 @@
+body, html {
+  margin:0; padding: 0;
+  height: 100%;
+}
+body {
+    font-family: Helvetica Neue, Helvetica, Arial;
+    font-size: 14px;
+    color:#333;
+}
+.small { font-size: 12px; }
+*, *:after, *:before {
+  -webkit-box-sizing:border-box;
+     -moz-box-sizing:border-box;
+          box-sizing:border-box;
+  }
+h1 { font-size: 20px; margin: 0;}
+h2 { font-size: 14px; }
+pre {
+    font: 12px/1.4 Consolas, "Liberation Mono", Menlo, Courier, monospace;
+    margin: 0;
+    padding: 0;
+    -moz-tab-size: 2;
+    -o-tab-size:  2;
+    tab-size: 2;
+}
+a { color:#0074D9; text-decoration:none; }
+a:hover { text-decoration:underline; }
+.strong { font-weight: bold; }
+.space-top1 { padding: 10px 0 0 0; }
+.pad2y { padding: 20px 0; }
+.pad1y { padding: 10px 0; }
+.pad2x { padding: 0 20px; }
+.pad2 { padding: 20px; }
+.pad1 { padding: 10px; }
+.space-left2 { padding-left:55px; }
+.space-right2 { padding-right:20px; }
+.center { text-align:center; }
+.clearfix { display:block; }
+.clearfix:after {
+  content:'';
+  display:block;
+  height:0;
+  clear:both;
+  visibility:hidden;
+  }
+.fl { float: left; }
+@media only screen and (max-width:640px) {
+  .col3 { width:100%; max-width:100%; }
+  .hide-mobile { display:none!important; }
+}
+
+.quiet {
+  color: #7f7f7f;
+  color: rgba(0,0,0,0.5);
+}
+.quiet a { opacity: 0.7; }
+
+.fraction {
+  font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
+  font-size: 10px;
+  color: #555;
+  background: #E8E8E8;
+  padding: 4px 5px;
+  border-radius: 3px;
+  vertical-align: middle;
+}
+
+div.path a:link, div.path a:visited { color: #333; }
+table.coverage {
+  border-collapse: collapse;
+  margin: 10px 0 0 0;
+  padding: 0;
+}
+
+table.coverage td {
+  margin: 0;
+  padding: 0;
+  vertical-align: top;
+}
+table.coverage td.line-count {
+    text-align: right;
+    padding: 0 5px 0 20px;
+}
+table.coverage td.line-coverage {
+    text-align: right;
+    padding-right: 10px;
+    min-width:20px;
+}
+
+table.coverage td span.cline-any {
+    display: inline-block;
+    padding: 0 5px;
+    width: 100%;
+}
+.missing-if-branch {
+    display: inline-block;
+    margin-right: 5px;
+    border-radius: 3px;
+    position: relative;
+    padding: 0 4px;
+    background: #333;
+    color: yellow;
+}
+
+.skip-if-branch {
+    display: none;
+    margin-right: 10px;
+    position: relative;
+    padding: 0 4px;
+    background: #ccc;
+    color: white;
+}
+.missing-if-branch .typ, .skip-if-branch .typ {
+    color: inherit !important;
+}
+.coverage-summary {
+  border-collapse: collapse;
+  width: 100%;
+}
+.coverage-summary tr { border-bottom: 1px solid #bbb; }
+.keyline-all { border: 1px solid #ddd; }
+.coverage-summary td, .coverage-summary th { padding: 10px; }
+.coverage-summary tbody { border: 1px solid #bbb; }
+.coverage-summary td { border-right: 1px solid #bbb; }
+.coverage-summary td:last-child { border-right: none; }
+.coverage-summary th {
+  text-align: left;
+  font-weight: normal;
+  white-space: nowrap;
+}
+.coverage-summary th.file { border-right: none !important; }
+.coverage-summary th.pct { }
+.coverage-summary th.pic,
+.coverage-summary th.abs,
+.coverage-summary td.pct,
+.coverage-summary td.abs { text-align: right; }
+.coverage-summary td.file { white-space: nowrap;  }
+.coverage-summary td.pic { min-width: 120px !important;  }
+.coverage-summary tfoot td { }
+
+.coverage-summary .sorter {
+    height: 10px;
+    width: 7px;
+    display: inline-block;
+    margin-left: 0.5em;
+    background: url(sort-arrow-sprite.png) no-repeat scroll 0 0 transparent;
+}
+.coverage-summary .sorted .sorter {
+    background-position: 0 -20px;
+}
+.coverage-summary .sorted-desc .sorter {
+    background-position: 0 -10px;
+}
+.status-line {  height: 10px; }
+/* yellow */
+.cbranch-no { background: yellow !important; color: #111; }
+/* dark red */
+.red.solid, .status-line.low, .low .cover-fill { background:#C21F39 }
+.low .chart { border:1px solid #C21F39 }
+.highlighted,
+.highlighted .cstat-no, .highlighted .fstat-no, .highlighted .cbranch-no{
+  background: #C21F39 !important;
+}
+/* medium red */
+.cstat-no, .fstat-no, .cbranch-no, .cbranch-no { background:#F6C6CE }
+/* light red */
+.low, .cline-no { background:#FCE1E5 }
+/* light green */
+.high, .cline-yes { background:rgb(230,245,208) }
+/* medium green */
+.cstat-yes { background:rgb(161,215,106) }
+/* dark green */
+.status-line.high, .high .cover-fill { background:rgb(77,146,33) }
+.high .chart { border:1px solid rgb(77,146,33) }
+/* dark yellow (gold) */
+.status-line.medium, .medium .cover-fill { background: #f9cd0b; }
+.medium .chart { border:1px solid #f9cd0b; }
+/* light yellow */
+.medium { background: #fff4c2; }
+
+.cstat-skip { background: #ddd; color: #111; }
+.fstat-skip { background: #ddd; color: #111 !important; }
+.cbranch-skip { background: #ddd !important; color: #111; }
+
+span.cline-neutral { background: #eaeaea; }
+
+.coverage-summary td.empty {
+    opacity: .5;
+    padding-top: 4px;
+    padding-bottom: 4px;
+    line-height: 1;
+    color: #888;
+}
+
+.cover-fill, .cover-empty {
+  display:inline-block;
+  height: 12px;
+}
+.chart {
+  line-height: 0;
+}
+.cover-empty {
+    background: white;
+}
+.cover-full {
+    border-right: none !important;
+}
+pre.prettyprint {
+    border: none !important;
+    padding: 0 !important;
+    margin: 0 !important;
+}
+.com { color: #999 !important; }
+.ignore-none { color: #999; font-weight: normal; }
+
+.wrapper {
+  min-height: 100%;
+  height: auto !important;
+  height: 100%;
+  margin: 0 auto -48px;
+}
+.footer, .push {
+  height: 48px;
+}

package/coverage/block-navigation.js

@@ -0,0 +1,87 @@
+/* eslint-disable */
+var jumpToCode = (function init() {
+    // Classes of code we would like to highlight in the file view
+    var missingCoverageClasses = ['.cbranch-no', '.cstat-no', '.fstat-no'];
+
+    // Elements to highlight in the file listing view
+    var fileListingElements = ['td.pct.low'];
+
+    // We don't want to select elements that are direct descendants of another match
+    var notSelector = ':not(' + missingCoverageClasses.join('):not(') + ') > '; // becomes `:not(a):not(b) > `
+
+    // Selector that finds elements on the page to which we can jump
+    var selector =
+        fileListingElements.join(', ') +
+        ', ' +
+        notSelector +
+        missingCoverageClasses.join(', ' + notSelector); // becomes `:not(a):not(b) > a, :not(a):not(b) > b`
+
+    // The NodeList of matching elements
+    var missingCoverageElements = document.querySelectorAll(selector);
+
+    var currentIndex;
+
+    function toggleClass(index) {
+        missingCoverageElements
+            .item(currentIndex)
+            .classList.remove('highlighted');
+        missingCoverageElements.item(index).classList.add('highlighted');
+    }
+
+    function makeCurrent(index) {
+        toggleClass(index);
+        currentIndex = index;
+        missingCoverageElements.item(index).scrollIntoView({
+            behavior: 'smooth',
+            block: 'center',
+            inline: 'center'
+        });
+    }
+
+    function goToPrevious() {
+        var nextIndex = 0;
+        if (typeof currentIndex !== 'number' || currentIndex === 0) {
+            nextIndex = missingCoverageElements.length - 1;
+        } else if (missingCoverageElements.length > 1) {
+            nextIndex = currentIndex - 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    function goToNext() {
+        var nextIndex = 0;
+
+        if (
+            typeof currentIndex === 'number' &&
+            currentIndex < missingCoverageElements.length - 1
+        ) {
+            nextIndex = currentIndex + 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    return function jump(event) {
+        if (
+            document.getElementById('fileSearch') === document.activeElement &&
+            document.activeElement != null
+        ) {
+            // if we're currently focused on the search input, we don't want to navigate
+            return;
+        }
+
+        switch (event.which) {
+            case 78: // n
+            case 74: // j
+                goToNext();
+                break;
+            case 66: // b
+            case 75: // k
+            case 80: // p
+                goToPrevious();
+                break;
+        }
+    };
+})();
+window.addEventListener('keydown', jumpToCode);