@aws-cdk/aws-lambda-python-alpha 2.0.0-rc.23

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2018-2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,2 @@
+AWS Cloud Development Kit (AWS CDK)
+Copyright 2018-2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.

package/README.md

@@ -0,0 +1,98 @@
+# Amazon Lambda Python Library
+
+<!--BEGIN STABILITY BANNER-->
+
+---
+
+![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)
+
+> The APIs of higher level constructs in this module are experimental and under active development.
+> They are subject to non-backward compatible changes or removal in any future version. These are
+> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be
+> announced in the release notes. This means that while you may use them, you may need to update
+> your source code when upgrading to a newer version of this package.
+
+---
+
+<!--END STABILITY BANNER-->
+
+This library provides constructs for Python Lambda functions.
+
+To use this module, you will need to have Docker installed.
+
+## Python Function
+
+Define a `PythonFunction`:
+
+```ts
+import * as lambda from "@aws-cdk/aws-lambda";
+import { PythonFunction } from "@aws-cdk/aws-lambda-python";
+
+new PythonFunction(this, 'MyFunction', {
+  entry: '/path/to/my/function', // required
+  index: 'my_index.py', // optional, defaults to 'index.py'
+  handler: 'my_exported_func', // optional, defaults to 'handler'
+  runtime: lambda.Runtime.PYTHON_3_6, // optional, defaults to lambda.Runtime.PYTHON_3_7
+});
+```
+
+All other properties of `lambda.Function` are supported, see also the [AWS Lambda construct library](https://github.com/aws/aws-cdk/tree/master/packages/%40aws-cdk/aws-lambda).
+
+## Module Dependencies
+
+If `requirements.txt` or `Pipfile` exists at the entry path, the construct will handle installing
+all required modules in a [Lambda compatible Docker container](https://gallery.ecr.aws/sam/build-python3.7)
+according to the `runtime` and with the Docker platform based on the target architecture of the Lambda function.
+
+Python bundles are only recreated and published when a file in a source directory has changed.
+Therefore (and as a general best-practice), it is highly recommended to commit a lockfile with a
+list of all transitive dependencies and their exact versions.
+This will ensure that when any dependency version is updated, the bundle asset is recreated and uploaded.
+
+To that end, we recommend using [`pipenv`] or [`poetry`] which has lockfile support.
+
+[`pipenv`]: https://pipenv-fork.readthedocs.io/en/latest/basics.html#example-pipfile-lock
+[`poetry`]: https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+
+**Lambda with a requirements.txt**
+
+```plaintext
+.
+├── lambda_function.py # exports a function named 'handler'
+├── requirements.txt # has to be present at the entry path
+```
+
+**Lambda with a Pipfile**
+
+```plaintext
+.
+├── lambda_function.py # exports a function named 'handler'
+├── Pipfile # has to be present at the entry path
+├── Pipfile.lock # your lock file
+```
+
+**Lambda with a poetry.lock**
+
+```plaintext
+.
+├── lambda_function.py # exports a function named 'handler'
+├── pyproject.toml # has to be present at the entry path
+├── poetry.lock # your poetry lock file
+```
+
+**Lambda Layer Support**
+
+You may create a python-based lambda layer with `PythonLayerVersion`. If `PythonLayerVersion` detects a `requirements.txt`
+or `Pipfile` or `poetry.lock` with the associated `pyproject.toml` at the entry path, then `PythonLayerVersion` will include the dependencies inline with your code in the
+layer.
+
+```ts
+new lambda.PythonFunction(this, 'MyFunction', {
+  entry: '/path/to/my/function',
+  layers: [
+    new lambda.PythonLayerVersion(this, 'MyLayer', {
+      entry: '/path/to/my/layer', // point this to your library's directory
+    }),
+  ],
+});
+```

package/lib/Dockerfile

@@ -0,0 +1,9 @@
+# The correct AWS SAM build image based on the runtime of the function will be
+# passed as build arg. The default allows to do `docker build .` when testing.
+ARG IMAGE=public.ecr.aws/sam/build-python3.7
+FROM $IMAGE
+
+# Ensure rsync is installed
+RUN yum -q list installed rsync &>/dev/null || yum install -y rsync
+
+CMD [ "python" ]

package/lib/Dockerfile.dependencies

@@ -0,0 +1,22 @@
+# The correct AWS SAM build image based on the runtime of the function will be
+# passed as build arg. The default allows to do `docker build .` when testing.
+ARG IMAGE=public.ecr.aws/sam/build-python3.7
+FROM $IMAGE
+
+# Ensure rsync is installed
+RUN yum -q list installed rsync &>/dev/null || yum install -y rsync
+
+# Upgrade pip (required by cryptography v3.4 and above, which is a dependency of poetry)
+RUN pip install --upgrade pip
+
+# Install pipenv and poetry so we can create a requirements.txt if we detect pipfile or poetry.lock respectively
+RUN pip install pipenv poetry
+
+# Install the dependencies in a cacheable layer
+WORKDIR /var/dependencies
+COPY Pipfile* pyproject* poetry* requirements.tx[t] ./
+RUN [ -f 'Pipfile' ] && pipenv lock -r >requirements.txt; \
+    [ -f 'poetry.lock' ] && poetry export --with-credentials --format requirements.txt --output requirements.txt; \
+    [ -f 'requirements.txt' ] && pip install -r requirements.txt -t .;
+
+CMD [ "python" ]

package/lib/bundling.d.ts

@@ -0,0 +1,78 @@
+import * as lambda from 'aws-cdk-lib/aws-lambda';
+import * as cdk from 'aws-cdk-lib';
+/**
+ * Dependency files to exclude from the asset hash.
+ */
+export declare const DEPENDENCY_EXCLUDES: string[];
+/**
+ * The location in the image that the bundler image caches dependencies.
+ */
+export declare const BUNDLER_DEPENDENCIES_CACHE = "/var/dependencies";
+/**
+ * Options for bundling
+ */
+export interface BundlingOptions {
+    /**
+     * Entry path
+     */
+    readonly entry: string;
+    /**
+     * The runtime of the lambda function
+     */
+    readonly runtime: lambda.Runtime;
+    /**
+     * The system architecture of the lambda function
+     */
+    readonly architecture: lambda.Architecture;
+    /**
+     * Output path suffix ('python' for a layer, '.' otherwise)
+     */
+    readonly outputPathSuffix: string;
+    /**
+     * Determines how asset hash is calculated. Assets will get rebuild and
+     * uploaded only if their hash has changed.
+     *
+     * If asset hash is set to `SOURCE` (default), then only changes to the source
+     * directory will cause the asset to rebuild. This means, for example, that in
+     * order to pick up a new dependency version, a change must be made to the
+     * source tree. Ideally, this can be implemented by including a dependency
+     * lockfile in your source tree or using fixed dependencies.
+     *
+     * If the asset hash is set to `OUTPUT`, the hash is calculated after
+     * bundling. This means that any change in the output will cause the asset to
+     * be invalidated and uploaded. Bear in mind that `pip` adds timestamps to
+     * dependencies it installs, which implies that in this mode Python bundles
+     * will _always_ get rebuild and uploaded. Normally this is an anti-pattern
+     * since build
+     *
+     * @default AssetHashType.SOURCE By default, hash is calculated based on the
+     * contents of the source directory. If `assetHash` is also specified, the
+     * default is `CUSTOM`. This means that only updates to the source will cause
+     * the asset to rebuild.
+     */
+    readonly assetHashType?: cdk.AssetHashType;
+    /**
+     * Specify a custom hash for this asset. If `assetHashType` is set it must
+     * be set to `AssetHashType.CUSTOM`. For consistency, this custom hash will
+     * be SHA256 hashed and encoded as hex. The resulting hash will be the asset
+     * hash.
+     *
+     * NOTE: the hash is used in order to identify a specific revision of the asset, and
+     * used for optimizing and caching deployment activities related to this asset such as
+     * packaging, uploading to Amazon S3, etc. If you chose to customize the hash, you will
+     * need to make sure it is updated every time the asset changes, or otherwise it is
+     * possible that some deployments will not be invalidated.
+     *
+     * @default - based on `assetHashType`
+     */
+    readonly assetHash?: string;
+}
+/**
+ * Produce bundled Lambda asset code
+ */
+export declare function bundle(options: BundlingOptions): lambda.Code;
+/**
+ * Checks to see if the `entry` directory contains a type of dependency that
+ * we know how to install.
+ */
+export declare function stageDependencies(entry: string, stagedir: string): boolean;

package/lib/bundling.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stageDependencies = exports.bundle = exports.BUNDLER_DEPENDENCIES_CACHE = exports.DEPENDENCY_EXCLUDES = void 0;
+const fs = require("fs");
+const path = require("path");
+const lambda = require("aws-cdk-lib/aws-lambda");
+const cdk = require("aws-cdk-lib");
+/**
+ * Dependency files to exclude from the asset hash.
+ */
+exports.DEPENDENCY_EXCLUDES = ['*.pyc'];
+/**
+ * The location in the image that the bundler image caches dependencies.
+ */
+exports.BUNDLER_DEPENDENCIES_CACHE = '/var/dependencies';
+/**
+ * Produce bundled Lambda asset code
+ */
+function bundle(options) {
+    const { entry, runtime, architecture, outputPathSuffix } = options;
+    const stagedir = cdk.FileSystem.mkdtemp('python-bundling-');
+    const hasDeps = stageDependencies(entry, stagedir);
+    const depsCommand = chain([
+        hasDeps ? `rsync -r ${exports.BUNDLER_DEPENDENCIES_CACHE}/. ${cdk.AssetStaging.BUNDLING_OUTPUT_DIR}/${outputPathSuffix}` : '',
+        `rsync -r . ${cdk.AssetStaging.BUNDLING_OUTPUT_DIR}/${outputPathSuffix}`,
+    ]);
+    // Determine which dockerfile to use. When dependencies are present, we use a
+    // Dockerfile that can create a cacheable layer. We can't use this Dockerfile
+    // if there aren't dependencies or the Dockerfile will complain about missing
+    // sources.
+    const dockerfile = hasDeps
+        ? 'Dockerfile.dependencies'
+        : 'Dockerfile';
+    // copy Dockerfile to workdir
+    fs.copyFileSync(path.join(__dirname, dockerfile), path.join(stagedir, dockerfile));
+    const image = cdk.DockerImage.fromBuild(stagedir, {
+        buildArgs: {
+            IMAGE: runtime.bundlingImage.image,
+        },
+        platform: architecture.dockerPlatform,
+        file: dockerfile,
+    });
+    return lambda.Code.fromAsset(entry, {
+        assetHashType: options.assetHashType,
+        assetHash: options.assetHash,
+        exclude: exports.DEPENDENCY_EXCLUDES,
+        bundling: {
+            image,
+            command: ['bash', '-c', depsCommand],
+        },
+    });
+}
+exports.bundle = bundle;
+/**
+ * Checks to see if the `entry` directory contains a type of dependency that
+ * we know how to install.
+ */
+function stageDependencies(entry, stagedir) {
+    const prefixes = [
+        'Pipfile',
+        'pyproject',
+        'poetry',
+        'requirements.txt',
+    ];
+    let found = false;
+    for (const file of fs.readdirSync(entry)) {
+        for (const prefix of prefixes) {
+            if (file.startsWith(prefix)) {
+                fs.copyFileSync(path.join(entry, file), path.join(stagedir, file));
+                found = true;
+            }
+        }
+    }
+    return found;
+}
+exports.stageDependencies = stageDependencies;
+function chain(commands) {
+    return commands.filter(c => !!c).join(' && ');
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVuZGxpbmcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJidW5kbGluZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSx5QkFBeUI7QUFDekIsNkJBQTZCO0FBQzdCLGlEQUFpRDtBQUNqRCxtQ0FBbUM7QUFFbkM7O0dBRUc7QUFDVSxRQUFBLG1CQUFtQixHQUFHLENBQUMsT0FBTyxDQUFDLENBQUM7QUFFN0M7O0dBRUc7QUFDVSxRQUFBLDBCQUEwQixHQUFHLG1CQUFtQixDQUFDO0FBbUU5RDs7R0FFRztBQUNILFNBQWdCLE1BQU0sQ0FBQyxPQUF3QjtJQUM3QyxNQUFNLEVBQUUsS0FBSyxFQUFFLE9BQU8sRUFBRSxZQUFZLEVBQUUsZ0JBQWdCLEVBQUUsR0FBRyxPQUFPLENBQUM7SUFFbkUsTUFBTSxRQUFRLEdBQUcsR0FBRyxDQUFDLFVBQVUsQ0FBQyxPQUFPLENBQUMsa0JBQWtCLENBQUMsQ0FBQztJQUM1RCxNQUFNLE9BQU8sR0FBRyxpQkFBaUIsQ0FBQyxLQUFLLEVBQUUsUUFBUSxDQUFDLENBQUM7SUFFbkQsTUFBTSxXQUFXLEdBQUcsS0FBSyxDQUFDO1FBQ3hCLE9BQU8sQ0FBQyxDQUFDLENBQUMsWUFBWSxrQ0FBMEIsTUFBTSxHQUFHLENBQUMsWUFBWSxDQUFDLG1CQUFtQixJQUFJLGdCQUFnQixFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUU7UUFDckgsY0FBYyxHQUFHLENBQUMsWUFBWSxDQUFDLG1CQUFtQixJQUFJLGdCQUFnQixFQUFFO0tBQ3pFLENBQUMsQ0FBQztJQUVILDZFQUE2RTtJQUM3RSw2RUFBNkU7SUFDN0UsNkVBQTZFO0lBQzdFLFdBQVc7SUFDWCxNQUFNLFVBQVUsR0FBRyxPQUFPO1FBQ3hCLENBQUMsQ0FBQyx5QkFBeUI7UUFDM0IsQ0FBQyxDQUFDLFlBQVksQ0FBQztJQUVqQiw2QkFBNkI7SUFDN0IsRUFBRSxDQUFDLFlBQVksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxVQUFVLENBQUMsRUFBRSxJQUFJLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxVQUFVLENBQUMsQ0FBQyxDQUFDO0lBRW5GLE1BQU0sS0FBSyxHQUFHLEdBQUcsQ0FBQyxXQUFXLENBQUMsU0FBUyxDQUFDLFFBQVEsRUFBRTtRQUNoRCxTQUFTLEVBQUU7WUFDVCxLQUFLLEVBQUUsT0FBTyxDQUFDLGFBQWEsQ0FBQyxLQUFLO1NBQ25DO1FBQ0QsUUFBUSxFQUFFLFlBQVksQ0FBQyxjQUFjO1FBQ3JDLElBQUksRUFBRSxVQUFVO0tBQ2pCLENBQUMsQ0FBQztJQUVILE9BQU8sTUFBTSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsS0FBSyxFQUFFO1FBQ2xDLGFBQWEsRUFBRSxPQUFPLENBQUMsYUFBYTtRQUNwQyxTQUFTLEVBQUUsT0FBTyxDQUFDLFNBQVM7UUFDNUIsT0FBTyxFQUFFLDJCQUFtQjtRQUM1QixRQUFRLEVBQUU7WUFDUixLQUFLO1lBQ0wsT0FBTyxFQUFFLENBQUMsTUFBTSxFQUFFLElBQUksRUFBRSxXQUFXLENBQUM7U0FDckM7S0FDRixDQUFDLENBQUM7QUFDTCxDQUFDO0FBdkNELHdCQXVDQztBQUVEOzs7R0FHRztBQUNILFNBQWdCLGlCQUFpQixDQUFDLEtBQWEsRUFBRSxRQUFnQjtJQUMvRCxNQUFNLFFBQVEsR0FBRztRQUNmLFNBQVM7UUFDVCxXQUFXO1FBQ1gsUUFBUTtRQUNSLGtCQUFrQjtLQUNuQixDQUFDO0lBRUYsSUFBSSxLQUFLLEdBQUcsS0FBSyxDQUFDO0lBQ2xCLEtBQUssTUFBTSxJQUFJLElBQUksRUFBRSxDQUFDLFdBQVcsQ0FBQyxLQUFLLENBQUMsRUFBRTtRQUN4QyxLQUFLLE1BQU0sTUFBTSxJQUFJLFFBQVEsRUFBRTtZQUM3QixJQUFJLElBQUksQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLEVBQUU7Z0JBQzNCLEVBQUUsQ0FBQyxZQUFZLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxLQUFLLEVBQUUsSUFBSSxDQUFDLEVBQUUsSUFBSSxDQUFDLElBQUksQ0FBQyxRQUFRLEVBQUUsSUFBSSxDQUFDLENBQUMsQ0FBQztnQkFDbkUsS0FBSyxHQUFHLElBQUksQ0FBQzthQUNkO1NBQ0Y7S0FDRjtJQUVELE9BQU8sS0FBSyxDQUFDO0FBQ2YsQ0FBQztBQW5CRCw4Q0FtQkM7QUFFRCxTQUFTLEtBQUssQ0FBQyxRQUFrQjtJQUMvQixPQUFPLFFBQVEsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0FBQ2hELENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgKiBhcyBmcyBmcm9tICdmcyc7XG5pbXBvcnQgKiBhcyBwYXRoIGZyb20gJ3BhdGgnO1xuaW1wb3J0ICogYXMgbGFtYmRhIGZyb20gJ2F3cy1jZGstbGliL2F3cy1sYW1iZGEnO1xuaW1wb3J0ICogYXMgY2RrIGZyb20gJ2F3cy1jZGstbGliJztcblxuLyoqXG4gKiBEZXBlbmRlbmN5IGZpbGVzIHRvIGV4Y2x1ZGUgZnJvbSB0aGUgYXNzZXQgaGFzaC5cbiAqL1xuZXhwb3J0IGNvbnN0IERFUEVOREVOQ1lfRVhDTFVERVMgPSBbJyoucHljJ107XG5cbi8qKlxuICogVGhlIGxvY2F0aW9uIGluIHRoZSBpbWFnZSB0aGF0IHRoZSBidW5kbGVyIGltYWdlIGNhY2hlcyBkZXBlbmRlbmNpZXMuXG4gKi9cbmV4cG9ydCBjb25zdCBCVU5ETEVSX0RFUEVOREVOQ0lFU19DQUNIRSA9ICcvdmFyL2RlcGVuZGVuY2llcyc7XG5cbi8qKlxuICogT3B0aW9ucyBmb3IgYnVuZGxpbmdcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBCdW5kbGluZ09wdGlvbnMge1xuICAvKipcbiAgICogRW50cnkgcGF0aFxuICAgKi9cbiAgcmVhZG9ubHkgZW50cnk6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIHJ1bnRpbWUgb2YgdGhlIGxhbWJkYSBmdW5jdGlvblxuICAgKi9cbiAgcmVhZG9ubHkgcnVudGltZTogbGFtYmRhLlJ1bnRpbWU7XG5cbiAgLyoqXG4gICAqIFRoZSBzeXN0ZW0gYXJjaGl0ZWN0dXJlIG9mIHRoZSBsYW1iZGEgZnVuY3Rpb25cbiAgICovXG4gIHJlYWRvbmx5IGFyY2hpdGVjdHVyZTogbGFtYmRhLkFyY2hpdGVjdHVyZTtcblxuICAvKipcbiAgICogT3V0cHV0IHBhdGggc3VmZml4ICgncHl0aG9uJyBmb3IgYSBsYXllciwgJy4nIG90aGVyd2lzZSlcbiAgICovXG4gIHJlYWRvbmx5IG91dHB1dFBhdGhTdWZmaXg6IHN0cmluZztcblxuICAvKipcbiAgICogRGV0ZXJtaW5lcyBob3cgYXNzZXQgaGFzaCBpcyBjYWxjdWxhdGVkLiBBc3NldHMgd2lsbCBnZXQgcmVidWlsZCBhbmRcbiAgICogdXBsb2FkZWQgb25seSBpZiB0aGVpciBoYXNoIGhhcyBjaGFuZ2VkLlxuICAgKlxuICAgKiBJZiBhc3NldCBoYXNoIGlzIHNldCB0byBgU09VUkNFYCAoZGVmYXVsdCksIHRoZW4gb25seSBjaGFuZ2VzIHRvIHRoZSBzb3VyY2VcbiAgICogZGlyZWN0b3J5IHdpbGwgY2F1c2UgdGhlIGFzc2V0IHRvIHJlYnVpbGQuIFRoaXMgbWVhbnMsIGZvciBleGFtcGxlLCB0aGF0IGluXG4gICAqIG9yZGVyIHRvIHBpY2sgdXAgYSBuZXcgZGVwZW5kZW5jeSB2ZXJzaW9uLCBhIGNoYW5nZSBtdXN0IGJlIG1hZGUgdG8gdGhlXG4gICAqIHNvdXJjZSB0cmVlLiBJZGVhbGx5LCB0aGlzIGNhbiBiZSBpbXBsZW1lbnRlZCBieSBpbmNsdWRpbmcgYSBkZXBlbmRlbmN5XG4gICAqIGxvY2tmaWxlIGluIHlvdXIgc291cmNlIHRyZWUgb3IgdXNpbmcgZml4ZWQgZGVwZW5kZW5jaWVzLlxuICAgKlxuICAgKiBJZiB0aGUgYXNzZXQgaGFzaCBpcyBzZXQgdG8gYE9VVFBVVGAsIHRoZSBoYXNoIGlzIGNhbGN1bGF0ZWQgYWZ0ZXJcbiAgICogYnVuZGxpbmcuIFRoaXMgbWVhbnMgdGhhdCBhbnkgY2hhbmdlIGluIHRoZSBvdXRwdXQgd2lsbCBjYXVzZSB0aGUgYXNzZXQgdG9cbiAgICogYmUgaW52YWxpZGF0ZWQgYW5kIHVwbG9hZGVkLiBCZWFyIGluIG1pbmQgdGhhdCBgcGlwYCBhZGRzIHRpbWVzdGFtcHMgdG9cbiAgICogZGVwZW5kZW5jaWVzIGl0IGluc3RhbGxzLCB3aGljaCBpbXBsaWVzIHRoYXQgaW4gdGhpcyBtb2RlIFB5dGhvbiBidW5kbGVzXG4gICAqIHdpbGwgX2Fsd2F5c18gZ2V0IHJlYnVpbGQgYW5kIHVwbG9hZGVkLiBOb3JtYWxseSB0aGlzIGlzIGFuIGFudGktcGF0dGVyblxuICAgKiBzaW5jZSBidWlsZFxuICAgKlxuICAgKiBAZGVmYXVsdCBBc3NldEhhc2hUeXBlLlNPVVJDRSBCeSBkZWZhdWx0LCBoYXNoIGlzIGNhbGN1bGF0ZWQgYmFzZWQgb24gdGhlXG4gICAqIGNvbnRlbnRzIG9mIHRoZSBzb3VyY2UgZGlyZWN0b3J5LiBJZiBgYXNzZXRIYXNoYCBpcyBhbHNvIHNwZWNpZmllZCwgdGhlXG4gICAqIGRlZmF1bHQgaXMgYENVU1RPTWAuIFRoaXMgbWVhbnMgdGhhdCBvbmx5IHVwZGF0ZXMgdG8gdGhlIHNvdXJjZSB3aWxsIGNhdXNlXG4gICAqIHRoZSBhc3NldCB0byByZWJ1aWxkLlxuICAgKi9cbiAgcmVhZG9ubHkgYXNzZXRIYXNoVHlwZT86IGNkay5Bc3NldEhhc2hUeXBlO1xuXG4gIC8qKlxuICAgKiBTcGVjaWZ5IGEgY3VzdG9tIGhhc2ggZm9yIHRoaXMgYXNzZXQuIElmIGBhc3NldEhhc2hUeXBlYCBpcyBzZXQgaXQgbXVzdFxuICAgKiBiZSBzZXQgdG8gYEFzc2V0SGFzaFR5cGUuQ1VTVE9NYC4gRm9yIGNvbnNpc3RlbmN5LCB0aGlzIGN1c3RvbSBoYXNoIHdpbGxcbiAgICogYmUgU0hBMjU2IGhhc2hlZCBhbmQgZW5jb2RlZCBhcyBoZXguIFRoZSByZXN1bHRpbmcgaGFzaCB3aWxsIGJlIHRoZSBhc3NldFxuICAgKiBoYXNoLlxuICAgKlxuICAgKiBOT1RFOiB0aGUgaGFzaCBpcyB1c2VkIGluIG9yZGVyIHRvIGlkZW50aWZ5IGEgc3BlY2lmaWMgcmV2aXNpb24gb2YgdGhlIGFzc2V0LCBhbmRcbiAgICogdXNlZCBmb3Igb3B0aW1pemluZyBhbmQgY2FjaGluZyBkZXBsb3ltZW50IGFjdGl2aXRpZXMgcmVsYXRlZCB0byB0aGlzIGFzc2V0IHN1Y2ggYXNcbiAgICogcGFja2FnaW5nLCB1cGxvYWRpbmcgdG8gQW1hem9uIFMzLCBldGMuIElmIHlvdSBjaG9zZSB0byBjdXN0b21pemUgdGhlIGhhc2gsIHlvdSB3aWxsXG4gICAqIG5lZWQgdG8gbWFrZSBzdXJlIGl0IGlzIHVwZGF0ZWQgZXZlcnkgdGltZSB0aGUgYXNzZXQgY2hhbmdlcywgb3Igb3RoZXJ3aXNlIGl0IGlzXG4gICAqIHBvc3NpYmxlIHRoYXQgc29tZSBkZXBsb3ltZW50cyB3aWxsIG5vdCBiZSBpbnZhbGlkYXRlZC5cbiAgICpcbiAgICogQGRlZmF1bHQgLSBiYXNlZCBvbiBgYXNzZXRIYXNoVHlwZWBcbiAgICovXG4gIHJlYWRvbmx5IGFzc2V0SGFzaD86IHN0cmluZztcbn1cblxuLyoqXG4gKiBQcm9kdWNlIGJ1bmRsZWQgTGFtYmRhIGFzc2V0IGNvZGVcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGJ1bmRsZShvcHRpb25zOiBCdW5kbGluZ09wdGlvbnMpOiBsYW1iZGEuQ29kZSB7XG4gIGNvbnN0IHsgZW50cnksIHJ1bnRpbWUsIGFyY2hpdGVjdHVyZSwgb3V0cHV0UGF0aFN1ZmZpeCB9ID0gb3B0aW9ucztcblxuICBjb25zdCBzdGFnZWRpciA9IGNkay5GaWxlU3lzdGVtLm1rZHRlbXAoJ3B5dGhvbi1idW5kbGluZy0nKTtcbiAgY29uc3QgaGFzRGVwcyA9IHN0YWdlRGVwZW5kZW5jaWVzKGVudHJ5LCBzdGFnZWRpcik7XG5cbiAgY29uc3QgZGVwc0NvbW1hbmQgPSBjaGFpbihbXG4gICAgaGFzRGVwcyA/IGByc3luYyAtciAke0JVTkRMRVJfREVQRU5ERU5DSUVTX0NBQ0hFfS8uICR7Y2RrLkFzc2V0U3RhZ2luZy5CVU5ETElOR19PVVRQVVRfRElSfS8ke291dHB1dFBhdGhTdWZmaXh9YCA6ICcnLFxuICAgIGByc3luYyAtciAuICR7Y2RrLkFzc2V0U3RhZ2luZy5CVU5ETElOR19PVVRQVVRfRElSfS8ke291dHB1dFBhdGhTdWZmaXh9YCxcbiAgXSk7XG5cbiAgLy8gRGV0ZXJtaW5lIHdoaWNoIGRvY2tlcmZpbGUgdG8gdXNlLiBXaGVuIGRlcGVuZGVuY2llcyBhcmUgcHJlc2VudCwgd2UgdXNlIGFcbiAgLy8gRG9ja2VyZmlsZSB0aGF0IGNhbiBjcmVhdGUgYSBjYWNoZWFibGUgbGF5ZXIuIFdlIGNhbid0IHVzZSB0aGlzIERvY2tlcmZpbGVcbiAgLy8gaWYgdGhlcmUgYXJlbid0IGRlcGVuZGVuY2llcyBvciB0aGUgRG9ja2VyZmlsZSB3aWxsIGNvbXBsYWluIGFib3V0IG1pc3NpbmdcbiAgLy8gc291cmNlcy5cbiAgY29uc3QgZG9ja2VyZmlsZSA9IGhhc0RlcHNcbiAgICA/ICdEb2NrZXJmaWxlLmRlcGVuZGVuY2llcydcbiAgICA6ICdEb2NrZXJmaWxlJztcblxuICAvLyBjb3B5IERvY2tlcmZpbGUgdG8gd29ya2RpclxuICBmcy5jb3B5RmlsZVN5bmMocGF0aC5qb2luKF9fZGlybmFtZSwgZG9ja2VyZmlsZSksIHBhdGguam9pbihzdGFnZWRpciwgZG9ja2VyZmlsZSkpO1xuXG4gIGNvbnN0IGltYWdlID0gY2RrLkRvY2tlckltYWdlLmZyb21CdWlsZChzdGFnZWRpciwge1xuICAgIGJ1aWxkQXJnczoge1xuICAgICAgSU1BR0U6IHJ1bnRpbWUuYnVuZGxpbmdJbWFnZS5pbWFnZSxcbiAgICB9LFxuICAgIHBsYXRmb3JtOiBhcmNoaXRlY3R1cmUuZG9ja2VyUGxhdGZvcm0sXG4gICAgZmlsZTogZG9ja2VyZmlsZSxcbiAgfSk7XG5cbiAgcmV0dXJuIGxhbWJkYS5Db2RlLmZyb21Bc3NldChlbnRyeSwge1xuICAgIGFzc2V0SGFzaFR5cGU6IG9wdGlvbnMuYXNzZXRIYXNoVHlwZSxcbiAgICBhc3NldEhhc2g6IG9wdGlvbnMuYXNzZXRIYXNoLFxuICAgIGV4Y2x1ZGU6IERFUEVOREVOQ1lfRVhDTFVERVMsXG4gICAgYnVuZGxpbmc6IHtcbiAgICAgIGltYWdlLFxuICAgICAgY29tbWFuZDogWydiYXNoJywgJy1jJywgZGVwc0NvbW1hbmRdLFxuICAgIH0sXG4gIH0pO1xufVxuXG4vKipcbiAqIENoZWNrcyB0byBzZWUgaWYgdGhlIGBlbnRyeWAgZGlyZWN0b3J5IGNvbnRhaW5zIGEgdHlwZSBvZiBkZXBlbmRlbmN5IHRoYXRcbiAqIHdlIGtub3cgaG93IHRvIGluc3RhbGwuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzdGFnZURlcGVuZGVuY2llcyhlbnRyeTogc3RyaW5nLCBzdGFnZWRpcjogc3RyaW5nKTogYm9vbGVhbiB7XG4gIGNvbnN0IHByZWZpeGVzID0gW1xuICAgICdQaXBmaWxlJyxcbiAgICAncHlwcm9qZWN0JyxcbiAgICAncG9ldHJ5JyxcbiAgICAncmVxdWlyZW1lbnRzLnR4dCcsXG4gIF07XG5cbiAgbGV0IGZvdW5kID0gZmFsc2U7XG4gIGZvciAoY29uc3QgZmlsZSBvZiBmcy5yZWFkZGlyU3luYyhlbnRyeSkpIHtcbiAgICBmb3IgKGNvbnN0IHByZWZpeCBvZiBwcmVmaXhlcykge1xuICAgICAgaWYgKGZpbGUuc3RhcnRzV2l0aChwcmVmaXgpKSB7XG4gICAgICAgIGZzLmNvcHlGaWxlU3luYyhwYXRoLmpvaW4oZW50cnksIGZpbGUpLCBwYXRoLmpvaW4oc3RhZ2VkaXIsIGZpbGUpKTtcbiAgICAgICAgZm91bmQgPSB0cnVlO1xuICAgICAgfVxuICAgIH1cbiAgfVxuXG4gIHJldHVybiBmb3VuZDtcbn1cblxuZnVuY3Rpb24gY2hhaW4oY29tbWFuZHM6IHN0cmluZ1tdKTogc3RyaW5nIHtcbiAgcmV0dXJuIGNvbW1hbmRzLmZpbHRlcihjID0+ICEhYykuam9pbignICYmICcpO1xufVxuIl19

package/lib/function.d.ts

@@ -0,0 +1,91 @@
+import * as lambda from 'aws-cdk-lib/aws-lambda';
+import { AssetHashType } from 'aws-cdk-lib';
+import { Construct } from 'constructs';
+/**
+ * (experimental) Properties for a PythonFunction.
+ *
+ * @experimental
+ */
+export interface PythonFunctionProps extends lambda.FunctionOptions {
+    /**
+     * (experimental) The path to the root directory of the function.
+     *
+     * @experimental
+     */
+    readonly entry: string;
+    /**
+     * (experimental) The path (relative to entry) to the index file containing the exported handler.
+     *
+     * @default index.py
+     * @experimental
+     */
+    readonly index?: string;
+    /**
+     * (experimental) The name of the exported handler in the index file.
+     *
+     * @default handler
+     * @experimental
+     */
+    readonly handler?: string;
+    /**
+     * (experimental) The runtime environment.
+     *
+     * Only runtimes of the Python family are
+     * supported.
+     *
+     * @default lambda.Runtime.PYTHON_3_7
+     * @experimental
+     */
+    readonly runtime?: lambda.Runtime;
+    /**
+     * (experimental) Determines how asset hash is calculated. Assets will get rebuild and uploaded only if their hash has changed.
+     *
+     * If asset hash is set to `SOURCE` (default), then only changes to the source
+     * directory will cause the asset to rebuild. This means, for example, that in
+     * order to pick up a new dependency version, a change must be made to the
+     * source tree. Ideally, this can be implemented by including a dependency
+     * lockfile in your source tree or using fixed dependencies.
+     *
+     * If the asset hash is set to `OUTPUT`, the hash is calculated after
+     * bundling. This means that any change in the output will cause the asset to
+     * be invalidated and uploaded. Bear in mind that `pip` adds timestamps to
+     * dependencies it installs, which implies that in this mode Python bundles
+     * will _always_ get rebuild and uploaded. Normally this is an anti-pattern
+     * since build
+     *
+     * @default AssetHashType.SOURCE By default, hash is calculated based on the
+     * contents of the source directory. This means that only updates to the
+     * source will cause the asset to rebuild.
+     * @experimental
+     */
+    readonly assetHashType?: AssetHashType;
+    /**
+     * (experimental) Specify a custom hash for this asset.
+     *
+     * If `assetHashType` is set it must
+     * be set to `AssetHashType.CUSTOM`. For consistency, this custom hash will
+     * be SHA256 hashed and encoded as hex. The resulting hash will be the asset
+     * hash.
+     *
+     * NOTE: the hash is used in order to identify a specific revision of the asset, and
+     * used for optimizing and caching deployment activities related to this asset such as
+     * packaging, uploading to Amazon S3, etc. If you chose to customize the hash, you will
+     * need to make sure it is updated every time the asset changes, or otherwise it is
+     * possible that some deployments will not be invalidated.
+     *
+     * @default - based on `assetHashType`
+     * @experimental
+     */
+    readonly assetHash?: string;
+}
+/**
+ * (experimental) A Python Lambda function.
+ *
+ * @experimental
+ */
+export declare class PythonFunction extends lambda.Function {
+    /**
+     * @experimental
+     */
+    constructor(scope: Construct, id: string, props: PythonFunctionProps);
+}