import type { StructureItem, StructureNode, StructureShell, Symbol, SymbolMeta, } from '@hey-api/codegen-core'; import type { IR } from '@hey-api/shared'; import { applyNaming, toCase } from '@hey-api/shared'; import { $ } from '../../../../py-dsl'; import { createOperationComment } from '../../../shared/utils/operation'; import { operationParameters } from '../shared/operation'; import type { HeyApiSdkPlugin } from '../types'; export interface OperationItem { operation: IR.OperationObject; path: ReadonlyArray; tags: ReadonlyArray | undefined; } export const source = globalThis.Symbol('@hey-api/python-sdk'); function attachComment>(args: { node: T; operation: IR.OperationObject; plugin: HeyApiSdkPlugin['Instance']; }): T { const { node, operation, plugin } = args; return node.$if(plugin.config.comments && createOperationComment(operation), (n, v) => n.doc(v), ) as T; } function createShellMeta(node: StructureNode): SymbolMeta { return { category: 'utility', resource: 'class', resourceId: node.getPath().join('.'), tool: 'sdk', }; } function createFnSymbol( plugin: HeyApiSdkPlugin['Instance'], item: StructureItem & { data: OperationItem }, ): Symbol { const { operation, path, tags } = item.data; const name = item.location[item.location.length - 1]!; return plugin.symbol(applyNaming(name, plugin.config.operations.methodName), { meta: { category: 'sdk', path, resource: 'operation', resourceId: operation.id, tags, tool: 'sdk', }, }); } function childToNode( resource: StructureNode, plugin: HeyApiSdkPlugin['Instance'], ): ReadonlyArray> { const refChild = plugin.referenceSymbol(createShellMeta(resource)); const memberNameStr = toCase( refChild.name, plugin.config.operations.methodName.casing ?? 'camelCase', ); const memberName = plugin.symbol(memberNameStr); const cachedProp = plugin.external('functools.cached_property'); return [ $.method(memberName) .decorator(cachedProp) .param('self') .returns(refChild) .do( $(refChild) .call($.kwarg('client', $('self').attr('client'))) .return(), ), ]; } export function createShell(plugin: HeyApiSdkPlugin['Instance']): StructureShell { return { define: (node) => { const symbol = plugin.symbol( applyNaming( node.name, node.isRoot ? plugin.config.operations.containerName : plugin.config.operations.segmentName, ), { meta: createShellMeta(node), }, ); const symbolClient = plugin.external('client.Client'); const c = $.class(symbol).export().extends(symbolClient); const dependencies: Array> = []; return { dependencies, node: c }; }, }; } function implementFn>(args: { node: T; operation: IR.OperationObject; plugin: HeyApiSdkPlugin['Instance']; }): T { const { node, operation, plugin } = args; const method = operation.method.toLowerCase(); const opParameters = operationParameters({ operation, plugin }); if (plugin.config.paramsStructure === 'flat' && opParameters.fields.length) { const paramNames = opParameters.parameters.map((parameter) => parameter.name.toString()); const fieldsList = $.list(); for (const field of opParameters.fields) { const fieldDict = $.dict(); fieldDict.entry($.literal('in'), $.literal(field.in)); fieldDict.entry($.literal('key'), $.literal(field.key)); if (field.map) { fieldDict.entry($.literal('map'), $.literal(field.map)); } fieldsList.element(fieldDict); } return ( node .params(...opParameters.parameters) // TODO: extract operation statements into a separate function .do( $.var('params').assign( $(plugin.external('client.build_client_params')).call( fieldsList, ...paramNames.map((name) => $.kwarg(name, name)), ), ), ) .do( $('self') .attr('client') .attr(method) .call($.literal(operation.path), $.kwarg('params', $('params') as never)) .return(), ) as T ); } return node .params(...opParameters.parameters) .do($('self').attr('client').attr(method).call($.literal(operation.path)).return()) as T; } export function toNode( model: StructureNode, plugin: HeyApiSdkPlugin['Instance'], ): { dependencies?: Array>; nodes: ReadonlyArray>; } { if (model.virtual) { const nodes: Array> = []; for (const item of model.itemsFrom(source)) { const fnName = applyNaming( String(item.location[item.location.length - 1]), plugin.config.operations.methodName, ); const node = $.func(fnName).export().do($('None').return()); nodes.push(node); } return { nodes }; } if (!model.shell) { return { nodes: [] }; } const nodes: Array> = []; const shell = model.shell.define(model); const node = shell.node as ReturnType; let index = 0; for (const item of model.itemsFrom(source)) { const { operation } = item.data; if (node['~dsl'] === 'FuncPyDsl') { // TODO: function? } else { if (index > 0 || node.hasBody) node.newline(); const method = implementFn({ node: $.method(createFnSymbol(plugin, item), (m) => attachComment({ node: m, operation, plugin, }), ).param('self'), operation, plugin, }); node.do(method); // exampleIntent(method, operation, plugin); } index += 1; } for (const child of model.children.values()) { if (node['~dsl'] === 'FuncPyDsl') { // TODO: function? } else { if (node.hasBody) node.newline(); node.do(...childToNode(child, plugin)); } } nodes.push(node); return { dependencies: shell.dependencies as Array>, nodes, }; }