@redocly/client-generator 0.3.8 → 0.4.0

package/lib/generators/php/operations.js

@@ -0,0 +1,156 @@
+// The `operations` stage: one typed request method per operation, plus the
+// argument planning and request prologue it shares with the pagination wrappers.
+import { isMultipartBody, jsonSuccessSchema, sseResponse, uniqueIdentifiers, } from '@redocly/client-generator';
+import { envelopeHeaderSpecs } from "./descriptor.js";
+import { hydration, serialization } from "./models.js";
+import { PHP, phpString } from "./naming.js";
+import { phpElementType, phpNullable, phpType } from "./types.js";
+const MUTATING = new Set(['post', 'put', 'patch']);
+/**
+ * The argument names a request method declares beside its parameters. A parameter named
+ * after one of them takes a suffixed variable instead, so the slot keeps its meaning.
+ */
+const SIGNATURE_ARG_SLOTS = ['body', 'headers', 'idempotencyKey'];
+export function methodArgs(op, model, includeBody, dateType) {
+    // Each parameter is its own argument, so path and query names share one namespace with
+    // the slots this signature declares itself (`$body`, `$headers`, `$idempotencyKey`).
+    // A repeat moves aside (`$id`, `$id_2`): PHP rejects a redefined parameter outright, and
+    // a description may legally use one name in two locations.
+    const names = uniqueIdentifiers([...op.pathParams, ...op.queryParams].map((param) => param.name), { style: 'camel', reserved: PHP, taken: SIGNATURE_ARG_SLOTS });
+    const pathArgs = op.pathParams.map((param, index) => ({
+        php: names[index],
+        wire: param.name,
+        type: phpType(param.schema, model, dateType),
+    }));
+    const queryArgs = op.queryParams.map((param, index) => {
+        const php = names[op.pathParams.length + index];
+        return {
+            php,
+            wire: param.name,
+            type: phpType(param.schema, model, dateType),
+            value: serialization(param.schema, `${'$'}${php}`, model, dateType) ?? `${'$'}${php}`,
+        };
+    });
+    const signature = [
+        ...pathArgs.map(({ php, type }) => `${type} ${'$'}${php}`),
+        ...(includeBody && op.requestBody
+            ? [
+                `${isMultipartBody(op) ? 'array' : phpType(op.requestBody.schema, model, dateType)} ${'$'}body`,
+            ]
+            : []),
+        ...queryArgs.map(({ php, type }) => {
+            const nullable = phpNullable(type);
+            return `${nullable} ${'$'}${php} = null`;
+        }),
+        '?array $headers = null',
+        ...(includeBody && MUTATING.has(op.method.toLowerCase())
+            ? ['?string $idempotencyKey = null']
+            : []),
+    ];
+    return { pathArgs, queryArgs, signature };
+}
+/** The shared prologue: resolve auth, build query/url, merge headers. */
+function writeRequestSetup(printer, op, args) {
+    printer.line(`$op = OPERATIONS[${phpString(op.specName ?? op.name)}];`);
+    printer.line("[$authHeaders, $query, $cookies] = resolveAuth($op['security'] ?? [], $this->config->auth);");
+    for (const { php, wire, value } of args.queryArgs) {
+        printer.block(`if (${'$'}${php} !== null) {`, () => {
+            printer.line(`$query[${phpString(wire)}] = ${value};`);
+        }, '}');
+    }
+    const pathDict = args.pathArgs
+        .map(({ php, wire }) => `${phpString(wire)} => ${'$'}${php}`)
+        .join(', ');
+    printer.line(`$url = buildUrl($this->config->serverUrl, $op['path'], [${pathDict}]);`);
+    printer.line('$requestHeaders = array_merge($authHeaders, $headers ?? []);');
+    printer.block('if ($cookies !== []) {', () => {
+        printer.line("$requestHeaders['Cookie'] = implode('; ', $cookies);");
+    }, '}');
+}
+export function writePhpMethod(printer, op, ident, model, dateType, envelope = false) {
+    const args = methodArgs(op, model, true, dateType);
+    const sse = sseResponse(op);
+    const success = jsonSuccessSchema(op);
+    // Non-JSON success bodies (PDFs, images, octet streams) return the raw body string.
+    const rawBody = sse === undefined &&
+        success === undefined &&
+        op.successResponses.some((response) => response.contentType !== '');
+    const returnType = envelope
+        ? 'Envelope'
+        : sse !== undefined
+            ? '\\Generator'
+            : success !== undefined
+                ? phpType(success, model, dateType)
+                : rawBody
+                    ? 'string'
+                    : 'void';
+    const name = envelope ? `${ident}WithHeaders` : ident;
+    const element = envelope ? undefined : phpElementType(success, model, dateType);
+    printer.doc(name, envelope
+        ? `Like ${ident}(), returning an Envelope with the declared response headers.`
+        : (op.summary ?? `${op.method.toUpperCase()} ${op.path}`), element === undefined ? [] : [`@return ${element}[]`]);
+    printer.line(`public function ${name}(${args.signature.join(', ')}): ${returnType}`);
+    printer.block('{', () => {
+        writeRequestSetup(printer, op, args);
+        if (sse !== undefined) {
+            const jsonData = sse.schema !== undefined && sse.schema.kind !== 'unknown';
+            printer.line('$url = appendQuery($url, $query);');
+            printer.block('$open = function (array $extraHeaders) use ($url, $requestHeaders): \\CurlHandle {', () => {
+                printer.line('$handle = curl_init($url);');
+                printer.line('$lines = [];');
+                printer.block('foreach (array_merge($requestHeaders, $extraHeaders) as $name => $value) {', () => {
+                    printer.line("$lines[] = $name . ': ' . $value;");
+                }, '}');
+                printer.line('curl_setopt($handle, CURLOPT_HTTPHEADER, $lines);');
+                printer.line('return $handle;');
+            }, '};');
+            printer.line(`yield from iterSse($open, ${jsonData ? 'true' : 'false'});`);
+            return;
+        }
+        const request = [
+            `'operationId' => $op['id']`,
+            `'method' => $op['method']`,
+            `'url' => $url`,
+            `'headers' => $requestHeaders`,
+            `'query' => $query`,
+        ];
+        if (op.requestBody && isMultipartBody(op)) {
+            printer.line('[$contentType, $encoded] = toMultipart($body);');
+            request.push(`'body' => $encoded`, `'contentType' => $contentType`);
+        }
+        else if (op.requestBody) {
+            const wire = serialization(op.requestBody.schema, '$body', model, dateType) ?? '$body';
+            printer.line(`$payload = json_encode(${wire});`);
+            request.push(`'body' => $payload`, `'contentType' => ${phpString(op.requestBody.contentType)}`);
+        }
+        if (MUTATING.has(op.method.toLowerCase()) && op.requestBody) {
+            request.push(`'idempotencyKey' => $idempotencyKey`);
+        }
+        printer.line(`$response = send($this->config, [${request.join(', ')}]);`);
+        printer.block("if ($response['status'] >= 400) {", () => {
+            printer.line('throw apiErrorFrom($response);');
+        }, '}');
+        const decoded = rawBody
+            ? "$response['body']"
+            : ((success === undefined
+                ? undefined
+                : hydration(success, 'decodeJson($response)', model, dateType)) ??
+                'decodeJson($response)');
+        if (envelope) {
+            printer.line(`$data = ${decoded};`);
+            printer.line(`return new Envelope(data: $data, headers: readEnvelopeHeaders($response, ${envelopeHeaderSpecs(op, model)}), status: $response['status']);`);
+            return;
+        }
+        if (rawBody) {
+            printer.line("return $response['body'];");
+            return;
+        }
+        if (returnType === 'void') {
+            printer.line('decodeJson($response);');
+            return;
+        }
+        printer.line(`return ${decoded};`);
+    }, '}');
+    printer.blank();
+}
+//# sourceMappingURL=operations.js.map

package/lib/generators/php/operations.js.map

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

package/lib/generators/php/pagination.d.ts

@@ -0,0 +1,5 @@
+import { type ApiModel, type DateType, type OperationModel } from '@redocly/client-generator';
+import type { PhpPrinter } from '@redocly/client-generator/printers/php';
+/** `<op>Pages()` / `<op>Items()` generators over the runtime's iterPages. */
+export declare function writePhpPaginationWrappers(printer: PhpPrinter, op: OperationModel, ident: string, model: ApiModel, dateType: DateType, pageHydration: string | undefined, itemHydration: string | undefined, itemsPointer: string | undefined, itemYield: string): void;
+//# sourceMappingURL=pagination.d.ts.map

package/lib/generators/php/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/generators/php/pagination.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EAEb,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAMzE,6EAA6E;AAC7E,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,GAChB,IAAI,CAsGN"}

package/lib/generators/php/pagination.js

@@ -0,0 +1,68 @@
+// The `pagination` stage: the `<op>Pages()` / `<op>Items()` generator methods
+// over the runtime's iterPages.
+import { jsonSuccessSchema, } from '@redocly/client-generator';
+import { phpString } from "./naming.js";
+import { methodArgs } from "./operations.js";
+import { phpType } from "./types.js";
+/** `<op>Pages()` / `<op>Items()` generators over the runtime's iterPages. */
+export function writePhpPaginationWrappers(printer, op, ident, model, dateType, pageHydration, itemHydration, itemsPointer, itemYield) {
+    const args = methodArgs(op, model, false, dateType);
+    const name = ident;
+    const writeCall = () => {
+        printer.line(`$op = OPERATIONS[${phpString(op.specName ?? op.name)}];`);
+        printer.line('$base = [];');
+        for (const { php, wire, value } of args.queryArgs) {
+            printer.block(`if (${'$'}${php} !== null) {`, () => {
+                printer.line(`$base[${phpString(wire)}] = ${value};`);
+            }, '}');
+        }
+        const pathDict = args.pathArgs
+            .map(({ php, wire }) => `${phpString(wire)} => ${'$'}${php}`)
+            .join(', ');
+        printer.block('$call = function (array $params) use ($op, $headers): array {', () => {
+            printer.line("[$authHeaders, $authQuery, $cookies] = resolveAuth($op['security'] ?? [], $this->config->auth);");
+            printer.line(`$url = buildUrl($this->config->serverUrl, $op['path'], [${pathDict}]);`);
+            printer.line('$requestHeaders = array_merge($authHeaders, $headers ?? []);');
+            printer.block('if ($cookies !== []) {', () => {
+                printer.line("$requestHeaders['Cookie'] = implode('; ', $cookies);");
+            }, '}');
+            printer.line("$response = send($this->config, ['operationId' => $op['id'], 'method' => $op['method'], 'url' => $url, 'headers' => $requestHeaders, 'query' => array_merge($params, $authQuery)]);");
+            printer.block("if ($response['status'] >= 400) {", () => {
+                printer.line('throw apiErrorFrom($response);');
+            }, '}');
+            printer.line('return [decodeJson($response), $response];');
+        }, '};');
+    };
+    const pageType = phpType(jsonSuccessSchema(op) ?? { kind: 'unknown' }, model, dateType);
+    const pageYield = pageType === 'mixed' ? 'mixed' : pageType;
+    printer.line('/**');
+    printer.line(` * ${name} response pages, following the pagination rule automatically.`);
+    printer.line(' *');
+    printer.line(` * @return \\Generator<int, ${pageYield}>`);
+    printer.line(' */');
+    printer.line(`public function ${name}Pages(${args.signature.join(', ')}): \\Generator`);
+    printer.block('{', () => {
+        writeCall();
+        printer.block("foreach (iterPages($call, $op['pagination'], $base) as $page) {", () => {
+            printer.line(`yield ${pageHydration ?? '$page'};`);
+        }, '}');
+    }, '}');
+    printer.blank();
+    printer.line('/**');
+    printer.line(` * The items of every ${name} page.`);
+    printer.line(' *');
+    printer.line(` * @return \\Generator<int, ${itemYield}>`);
+    printer.line(' */');
+    printer.line(`public function ${name}Items(${args.signature.join(', ')}): \\Generator`);
+    printer.block('{', () => {
+        writeCall();
+        printer.block("foreach (iterPages($call, $op['pagination'], $base) as $page) {", () => {
+            printer.line(`$items = resolvePointer($page, ${phpString(itemsPointer ?? '')});`);
+            printer.block('foreach (is_array($items) ? $items : [] as $item) {', () => {
+                printer.line(`yield ${itemHydration ?? '$item'};`);
+            }, '}');
+        }, '}');
+    }, '}');
+    printer.blank();
+}
+//# sourceMappingURL=pagination.js.map

package/lib/generators/php/pagination.js.map

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

package/lib/generators/php/types.d.ts

@@ -0,0 +1,27 @@
+import { type ApiModel, type DateType, type SchemaModel } from '@redocly/client-generator';
+/** What a named schema renders as: a class, a native enum, or nothing (alias). */
+export declare function classify(name: string, model: ApiModel): 'class' | 'enum' | 'other';
+/** The PHP type declaration for a schema (arrays and unions widen to array/mixed). */
+export declare function phpType(schema: SchemaModel, model: ApiModel, dateType?: DateType): string;
+/** `date` or `date-time` — the two formats `dateType: Date` turns into objects. */
+export declare function isDateFormat(schema: SchemaModel): boolean;
+/**
+ * The nullable form of a PHP type. `?T` for a single type, `A|B|null` for a union — PHP
+ * forbids mixing `?` with `|`, and `mixed` already includes null.
+ */
+export declare function phpNullable(type: string): string;
+/**
+ * A union as a native PHP 8.1 union type (`int|string`, `PromotionType|array`). Rich list
+ * filters are usually unions, and collapsing them to `mixed` throws away the typing that
+ * makes the SDK worth generating. `mixed` cannot be a union member, so a member without a
+ * PHP type of its own (inline object, intersection, unknown) forces the whole union to
+ * `mixed`. Members that map to the same PHP type collapse to one.
+ */
+export declare function phpUnionType(members: SchemaModel[], model: ApiModel, dateType: DateType): string;
+/**
+ * The element type behind a PHP type that erases it. `array` and `\Generator` are as
+ * specific as PHP's syntax gets, so the docblock carries what they hold — that is what
+ * static analysis and readers actually go by.
+ */
+export declare function phpElementType(schema: SchemaModel | undefined, model: ApiModel, dateType: DateType): string | undefined;
+//# sourceMappingURL=types.d.ts.map

package/lib/generators/php/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/generators/php/types.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EAKb,KAAK,WAAW,EAEjB,MAAM,2BAA2B,CAAC;AAInC,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAelF;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CACrB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,QAAQ,EACf,QAAQ,GAAE,QAAmB,GAC5B,MAAM,CA0CR;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAGzD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAchG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,GACjB,MAAM,GAAG,SAAS,CAapB"}

package/lib/generators/php/types.js

@@ -0,0 +1,128 @@
+// The `types` stage: the PHP type declaration for a schema, its nullable and
+// union forms, and the element type PHP's own syntax erases.
+import { deref, enumValues, flattenAllOf, isNullable, unwrapNullable, } from '@redocly/client-generator';
+import { className } from "./naming.js";
+/** What a named schema renders as: a class, a native enum, or nothing (alias). */
+export function classify(name, model) {
+    const named = model.schemas.find((candidate) => candidate.name === name);
+    if (named === undefined)
+        return 'other';
+    const schema = named.schema;
+    const asEnum = enumValues(schema);
+    if (asEnum !== undefined && (asEnum.scalar === 'string' || asEnum.scalar === 'integer')) {
+        return 'enum';
+    }
+    if ((schema.kind === 'object' || schema.kind === 'intersection') &&
+        flattenAllOf(schema, model) !== undefined) {
+        return 'class';
+    }
+    return 'other';
+}
+/** The PHP type declaration for a schema (arrays and unions widen to array/mixed). */
+export function phpType(schema, model, dateType = 'string') {
+    if (isNullable(schema)) {
+        const inner = phpType(unwrapNullable(schema), model, dateType);
+        return phpNullable(inner);
+    }
+    switch (schema.kind) {
+        case 'scalar':
+            // Under `dateType: Date`, date and date-time become DateTimeImmutable — PHP's
+            // immutable date object parses and formats both wire shapes.
+            if (dateType === 'Date' && schema.scalar === 'string' && isDateFormat(schema)) {
+                return '\\DateTimeImmutable';
+            }
+            return { string: 'string', integer: 'int', number: 'float', boolean: 'bool' }[schema.scalar];
+        case 'array':
+        case 'record':
+            return 'array';
+        case 'ref': {
+            const kind = classify(schema.name, model);
+            if (kind === 'class' || kind === 'enum')
+                return className(schema.name);
+            const target = deref(schema, model);
+            return target === undefined ? 'mixed' : phpType(target, model, dateType);
+        }
+        case 'enum':
+            // Anonymous (inline) enums keep the wire scalar; only NAMED enums get types.
+            return { string: 'string', integer: 'int', number: 'float', boolean: 'bool' }[schema.scalar];
+        case 'literal':
+            return typeof schema.value === 'string'
+                ? 'string'
+                : typeof schema.value === 'boolean'
+                    ? 'bool'
+                    : 'float';
+        case 'omit':
+            // PHP has no Omit; the base class is the honest annotation.
+            return className(schema.base);
+        case 'union':
+            return phpUnionType(schema.members, model, dateType);
+        case 'null':
+        case 'object':
+        case 'intersection':
+        case 'unknown':
+            return 'mixed';
+    }
+}
+/** `date` or `date-time` — the two formats `dateType: Date` turns into objects. */
+export function isDateFormat(schema) {
+    const format = schema.metadata?.format;
+    return format === 'date' || format === 'date-time';
+}
+/**
+ * The nullable form of a PHP type. `?T` for a single type, `A|B|null` for a union — PHP
+ * forbids mixing `?` with `|`, and `mixed` already includes null.
+ */
+export function phpNullable(type) {
+    if (type === 'mixed' || type.startsWith('?') || type.endsWith('|null'))
+        return type;
+    return type.includes('|') ? `${type}|null` : `?${type}`;
+}
+/**
+ * A union as a native PHP 8.1 union type (`int|string`, `PromotionType|array`). Rich list
+ * filters are usually unions, and collapsing them to `mixed` throws away the typing that
+ * makes the SDK worth generating. `mixed` cannot be a union member, so a member without a
+ * PHP type of its own (inline object, intersection, unknown) forces the whole union to
+ * `mixed`. Members that map to the same PHP type collapse to one.
+ */
+export function phpUnionType(members, model, dateType) {
+    const rendered = [];
+    for (const member of members) {
+        // `null` is handled by the caller's nullability check, never as a member here.
+        if (member.kind === 'null')
+            continue;
+        const type = phpType(member, model, dateType);
+        if (type === 'mixed')
+            return 'mixed';
+        // A nullable member inside a union contributes its bare type plus null.
+        const bare = type.startsWith('?') ? type.slice(1) : type;
+        if (!rendered.includes(bare))
+            rendered.push(bare);
+        if (type.startsWith('?') && !rendered.includes('null'))
+            rendered.push('null');
+    }
+    if (rendered.length === 0)
+        return 'mixed';
+    return rendered.join('|');
+}
+/**
+ * The element type behind a PHP type that erases it. `array` and `\Generator` are as
+ * specific as PHP's syntax gets, so the docblock carries what they hold — that is what
+ * static analysis and readers actually go by.
+ */
+export function phpElementType(schema, model, dateType) {
+    if (schema === undefined)
+        return undefined;
+    const bare = unwrapNullable(schema);
+    if (bare.kind === 'ref') {
+        const target = deref(bare, model);
+        // A named schema that IS an array (a collection alias) keeps its element type.
+        return classify(bare.name, model) === 'other'
+            ? phpElementType(target, model, dateType)
+            : undefined;
+    }
+    if (bare.kind !== 'array')
+        return undefined;
+    const element = phpType(bare.items, model, dateType);
+    return element === 'mixed' ? undefined : element;
+}
+//# sourceMappingURL=types.js.map

package/lib/generators/php/types.js.map

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

package/lib/generators/python/client.d.ts

@@ -0,0 +1,6 @@
+import { type ApiModel, type DateType } from '@redocly/client-generator';
+import type { PythonPrinter } from '@redocly/client-generator/printers/python';
+/** One static method per declared server; server variables become keyword arguments. */
+export declare function writePythonServers(printer: PythonPrinter, model: ApiModel): void;
+export declare function writeClientClass(printer: PythonPrinter, model: ApiModel, errorMode: 'throw' | 'result', isAsync: boolean, paginationSpecs: Map<string, Record<string, unknown> | undefined>, serverUrl: string, dateType: DateType): void;
+//# sourceMappingURL=client.d.ts.map

package/lib/generators/python/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/generators/python/client.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EAOd,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAe/E,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CA2BhF;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,OAAO,GAAG,QAAQ,EAC7B,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,EACjE,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,GACjB,IAAI,CAoDN"}

package/lib/generators/python/client.js

@@ -0,0 +1,80 @@
+// The `client` stage: the `Servers` helper class and the `Client`/`AsyncClient`
+// classes that assemble the per-operation methods.
+import { identifierFor, jsonSuccessSchema, paginationItemSchema, serverUrlParts, sseResponse, } from '@redocly/client-generator';
+import { fieldName, naming, operationIdents, PY } from "./naming.js";
+import { writeMethod } from "./operations.js";
+import { writePaginationWrappers } from "./pagination.js";
+import { pythonType } from "./types.js";
+/** The server URL as a Python expression: literals concatenated with declared-variable args. */
+function serverUrlExpression(server) {
+    const parts = serverUrlParts(server).map((part) => part.kind === 'literal' ? naming.string(part.value) : fieldName(part.name).python);
+    return parts.join(' + ');
+}
+/** One static method per declared server; server variables become keyword arguments. */
+export function writePythonServers(printer, model) {
+    const servers = model.servers ?? [];
+    if (servers.length === 0)
+        return;
+    const usedNames = new Set();
+    printer.block('class Servers:', () => {
+        printer.line('"""The declared servers; variables default to the values from the description."""');
+        printer.blank();
+        servers.forEach((server, index) => {
+            let name = identifierFor(server.description ?? `server${index + 1}`, {
+                style: 'snake',
+                reserved: PY,
+            });
+            if (usedNames.has(name))
+                name = `${name}_${index + 1}`;
+            usedNames.add(name);
+            const params = server.variables.map((variable) => `${fieldName(variable.name).python}: str = ${naming.string(variable.default)}`);
+            if (index > 0)
+                printer.blank();
+            printer.line('@staticmethod');
+            printer.block(`def ${name}(${params.join(', ')}) -> str:`, () => {
+                printer.line(`return ${serverUrlExpression(server)}`);
+            });
+        });
+    });
+    printer.blank();
+}
+export function writeClientClass(printer, model, errorMode, isAsync, paginationSpecs, serverUrl, dateType) {
+    const name = isAsync ? 'AsyncClient' : 'Client';
+    const httpType = isAsync ? 'httpx.AsyncClient' : 'httpx.Client';
+    printer.block(`class ${name}:`, () => {
+        printer.doc(`${isAsync ? 'Async ' : ''}client for ${model.title} (${model.version}).`);
+        printer.block(`def __init__(self, server_url: str = ${naming.string(serverUrl)}, *, ` +
+            'auth: Optional[Dict[str, Any]] = None, headers: Optional[Dict[str, str]] = None, ' +
+            'timeout: Optional[float] = None, retry: Optional[Dict[str, Any]] = None, ' +
+            'middleware: Optional[List[Any]] = None, idempotency_key: Any = None, ' +
+            `http_client: Optional[${httpType}] = None) -> None:`, () => {
+            printer.line('self._server_url = server_url');
+            printer.line('self._auth = auth or {}');
+            printer.line('self._config: Dict[str, Any] = {');
+            printer.indent(() => {
+                printer.line('"headers": headers or {},');
+                printer.line('"timeout": timeout,');
+                printer.line('"retry": retry or {},');
+                printer.line('"middleware": middleware or [],');
+                printer.line('"idempotency_key": idempotency_key,');
+            });
+            printer.line('}');
+            printer.line(`self._http = http_client or ${httpType}()`);
+        });
+        printer.blank();
+        for (const { op, ident } of operationIdents(model)) {
+            writeMethod(printer, op, ident, errorMode, isAsync, dateType);
+            if (sseResponse(op) === undefined && (op.successResponseHeaders?.length ?? 0) > 0) {
+                writeMethod(printer, op, ident, errorMode, isAsync, dateType, model, true);
+            }
+            const spec = paginationSpecs.get(ident);
+            if (spec !== undefined) {
+                const success = jsonSuccessSchema(op);
+                const element = paginationItemSchema(success, typeof spec.items === 'string' ? spec.items : undefined, model);
+                writePaginationWrappers(printer, op, ident, isAsync, element === undefined ? 'Any' : pythonType(element, dateType), dateType);
+            }
+        }
+    });
+    printer.blank();
+}
+//# sourceMappingURL=client.js.map

package/lib/generators/python/client.js.map

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

package/lib/generators/python/descriptor.d.ts

@@ -0,0 +1,9 @@
+import { type ApiModel, type NeutralPaginationRule, type OperationModel } from '@redocly/client-generator';
+/** JSON → Python literal (dicts/lists/strings/numbers/bools/None). */
+export declare function pythonLiteral(value: unknown): string;
+/** The resolved pagination rule mapped to the snake_case spec dict the embedded
+ * Python runtime consumes. */
+export declare function paginationSpec(rule: NeutralPaginationRule | undefined): Record<string, unknown> | undefined;
+/** Declared response headers as runtime coerce specs: `("wire-name", "snake_key", "type")`. */
+export declare function envelopeHeaderSpecs(op: OperationModel, model: ApiModel): string;
+//# sourceMappingURL=descriptor.d.ts.map

package/lib/generators/python/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../src/generators/python/descriptor.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,QAAQ,EAGb,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAInC,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED;8BAC8B;AAC9B,wBAAgB,cAAc,CAC5B,IAAI,EAAE,qBAAqB,GAAG,SAAS,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAUrC;AAED,+FAA+F;AAC/F,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAY/E"}

package/lib/generators/python/descriptor.js

@@ -0,0 +1,38 @@
+// The `descriptor` stage: the wire-shape literals the embedded runtime routes by —
+// pagination specs, envelope-header coerce specs, and Python data literals.
+import { headerCoerceType, identifierFor, } from '@redocly/client-generator';
+import { naming, PY } from "./naming.js";
+/** JSON → Python literal (dicts/lists/strings/numbers/bools/None). */
+export function pythonLiteral(value) {
+    return naming.literal(value);
+}
+/** The resolved pagination rule mapped to the snake_case spec dict the embedded
+ * Python runtime consumes. */
+export function paginationSpec(rule) {
+    if (rule === undefined)
+        return undefined;
+    return {
+        style: rule.style,
+        ...(rule.param !== undefined ? { param: rule.param } : {}),
+        ...(rule.nextCursor !== undefined ? { next_cursor: rule.nextCursor } : {}),
+        ...(rule.hasMore !== undefined ? { has_more: rule.hasMore } : {}),
+        ...(rule.limitParam !== undefined ? { limit_param: rule.limitParam } : {}),
+        ...(rule.items !== undefined ? { items: rule.items } : {}),
+    };
+}
+/** Declared response headers as runtime coerce specs: `("wire-name", "snake_key", "type")`. */
+export function envelopeHeaderSpecs(op, model) {
+    const used = new Set();
+    const specs = (op.successResponseHeaders ?? []).map((header) => {
+        const base = identifierFor(header.name, { style: 'snake', reserved: PY });
+        let key = base;
+        let suffix = 2;
+        while (used.has(key))
+            key = `${base}_${suffix++}`;
+        used.add(key);
+        const type = headerCoerceType(header.schema, model);
+        return `(${naming.string(header.name)}, ${naming.string(key)}, ${naming.string(type)})`;
+    });
+    return `[${specs.join(', ')}]`;
+}
+//# sourceMappingURL=descriptor.js.map

package/lib/generators/python/descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../../../src/generators/python/descriptor.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,4EAA4E;AAE5E,OAAO,EAEL,gBAAgB,EAChB,aAAa,GAGd,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEzC,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;8BAC8B;AAC9B,MAAM,UAAU,cAAc,CAC5B,IAAuC;IAEvC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,mBAAmB,CAAC,EAAkB,EAAE,KAAe;IACrE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7D,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1E,IAAI,GAAG,GAAG,IAAI,CAAC;QACf,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,GAAG,GAAG,GAAG,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC;QAClD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IAC1F,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACjC,CAAC"}

package/lib/generators/python/index.d.ts

@@ -0,0 +1,15 @@
+import { type CodeSample, type Generator, type GeneratorOptionsSchema, type OperationModel, type SampleContext } from '@redocly/client-generator';
+export { renderPythonModels, type PythonModels } from './models.ts';
+export { pythonType } from './types.ts';
+export declare const pythonOptions: GeneratorOptionsSchema;
+/** The whole generated file: header, models, embedded runtime, descriptors, clients. */
+export declare const pythonGenerator: Generator;
+/** One idiomatic Python call per operation — feeds `x-codeSamples` for docs. */
+export declare function pythonSample(op: OperationModel, ctx: SampleContext): CodeSample;
+/**
+ * The SDK's own reference page, written when `client.docs` is on. The call snippets come
+ * from `pythonSample` — this generator's own hook — so the page can only ever show the syntax
+ * of the SDK beside it, and ejecting this generator takes the page with it.
+ */
+export declare const pythonDocs: Generator;
+//# sourceMappingURL=index.d.ts.map

package/lib/generators/python/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/python/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,sBAAsB,EAE3B,KAAK,cAAc,EAEnB,KAAK,aAAa,EAEnB,MAAM,2BAA2B,CAAC;AAcnC,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,eAAO,MAAM,aAAa,EAAE,sBAW3B,CAAC;AAgBF,wFAAwF;AACxF,eAAO,MAAM,eAAe,EAAE,SAqH7B,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,aAAa,GAAG,UAAU,CA6B/E;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAgBxB,CAAC"}