@fern-api/python-dynamic-snippets 4.43.0 → 4.45.1

package/dist/index.d.cts

@@ -0,0 +1,165 @@
+import { AbstractDynamicSnippetsGeneratorContext, FernGeneratorExec, AbstractAstNode, AbstractDynamicSnippetsGenerator } from '@fern-api/browser-compatible-base-generator';
+import { FernIr } from '@fern-api/dynamic-ir-sdk';
+import { python } from '@fern-api/python-ast';
+import { BasePythonCustomConfigSchema } from '@fern-api/python-browser-compatible-base';
+
+declare namespace DynamicTypeLiteralMapper {
+    interface Args {
+        typeReference: FernIr.dynamic.TypeReference;
+        value: unknown;
+        as?: ConvertedAs;
+    }
+    type ConvertedAs = "key";
+}
+declare class DynamicTypeLiteralMapper {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    convert(args: DynamicTypeLiteralMapper.Args): python.TypeInstantiation;
+    private convertLiteral;
+    private convertList;
+    private convertSet;
+    private convertMap;
+    private convertNamed;
+    private convertDiscriminatedUnion;
+    private convertDiscriminatedUnionProperties;
+    private getBaseFields;
+    private convertObject;
+    private convertEnum;
+    private getEnumValue;
+    private convertUndiscriminatedUnion;
+    private findMatchingUndiscriminatedUnionType;
+    private convertPrimitive;
+    private getValueAsNumber;
+    private getValueAsBoolean;
+}
+
+interface FilePropertyInfo {
+    fileFields: python.NamedValue[];
+    bodyPropertyFields: python.NamedValue[];
+}
+declare class FilePropertyMapper {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    getFilePropertyInfo({ body, value }: {
+        body: FernIr.dynamic.FileUploadRequestBody;
+        value: unknown;
+    }): FilePropertyInfo;
+    private getSingleFileProperty;
+    private getArrayFileProperty;
+    private getBodyProperty;
+}
+
+declare class DynamicSnippetsGeneratorContext extends AbstractDynamicSnippetsGeneratorContext {
+    ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+    customConfig: BasePythonCustomConfigSchema;
+    dynamicTypeLiteralMapper: DynamicTypeLiteralMapper;
+    filePropertyMapper: FilePropertyMapper;
+    constructor({ ir, config }: {
+        ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+        config: FernGeneratorExec.GeneratorConfig;
+    });
+    clone(): DynamicSnippetsGeneratorContext;
+    getClassName(name: FernIr.Name): string;
+    getTypedDictClassName(name: FernIr.Name): string;
+    getPropertyName(name: FernIr.Name): string;
+    getMethodName(name: FernIr.Name): string;
+    getRootClientClassReference(): python.Reference;
+    getRootClientClassName(): string;
+    getEnvironmentClassName(): string;
+    getEnvironmentTypeReferenceFromID(environmentID: string): python.AstNode | undefined;
+    getEnvironmentClassReference(): python.Reference;
+    getEnvironmentEnumName(name: FernIr.Name): string;
+    isPrimitive(typeReference: FernIr.dynamic.TypeReference): boolean;
+    getFileFromString(content: string): python.TypeInstantiation;
+    getRootModulePath(): string[];
+    getCoreModulePath(): string[];
+    getEnvironmentModulePath(): string[];
+    shouldInlinePathParameters(): boolean;
+    private cleanOrganizationName;
+    private getApiName;
+    private pascalCase;
+}
+
+declare class EndpointSnippetGenerator {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    generateSnippet({ endpoint, request }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+    }): Promise<string>;
+    generateSnippetSync({ endpoint, request }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+    }): string;
+    generateSnippetAst({ endpoint, request }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+    }): Promise<AbstractAstNode>;
+    /**
+     * Generates just the method call AST without the client instantiation.
+     * This is useful for wire tests where the client is created separately
+     * with test-specific configuration.
+     */
+    generateMethodCallSnippetAst({ endpoint, request }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+    }): python.AstNode;
+    private buildPythonFile;
+    private constructClient;
+    private getConstructorArgs;
+    private getConstructorEnvironmentArgs;
+    private getEnvironmentValue;
+    private getConstructorAuthArgs;
+    private addAuthMismatchError;
+    private addWarning;
+    private getConstructorBasicAuthArg;
+    private getConstructorBearerAuthArgs;
+    private getConstructorHeaderAuthArgs;
+    private getConstructorOAuthArgs;
+    private getConstructorHeaderArgs;
+    private getConstructorHeaderArg;
+    private callMethod;
+    private getMethodArgs;
+    private getMethodArgsForBodyRequest;
+    private getBodyRequestArgs;
+    private getBodyRequestArgsForTypeReference;
+    private getBodyRequestArgsForNamedTypeReference;
+    private resolvesToLiteralType;
+    private getBodyRequestArgsForBytes;
+    private getBytesBodyRequestTypeInstantiation;
+    private getMethodArgsForInlinedRequest;
+    private getFilePropertyInfo;
+    private getInlinedRequestArgs;
+    private getInlinedRequestBodyObjectFields;
+    private getFileUploadRequestBodyObjectFields;
+    private getReferencedRequestBodyPropertyTypeInstantiation;
+    private getInlinedRequestBodyPropertyObjectFields;
+    private getPathParameters;
+    private getMethod;
+    private getEnvironmentOptionName;
+}
+
+declare class DynamicSnippetsGenerator extends AbstractDynamicSnippetsGenerator<DynamicSnippetsGeneratorContext, EndpointSnippetGenerator> {
+    constructor({ ir, config }: {
+        ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+        config: FernGeneratorExec.GeneratorConfig;
+    });
+    generate(request: FernIr.dynamic.EndpointSnippetRequest): Promise<FernIr.dynamic.EndpointSnippetResponse>;
+    generateSync(request: FernIr.dynamic.EndpointSnippetRequest): FernIr.dynamic.EndpointSnippetResponse;
+    generateSnippetAst(request: FernIr.dynamic.EndpointSnippetRequest): Promise<AbstractAstNode>;
+    /**
+     * Generates just the method call AST without the client instantiation.
+     * This is useful for wire tests where the client is created separately
+     * with test-specific configuration.
+     */
+    generateMethodCallSnippetAst(request: FernIr.dynamic.EndpointSnippetRequest): python.AstNode;
+    protected createSnippetGenerator(context: DynamicSnippetsGeneratorContext): EndpointSnippetGenerator;
+}
+
+export { DynamicSnippetsGenerator };

package/dist/index.d.ts

@@ -0,0 +1,165 @@
+import { AbstractDynamicSnippetsGeneratorContext, FernGeneratorExec, AbstractAstNode, AbstractDynamicSnippetsGenerator } from '@fern-api/browser-compatible-base-generator';
+import { FernIr } from '@fern-api/dynamic-ir-sdk';
+import { python } from '@fern-api/python-ast';
+import { BasePythonCustomConfigSchema } from '@fern-api/python-browser-compatible-base';
+
+declare namespace DynamicTypeLiteralMapper {
+    interface Args {
+        typeReference: FernIr.dynamic.TypeReference;
+        value: unknown;
+        as?: ConvertedAs;
+    }
+    type ConvertedAs = "key";
+}
+declare class DynamicTypeLiteralMapper {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    convert(args: DynamicTypeLiteralMapper.Args): python.TypeInstantiation;
+    private convertLiteral;
+    private convertList;
+    private convertSet;
+    private convertMap;
+    private convertNamed;
+    private convertDiscriminatedUnion;
+    private convertDiscriminatedUnionProperties;
+    private getBaseFields;
+    private convertObject;
+    private convertEnum;
+    private getEnumValue;
+    private convertUndiscriminatedUnion;
+    private findMatchingUndiscriminatedUnionType;
+    private convertPrimitive;
+    private getValueAsNumber;
+    private getValueAsBoolean;
+}
+
+interface FilePropertyInfo {
+    fileFields: python.NamedValue[];
+    bodyPropertyFields: python.NamedValue[];
+}
+declare class FilePropertyMapper {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    getFilePropertyInfo({ body, value }: {
+        body: FernIr.dynamic.FileUploadRequestBody;
+        value: unknown;
+    }): FilePropertyInfo;
+    private getSingleFileProperty;
+    private getArrayFileProperty;
+    private getBodyProperty;
+}
+
+declare class DynamicSnippetsGeneratorContext extends AbstractDynamicSnippetsGeneratorContext {
+    ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+    customConfig: BasePythonCustomConfigSchema;
+    dynamicTypeLiteralMapper: DynamicTypeLiteralMapper;
+    filePropertyMapper: FilePropertyMapper;
+    constructor({ ir, config }: {
+        ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+        config: FernGeneratorExec.GeneratorConfig;
+    });
+    clone(): DynamicSnippetsGeneratorContext;
+    getClassName(name: FernIr.Name): string;
+    getTypedDictClassName(name: FernIr.Name): string;
+    getPropertyName(name: FernIr.Name): string;
+    getMethodName(name: FernIr.Name): string;
+    getRootClientClassReference(): python.Reference;
+    getRootClientClassName(): string;
+    getEnvironmentClassName(): string;
+    getEnvironmentTypeReferenceFromID(environmentID: string): python.AstNode | undefined;
+    getEnvironmentClassReference(): python.Reference;
+    getEnvironmentEnumName(name: FernIr.Name): string;
+    isPrimitive(typeReference: FernIr.dynamic.TypeReference): boolean;
+    getFileFromString(content: string): python.TypeInstantiation;
+    getRootModulePath(): string[];
+    getCoreModulePath(): string[];
+    getEnvironmentModulePath(): string[];
+    shouldInlinePathParameters(): boolean;
+    private cleanOrganizationName;
+    private getApiName;
+    private pascalCase;
+}
+
+declare class EndpointSnippetGenerator {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    generateSnippet({ endpoint, request }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+    }): Promise<string>;
+    generateSnippetSync({ endpoint, request }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+    }): string;
+    generateSnippetAst({ endpoint, request }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+    }): Promise<AbstractAstNode>;
+    /**
+     * Generates just the method call AST without the client instantiation.
+     * This is useful for wire tests where the client is created separately
+     * with test-specific configuration.
+     */
+    generateMethodCallSnippetAst({ endpoint, request }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+    }): python.AstNode;
+    private buildPythonFile;
+    private constructClient;
+    private getConstructorArgs;
+    private getConstructorEnvironmentArgs;
+    private getEnvironmentValue;
+    private getConstructorAuthArgs;
+    private addAuthMismatchError;
+    private addWarning;
+    private getConstructorBasicAuthArg;
+    private getConstructorBearerAuthArgs;
+    private getConstructorHeaderAuthArgs;
+    private getConstructorOAuthArgs;
+    private getConstructorHeaderArgs;
+    private getConstructorHeaderArg;
+    private callMethod;
+    private getMethodArgs;
+    private getMethodArgsForBodyRequest;
+    private getBodyRequestArgs;
+    private getBodyRequestArgsForTypeReference;
+    private getBodyRequestArgsForNamedTypeReference;
+    private resolvesToLiteralType;
+    private getBodyRequestArgsForBytes;
+    private getBytesBodyRequestTypeInstantiation;
+    private getMethodArgsForInlinedRequest;
+    private getFilePropertyInfo;
+    private getInlinedRequestArgs;
+    private getInlinedRequestBodyObjectFields;
+    private getFileUploadRequestBodyObjectFields;
+    private getReferencedRequestBodyPropertyTypeInstantiation;
+    private getInlinedRequestBodyPropertyObjectFields;
+    private getPathParameters;
+    private getMethod;
+    private getEnvironmentOptionName;
+}
+
+declare class DynamicSnippetsGenerator extends AbstractDynamicSnippetsGenerator<DynamicSnippetsGeneratorContext, EndpointSnippetGenerator> {
+    constructor({ ir, config }: {
+        ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+        config: FernGeneratorExec.GeneratorConfig;
+    });
+    generate(request: FernIr.dynamic.EndpointSnippetRequest): Promise<FernIr.dynamic.EndpointSnippetResponse>;
+    generateSync(request: FernIr.dynamic.EndpointSnippetRequest): FernIr.dynamic.EndpointSnippetResponse;
+    generateSnippetAst(request: FernIr.dynamic.EndpointSnippetRequest): Promise<AbstractAstNode>;
+    /**
+     * Generates just the method call AST without the client instantiation.
+     * This is useful for wire tests where the client is created separately
+     * with test-specific configuration.
+     */
+    generateMethodCallSnippetAst(request: FernIr.dynamic.EndpointSnippetRequest): python.AstNode;
+    protected createSnippetGenerator(context: DynamicSnippetsGeneratorContext): EndpointSnippetGenerator;
+}
+
+export { DynamicSnippetsGenerator };