@redocly/client-generator 0.3.7 → 0.4.0

package/lib/generators/python/index.js

@@ -0,0 +1,197 @@
+// The built-in `python` generator — the first non-TypeScript library entry,
+// authored the way the AGENTS.md skill teaches users' agents to author theirs:
+// with the language-neutral toolkit only (Printer + schema/naming helpers).
+// A guard test pins that this module never imports the TS emitter toolkit.
+// One file per pipeline stage (ADR-0020); this entry assembles them.
+import { identifierFor, renderReferencePage, securityRequirements, } from '@redocly/client-generator';
+import { PythonPrinter } from '@redocly/client-generator/printers/python';
+import { PYTHON_RUNTIME_SOURCES } from '@redocly/client-generator/runtime-sources';
+import { writeClientClass, writePythonServers } from "./client.js";
+import { paginationSpec, pythonLiteral } from "./descriptor.js";
+import { discriminatorRegistrations, pydanticDiscriminators, renderPythonModels, } from "./models.js";
+import { operationIdents, PY } from "./naming.js";
+export { renderPythonModels } from "./models.js";
+export { pythonType } from "./types.js";
+export const pythonOptions = {
+    type: 'object',
+    properties: {
+        models: {
+            enum: ['dataclass', 'pydantic'],
+            default: 'dataclass',
+            description: 'Model style: standard-library dataclasses (default, httpx is the only dependency), or pydantic BaseModel classes (adds pydantic).',
+        },
+    },
+    additionalProperties: false,
+};
+/**
+ * The output path with an IMPORTABLE module name. The `--output` stem follows the
+ * TypeScript convention (`openapi.client.ts`), and `openapi.client.py` cannot be
+ * imported by name — nor can a hyphen or a leading digit — so the stem is converted
+ * to a legal module identifier (`openapi_client.py`). The directory is untouched.
+ */
+function pythonModulePath(outputPath) {
+    const separator = outputPath.lastIndexOf('/') >= 0 ? '/' : '\\';
+    const cut = outputPath.lastIndexOf(separator);
+    const dir = cut >= 0 ? outputPath.slice(0, cut + 1) : '';
+    const stem = (cut >= 0 ? outputPath.slice(cut + 1) : outputPath).replace(/\.[^.]+$/, '');
+    return `${dir}${identifierFor(stem, { style: 'snake', reserved: PY })}.py`;
+}
+/** The whole generated file: header, models, embedded runtime, descriptors, clients. */
+export const pythonGenerator = ({ model, output, banner, emit, options, pagination, }) => {
+    const errorMode = emit.errorMode ?? 'throw';
+    const dateType = emit.dateType ?? 'string';
+    const models = options?.models ?? 'dataclass';
+    const pydantic = models === 'pydantic' ? pydanticDiscriminators(model) : undefined;
+    const printer = new PythonPrinter();
+    printer.line(`# Generated by @redocly/client-generator (python) from "${model.title}" ${model.version}.`);
+    printer.line('# Do not edit by hand — regenerate with `redocly generate-client`.');
+    printer.line(models === 'pydantic'
+        ? '# Requires Python >= 3.9, httpx, and pydantic: pip install httpx pydantic'
+        : '# Requires Python >= 3.9 and httpx: pip install httpx');
+    printer.blank();
+    // Models (with the shared imports header).
+    printer.line(renderPythonModels(model, dateType, models).trimEnd());
+    printer.blank();
+    printer.blank();
+    writePythonServers(printer, model);
+    if (emit.runtime === 'module') {
+        // The runtime lives in real sibling modules; star imports rebind the same
+        // public names the inline stitching would have defined at this position.
+        printer.line('# ─── Runtime (real modules beside this file, written by the same run) ───');
+        for (const name of Object.keys(PYTHON_RUNTIME_SOURCES)) {
+            printer.line(`from ${name.replace(/\.py$/, '')} import *`);
+        }
+        printer.blank();
+        printer.blank();
+    }
+    else {
+        // The embedded runtime, stitched into one module: `from __future__` may appear
+        // only at the top of a file, and the intra-runtime relative imports resolve to
+        // this same file — both are dropped; duplicate stdlib imports are legal Python.
+        printer.line('# ─── Embedded runtime (@redocly/client-generator python runtime) ───');
+        for (const source of Object.values(PYTHON_RUNTIME_SOURCES)) {
+            const stitched = source
+                .split('\n')
+                .filter((line) => !line.startsWith('from __future__') && !line.startsWith('from ._'))
+                .join('\n')
+                .trim();
+            printer.line(stitched);
+            printer.blank();
+        }
+        printer.blank();
+    }
+    const registrations = discriminatorRegistrations(model, new Set(pydantic?.unions.keys()));
+    if (registrations.length > 0) {
+        printer.line('# Discriminated unions dispatch by their property inside decode().');
+        for (const registration of registrations)
+            printer.line(registration);
+        printer.blank();
+    }
+    printer.block('def _safe_json(response: httpx.Response) -> Any:', () => {
+        printer.block('try:', () => {
+            printer.line('return response.json()');
+        });
+        printer.block('except Exception:', () => {
+            printer.line('return None');
+        });
+    });
+    printer.blank();
+    // The wire-shape descriptor table the runtime routes by.
+    const paginationSpecs = new Map();
+    for (const { op, ident } of operationIdents(model)) {
+        paginationSpecs.set(ident, paginationSpec(pagination?.get(op.name)?.spec));
+    }
+    printer.line('_OPERATIONS = {');
+    printer.indent(() => {
+        for (const { op, ident } of operationIdents(model)) {
+            const descriptor = {
+                id: op.specName ?? op.name,
+                method: op.method.toUpperCase(),
+                path: op.path,
+                ...(securityRequirements(op, model).length > 0
+                    ? { security: securityRequirements(op, model) }
+                    : {}),
+                ...(paginationSpecs.get(ident) !== undefined
+                    ? { pagination: paginationSpecs.get(ident) }
+                    : {}),
+            };
+            printer.line(`"${ident}": ${pythonLiteral(descriptor)},`);
+        }
+    });
+    printer.line('}');
+    printer.blank();
+    printer.blank();
+    // The `serverUrl` option overrides the description's server, like the TS sdk.
+    const serverUrl = emit.serverUrl ?? model.serverUrl ?? '';
+    writeClientClass(printer, model, errorMode, false, paginationSpecs, serverUrl, dateType);
+    writeClientClass(printer, model, errorMode, true, paginationSpecs, serverUrl, dateType);
+    const entry = { path: pythonModulePath(output.path), content: printer.toString() };
+    if (emit.runtime !== 'module')
+        return [entry];
+    // The runtime modules, verbatim except the package-relative imports: the flat
+    // sibling layout has no package, so `from ._x` becomes the sibling `from _x`.
+    const header = banner.map((line) => `# ${line}`).join('\n');
+    const dir = pythonModulePath(output.path).replace(/[^\\/]+$/, '');
+    const runtimeFiles = Object.entries(PYTHON_RUNTIME_SOURCES).map(([name, source]) => ({
+        path: `${dir}${name}`,
+        content: `${header}\n\n${source
+            .split('\n')
+            .map((line) => (line.startsWith('from ._') ? line.replace('from ._', 'from _') : line))
+            .join('\n')
+            .trim()}\n`,
+    }));
+    return [entry, ...runtimeFiles];
+};
+/** One idiomatic Python call per operation — feeds `x-codeSamples` for docs. */
+export function pythonSample(op, ctx) {
+    // The module name this run writes, not a guess: `openapi.client.ts` becomes
+    // `openapi_client.py`, so `from client import Client` would not import.
+    const module = pythonModulePath(ctx.outputPath)
+        .replace(/^.*[\\/]/, '')
+        .replace(/\.py$/, '');
+    // The DEDUPED name: on a collision the method is `get_user_2`, and a snippet naming
+    // the raw `get_user` would show a call that goes to a different operation.
+    const ident = operationIdents(ctx.model).find((entry) => entry.op.name === op.name)?.ident ??
+        identifierFor(op.name, { style: 'snake', reserved: PY });
+    const args = [
+        ...op.pathParams.map((param) => {
+            const python = identifierFor(param.name, { style: 'snake', reserved: PY });
+            return `${python}="<${python}>"`;
+        }),
+        ...op.queryParams
+            .filter((param) => param.required)
+            .map((param) => {
+            const python = identifierFor(param.name, { style: 'snake', reserved: PY });
+            return `${python}=...`;
+        }),
+        ...(op.requestBody ? ['body=...'] : []),
+    ];
+    return {
+        lang: 'python',
+        label: 'Python SDK',
+        source: `from ${module} import Client\n\nclient = Client()\nresult = client.${ident}(${args.join(', ')})\n`,
+    };
+}
+/**
+ * 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 const pythonDocs = ({ model, output, emit, pagination }) => [
+    {
+        path: output.path.replace(/\.[^.\\/]+$/, '.python.md'),
+        content: renderReferencePage(model, {
+            title: `${model.title} Python SDK reference`,
+            frontmatter: emit.docsFrontmatter === true,
+            language: {
+                name: 'python',
+                label: 'Python',
+                fence: 'python',
+                requires: 'The SDK needs `httpx`.',
+            },
+            sample: (op) => pythonSample(op, { model, emit, outputPath: output.path }),
+            paginated: new Set(pagination?.keys() ?? []),
+        }),
+    },
+];
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,31 @@
+import { type ApiModel, type DateType } from '@redocly/client-generator';
+/** The model style the generator emits: plain dataclasses, or pydantic `BaseModel`s. */
+export type PythonModels = 'dataclass' | 'pydantic';
+/** The wire property and value a union's discriminator mapping pins on one member class. */
+export type DiscriminatorPin = {
+    property: string;
+    value: string;
+};
+/**
+ * Under `models: pydantic` the decoder hands a whole object tree to `model_validate`, so a
+ * union nested in a model is resolved by pydantic and never reaches the `DISCRIMINATORS`
+ * table. Pydantic resolves it correctly when the annotation carries the discriminator, which
+ * it accepts only if every member types that property as a `Literal` — and the mapping
+ * already pins one value per member. This pass works out which unions qualify: every member
+ * must declare the property, and no member may be pinned to two different values (a schema
+ * reused by two unions).
+ */
+export declare function pydanticDiscriminators(model: ApiModel): {
+    pins: Map<string, DiscriminatorPin>;
+    unions: Map<string, string>;
+};
+/** Render every named schema: Enum classes, dataclasses (allOf flattened), union aliases. */
+export declare function renderPythonModels(model: ApiModel, dateType?: DateType, models?: PythonModels): string;
+/**
+ * `DISCRIMINATORS[Pet] = ("petType", {"cat": Cat, ...})` registration lines, which `decode`
+ * dispatches through. A union whose annotation already carries the discriminator is left
+ * out: pydantic resolves it at any depth, and the `Literal` on each member makes the
+ * decoder's member probe exact.
+ */
+export declare function discriminatorRegistrations(model: ApiModel, annotated: Set<string>): string[];
+//# sourceMappingURL=models.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../src/generators/python/models.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EAKd,MAAM,2BAA2B,CAAC;AAMnC,wFAAwF;AACxF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,UAAU,CAAC;AAEpD,4FAA4F;AAC5F,MAAM,MAAM,gBAAgB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,GAAG;IACvD,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,CAmCA;AA0DD,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,QAAQ,EACf,QAAQ,GAAE,QAAmB,EAC7B,MAAM,GAAE,YAA0B,GACjC,MAAM,CAmFR;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAc5F"}

package/lib/generators/python/models.js

@@ -0,0 +1,203 @@
+// The `models` stage: named schemas as Enum classes, dataclasses/pydantic models
+// (allOf flattened), union aliases, and the decoder's discriminator registrations.
+import { discriminatorCases, enumValues, flattenAllOf, } from '@redocly/client-generator';
+import { PythonPrinter } from '@redocly/client-generator/printers/python';
+import { className, fieldName, naming } from "./naming.js";
+import { pythonType } from "./types.js";
+/**
+ * Under `models: pydantic` the decoder hands a whole object tree to `model_validate`, so a
+ * union nested in a model is resolved by pydantic and never reaches the `DISCRIMINATORS`
+ * table. Pydantic resolves it correctly when the annotation carries the discriminator, which
+ * it accepts only if every member types that property as a `Literal` — and the mapping
+ * already pins one value per member. This pass works out which unions qualify: every member
+ * must declare the property, and no member may be pinned to two different values (a schema
+ * reused by two unions).
+ */
+export function pydanticDiscriminators(model) {
+    const pins = new Map();
+    const conflicted = new Set();
+    const candidates = [];
+    for (const { name, schema } of model.schemas) {
+        const cases = discriminatorCases(schema, model);
+        if (cases === undefined)
+            continue;
+        const declares = cases.cases.every((entry) => flattenAllOf(entry.schema, model)?.properties.some((property) => property.name === cases.property) === true);
+        if (!declares)
+            continue;
+        for (const entry of cases.cases) {
+            const existing = pins.get(entry.schemaName);
+            if (existing !== undefined && existing.value !== entry.value) {
+                conflicted.add(entry.schemaName);
+                continue;
+            }
+            pins.set(entry.schemaName, { property: cases.property, value: entry.value });
+        }
+        candidates.push({
+            name,
+            property: cases.property,
+            members: cases.cases.map((entry) => entry.schemaName),
+        });
+    }
+    const unions = new Map();
+    for (const candidate of candidates) {
+        if (candidate.members.some((member) => conflicted.has(member)))
+            continue;
+        unions.set(candidate.name, fieldName(candidate.property).python);
+    }
+    for (const member of conflicted)
+        pins.delete(member);
+    return { pins, unions };
+}
+function writeDataclass(printer, name, properties, dateType, models, description, 
+/** The discriminator value this class is mapped to, pinned as a `Literal` (pydantic). */
+pinned) {
+    const pydantic = models === 'pydantic';
+    if (!pydantic)
+        printer.line('@dataclass');
+    const header = pydantic ? `class ${className(name)}(BaseModel):` : `class ${className(name)}:`;
+    printer.block(header, () => {
+        printer.doc(description);
+        // A wire name that is not a legal field name travels as an alias, so the model
+        // accepts both spellings; without this, populating by field name would fail.
+        if (pydantic) {
+            printer.line('model_config = ConfigDict(populate_by_name=True)');
+            printer.blank();
+        }
+        // Required fields first — a dataclass field without a default may not follow one with.
+        const ordered = [
+            ...properties.filter((property) => property.required),
+            ...properties.filter((property) => !property.required),
+        ];
+        const fieldMap = [];
+        if (ordered.length === 0)
+            printer.line('pass');
+        for (const property of ordered) {
+            const { python, renamed } = fieldName(property.name);
+            if (renamed && !pydantic)
+                fieldMap.push([python, property.name]);
+            const alias = renamed && pydantic ? `alias=${naming.string(property.name)}` : undefined;
+            const baseType = pinned?.property === property.name
+                ? `Literal[${naming.literal(pinned.value)}]`
+                : pythonType(property.schema, dateType);
+            if (property.required) {
+                const value = alias === undefined ? '' : ` = Field(${alias})`;
+                printer.line(`${python}: ${baseType}${value}`);
+            }
+            else {
+                const optional = baseType.startsWith('Optional[') ? baseType : `Optional[${baseType}]`;
+                const value = alias === undefined ? 'None' : `Field(default=None, ${alias})`;
+                printer.line(`${python}: ${optional} = ${value}`);
+            }
+        }
+        if (fieldMap.length > 0) {
+            printer.blank();
+            printer.line('# Python field name -> wire (JSON) name, for (de)serialization.');
+            const entries = fieldMap.map(([py, wire]) => `"${py}": ${naming.string(wire)}`).join(', ');
+            printer.line(`_field_map: ClassVar[Dict[str, str]] = {${entries}}`);
+        }
+    });
+    printer.blank();
+    printer.blank();
+}
+/** Render every named schema: Enum classes, dataclasses (allOf flattened), union aliases. */
+export function renderPythonModels(model, dateType = 'string', models = 'dataclass') {
+    const printer = new PythonPrinter();
+    const { pins, unions } = models === 'pydantic'
+        ? pydanticDiscriminators(model)
+        : { pins: new Map(), unions: new Map() };
+    printer.line('from __future__ import annotations');
+    printer.blank();
+    if (models === 'dataclass')
+        printer.line('from dataclasses import dataclass');
+    printer.line('from enum import Enum');
+    // `ClassVar` types the `_field_map` of a dataclass model, which pydantic mode
+    // replaces with field aliases — importing it there would be an unused import.
+    const typingNames = [
+        'Any',
+        'AsyncIterator',
+        'Dict',
+        'Iterator',
+        'List',
+        'Literal',
+        'Optional',
+        'Tuple',
+        'Union',
+    ];
+    if (models === 'dataclass')
+        typingNames.splice(2, 0, 'ClassVar');
+    if (unions.size > 0)
+        typingNames.unshift('Annotated');
+    printer.line(`from typing import ${typingNames.join(', ')}`);
+    if (models === 'pydantic')
+        printer.line('from pydantic import BaseModel, ConfigDict, Field');
+    // Only under `dateType: Date` — an unused import in every other client would be noise.
+    if (dateType === 'Date')
+        printer.line('from datetime import date, datetime');
+    printer.blank();
+    printer.blank();
+    const aliases = [];
+    for (const { name, schema } of model.schemas) {
+        const asEnum = enumValues(schema);
+        if (asEnum !== undefined) {
+            const base = asEnum.scalar === 'string' ? 'str, Enum' : 'int, Enum';
+            printer.block(`class ${className(name)}(${base}):`, () => {
+                printer.doc(schema.description);
+                asEnum.values.forEach((value, index) => {
+                    printer.line(`${asEnum.memberNames[index]} = ${naming.literal(value)}`);
+                });
+            });
+            printer.blank();
+            printer.blank();
+            continue;
+        }
+        if (schema.kind === 'object' || schema.kind === 'intersection') {
+            const flat = flattenAllOf(schema, model);
+            if (flat !== undefined) {
+                writeDataclass(printer, name, flat.properties, dateType, models, flat.description ?? schema.description, pins.get(name));
+                continue;
+            }
+        }
+        // Everything else (unions, scalar aliases, records) becomes a module-level alias,
+        // emitted AFTER the classes it references so the assignment evaluates.
+        aliases.push(() => {
+            const cases = discriminatorCases(schema, model);
+            if (cases !== undefined) {
+                const table = cases.cases
+                    .map((entry) => `${entry.value} -> ${className(entry.schemaName)}`)
+                    .join(', ');
+                printer.line(`# Discriminated by "${cases.property}": ${table}`);
+            }
+            const field = unions.get(name);
+            const union = field === undefined
+                ? pythonType(schema, dateType)
+                : `Annotated[${pythonType(schema, dateType)}, Field(discriminator=${naming.string(field)})]`;
+            printer.line(`${className(name)} = ${union}`);
+            printer.blank();
+        });
+    }
+    for (const emit of aliases)
+        emit();
+    return printer.toString();
+}
+/**
+ * `DISCRIMINATORS[Pet] = ("petType", {"cat": Cat, ...})` registration lines, which `decode`
+ * dispatches through. A union whose annotation already carries the discriminator is left
+ * out: pydantic resolves it at any depth, and the `Literal` on each member makes the
+ * decoder's member probe exact.
+ */
+export function discriminatorRegistrations(model, annotated) {
+    const lines = [];
+    for (const { name, schema } of model.schemas) {
+        if (annotated.has(name))
+            continue;
+        const cases = discriminatorCases(schema, model);
+        if (cases === undefined)
+            continue;
+        const mapping = cases.cases
+            .map((entry) => `${naming.string(entry.value)}: ${className(entry.schemaName)}`)
+            .join(', ');
+        lines.push(`DISCRIMINATORS[${className(name)}] = (${naming.string(cases.property)}, {${mapping}})`);
+    }
+    return lines;
+}
+//# sourceMappingURL=models.js.map

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

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

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

@@ -0,0 +1,22 @@
+import { type ApiModel, type OperationModel } from '@redocly/client-generator';
+import { PythonPrinter } from '@redocly/client-generator/printers/python';
+export declare const PY: ReadonlySet<string>;
+export declare const naming: PythonPrinter;
+/** A named schema's Python class name. */
+export declare function className(name: string): string;
+/** A field/parameter name, with the wire name preserved when sanitization renames it. */
+export declare function fieldName(name: string): {
+    python: string;
+    renamed: boolean;
+};
+/** Every operation with its collision-free snake_case Python method name. */
+export declare function operationIdents(model: ApiModel): Array<{
+    op: OperationModel;
+    ident: string;
+}>;
+/**
+ * The argument names every request method declares itself. A parameter named after one of
+ * them takes a suffixed binding instead, so the slot keeps its meaning.
+ */
+export declare const METHOD_ARG_SLOTS: string[];
+//# sourceMappingURL=naming.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../src/generators/python/naming.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,cAAc,EAGpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE1E,eAAO,MAAM,EAAE,qBAAwB,CAAC;AAGxC,eAAO,MAAM,MAAM,eAAsB,CAAC;AAE1C,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAG5E;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAO7F;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,UAAqE,CAAC"}

package/lib/generators/python/naming.js

@@ -0,0 +1,28 @@
+// The `naming` stage: the shared printer/naming instance and the collision-free
+// identifier derivations every other stage builds on.
+import { RESERVED_WORDS, uniqueIdentifiers, } from '@redocly/client-generator';
+import { PythonPrinter } from '@redocly/client-generator/printers/python';
+export const PY = RESERVED_WORDS.python;
+// Naming delegates to the printer — one implementation, used here and by any ejected copy.
+export const naming = new PythonPrinter();
+/** A named schema's Python class name. */
+export function className(name) {
+    return naming.typeName(name);
+}
+/** A field/parameter name, with the wire name preserved when sanitization renames it. */
+export function fieldName(name) {
+    const { identifier, renamed } = naming.memberName(name);
+    return { python: identifier, renamed };
+}
+/** Every operation with its collision-free snake_case Python method name. */
+export function operationIdents(model) {
+    const operations = model.services.flatMap((service) => service.operations);
+    const idents = uniqueIdentifiers(operations.map((op) => op.name), { style: 'snake', reserved: PY });
+    return operations.map((op, index) => ({ op, ident: idents[index] }));
+}
+/**
+ * The argument names every request method declares itself. A parameter named after one of
+ * them takes a suffixed binding instead, so the slot keeps its meaning.
+ */
+export const METHOD_ARG_SLOTS = ['self', 'body', 'headers', 'timeout', 'retry', 'idempotency_key'];
+//# sourceMappingURL=naming.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../../src/generators/python/naming.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,sDAAsD;AAEtD,OAAO,EAGL,cAAc,EACd,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE1E,MAAM,CAAC,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC;AAExC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;AAE1C,0CAA0C;AAC1C,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,KAAe;IAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,iBAAiB,CAC9B,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAC/B,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CACjC,CAAC;IACF,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type ApiModel, type DateType, type OperationModel } from '@redocly/client-generator';
+import type { PythonPrinter } from '@redocly/client-generator/printers/python';
+export declare function writeMethod(printer: PythonPrinter, op: OperationModel, ident: string, errorMode: 'throw' | 'result', isAsync: boolean, dateType: DateType, model?: ApiModel, envelope?: boolean): void;
+//# sourceMappingURL=operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/generators/python/operations.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EAGb,KAAK,cAAc,EAGpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAM/E,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,EACtB,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,GAAG,QAAQ,EAC7B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,KAAK,CAAC,EAAE,QAAQ,EAChB,QAAQ,UAAQ,GACf,IAAI,CAmHN"}