@aws-cdk/integ-runner/lib/engines/toolkit-lib.d.ts

CDK Integration Testing Tool

import type { DeployOptions, ICdk, ListOptions, SynthFastOptions, SynthOptions, WatchEvents } from '@aws-cdk/cdk-cli-wrapper';
import type { DestroyOptions } from '@aws-cdk/cloud-assembly-schema/lib/integ-tests';
export interface ToolkitLibEngineOptions {
    /**
     * The directory to run the cdk commands from
     */
    readonly workingDirectory: string;
    /**
     * Additional environment variables to set
     * in the execution environment that will be running
     * the cdk app
     *
     * @default - no additional env vars
     */
    readonly env?: {
        [name: string]: string;
    };
    /**
     * Show the output from running the CDK CLI
     *
     * @default false
     */
    readonly showOutput?: boolean;
}
/**
 * A runner engine powered directly by the toolkit-lib
 */
export declare class ToolkitLibRunnerEngine implements ICdk {
    private readonly toolkit;
    private readonly options;
    private readonly showOutput;
    constructor(options: ToolkitLibEngineOptions);
    /**
     * Synthesizes the CDK app through the Toolkit
     */
    synth(options: SynthOptions): Promise<void>;
    /**
     * Synthesizes the CDK app quickly, by bypassing the Toolkit and just invoking the app command
     */
    synthFast(options: SynthFastOptions): Promise<void>;
    /**
     * Lists the stacks in the CDK app
     */
    list(options: ListOptions): Promise<string[]>;
    /**
     * Deploys the CDK app
     */
    deploy(options: DeployOptions): Promise<void>;
    /**
     * Watches the CDK app for changes and deploys them automatically
     */
    watch(options: DeployOptions, events?: WatchEvents): Promise<void>;
    /**
     * Destroys the CDK app
     */
    destroy(options: DestroyOptions): Promise<void>;
    /**
     * Creates a Cloud Assembly Source from the provided options.
     */
    private cx;
    /**
     * Creates a StackSelector from the provided options.
     */
    private stackSelector;
    /**
     * Creates a DeploymentMethod from the provided options.
     */
    private deploymentMethod;
}