cloudsnorkel.cdk-turbo-layers 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

cloudsnorkel/cdk_turbo_layers/__init__.py

@@ -84,7 +84,9 @@ The best way to browse API documentation is on [Constructs Hub](https://construc
       dotnet add package CloudSnorkel.Cdk.TurboLayers
       ```
 
-## Example
+## Examples
+
+The very basic example below will create a layer with dependencies specified as parameters and attach it to a Lambda function.
 
 ```python
  const packager = new PythonDependencyPackager(this, 'Packager', {
@@ -98,15 +100,77 @@ new Function(this, 'Function with inline requirements', {
     // this will create a layer from with requests and Scrapy in a Lambda function instead of locally
     layers: [packager.layerFromInline('inline requirements', ['requests', 'Scrapy'])],
 });
+```
+
+The next example will create a layer with dependencies specified in a `requirements.txt` file and attach it to a Lambda function.
+
+```python
+const packager = new PythonDependencyPackager(this, 'Packager', {
+    runtime: lambda.Runtime.PYTHON_3_9,
+    type: DependencyPackagerType.LAMBDA,
+});
 new Function(this, 'Function with external source and requirements', {
     handler: 'index.handler',
     code: lambda.Code.fromAsset('lambda-src'),
     runtime: lambda.Runtime.PYTHON_3_9,
+    // this will read requirements.txt and create a layer from the requirements in a Lambda function instead of locally
+    layers: [packager.layerFromRequirementsTxt('requirements.txt', 'lambda-src')],
+});
+```
+
+Custom package managers like Pipenv or Poetry are also supported.
+
+```python
+const packager = new PythonDependencyPackager(this, 'Packager', {
+    runtime: lambda.Runtime.PYTHON_3_9,
+    type: DependencyPackagerType.LAMBDA,
+});
+new Function(this, 'Function with external source and requirements', {
+    handler: 'index.handler',
+    code: lambda.Code.fromAsset('lambda-poetry-src'),
+    runtime: lambda.Runtime.PYTHON_3_9,
     // this will read pyproject.toml and poetry.lock and create a layer from the requirements in a Lambda function instead of locally
-    layers: [packager.layerFromPoetry('poetry requirements', 'lambda-src')],
+    layers: [packager.layerFromPoetry('poetry dependencies', 'lambda-poetry-src')],
 });
 ```
 
+If your dependencies have some C library dependencies, you may need to use the more capable but slower CodeBuild packager.
+
+```python
+const packager = new PythonDependencyPackager(this, 'Packager', {
+    runtime: lambda.Runtime.PYTHON_3_9,
+    type: DependencyPackagerType.CODEBUILD,
+    preinstallCommands: [
+        'apt install -y libxml2-dev libxslt-dev libffi-dev libssl-dev',
+    ],
+});
+new Function(this, 'Function with external source and requirements', {
+    handler: 'index.handler',
+    code: lambda.Code.fromAsset('lambda-pipenv-src'),
+    runtime: lambda.Runtime.PYTHON_3_9,
+    layers: [packager.layerFromPipenv('pipenv dependencies', 'lambda-pipenv-src')],
+});
+```
+
+Building layers for ARM64 functions is also supported.
+
+```python
+const packager = new PythonDependencyPackager(this, 'Packager', {
+    runtime: lambda.Runtime.PYTHON_3_9,
+    type: DependencyPackagerType.LAMBDA,
+    architecture: Architecture.ARM_64,
+});
+new Function(this, 'Function with external source and requirements', {
+    handler: 'index.handler',
+    code: lambda.Code.fromAsset('lambda-poetry-src'),
+    runtime: lambda.Runtime.PYTHON_3_9,
+    architecture: Architecture.ARM_64,
+    layers: [packager.layerFromPoetry('poetry dependencies', 'lambda-poetry-src')],
+});
+```
+
+All these examples are for Python, but the same API is available for Node.js, Ruby, and Java. The same build options are available. Multiple different package managers are supported. See [Constructs Hub](https://constructs.dev/packages/@cloudsnorkel/cdk-turbo-layers/) for more details.
+
 ## Older Implementations
 
 * [lovage](https://github.com/CloudSnorkel/lovage): standalone Python framework that uses the same trick to deploy decorated functions to AWS

cloudsnorkel/cdk_turbo_layers/_jsii/__init__.py

@@ -15,9 +15,9 @@ import constructs._jsii
 
 __jsii_assembly__ = jsii.JSIIAssembly.load(
     "@cloudsnorkel/cdk-turbo-layers",
-    "0.2.0",
+    "0.2.2",
     __name__[0:-6],
-    "cdk-turbo-layers@0.2.0.jsii.tgz",
+    "cdk-turbo-layers@0.2.2.jsii.tgz",
 )
 
 __all__ = [

{cloudsnorkel.cdk_turbo_layers-0.2.0.dist-info → cloudsnorkel.cdk_turbo_layers-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cloudsnorkel.cdk-turbo-layers
-Version: 0.2.0
+Version: 0.2.2
 Summary: Speed-up Lambda function deployment with dependency layers built in AWS
 Home-page: https://github.com/CloudSnorkel/cdk-turbo-layers.git
 Author: Amir Szekely<amir@cloudsnorkel.com>
@@ -10,7 +10,6 @@ Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: JavaScript
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -18,12 +17,12 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Typing :: Typed
 Classifier: Development Status :: 4 - Beta
 Classifier: License :: OSI Approved
-Requires-Python: ~=3.7
+Requires-Python: ~=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: aws-cdk-lib <3.0.0,>=2.87.0
 Requires-Dist: constructs <11.0.0,>=10.0.5
-Requires-Dist: jsii <2.0.0,>=1.90.0
+Requires-Dist: jsii <2.0.0,>=1.93.0
 Requires-Dist: publication >=0.0.3
 Requires-Dist: typeguard ~=2.13.3
 
@@ -112,7 +111,9 @@ The best way to browse API documentation is on [Constructs Hub](https://construc
       dotnet add package CloudSnorkel.Cdk.TurboLayers
       ```
 
-## Example
+## Examples
+
+The very basic example below will create a layer with dependencies specified as parameters and attach it to a Lambda function.
 
 ```python
  const packager = new PythonDependencyPackager(this, 'Packager', {
@@ -126,15 +127,77 @@ new Function(this, 'Function with inline requirements', {
     // this will create a layer from with requests and Scrapy in a Lambda function instead of locally
     layers: [packager.layerFromInline('inline requirements', ['requests', 'Scrapy'])],
 });
+```
+
+The next example will create a layer with dependencies specified in a `requirements.txt` file and attach it to a Lambda function.
+
+```python
+const packager = new PythonDependencyPackager(this, 'Packager', {
+    runtime: lambda.Runtime.PYTHON_3_9,
+    type: DependencyPackagerType.LAMBDA,
+});
 new Function(this, 'Function with external source and requirements', {
     handler: 'index.handler',
     code: lambda.Code.fromAsset('lambda-src'),
     runtime: lambda.Runtime.PYTHON_3_9,
+    // this will read requirements.txt and create a layer from the requirements in a Lambda function instead of locally
+    layers: [packager.layerFromRequirementsTxt('requirements.txt', 'lambda-src')],
+});
+```
+
+Custom package managers like Pipenv or Poetry are also supported.
+
+```python
+const packager = new PythonDependencyPackager(this, 'Packager', {
+    runtime: lambda.Runtime.PYTHON_3_9,
+    type: DependencyPackagerType.LAMBDA,
+});
+new Function(this, 'Function with external source and requirements', {
+    handler: 'index.handler',
+    code: lambda.Code.fromAsset('lambda-poetry-src'),
+    runtime: lambda.Runtime.PYTHON_3_9,
     // this will read pyproject.toml and poetry.lock and create a layer from the requirements in a Lambda function instead of locally
-    layers: [packager.layerFromPoetry('poetry requirements', 'lambda-src')],
+    layers: [packager.layerFromPoetry('poetry dependencies', 'lambda-poetry-src')],
 });
 ```
 
+If your dependencies have some C library dependencies, you may need to use the more capable but slower CodeBuild packager.
+
+```python
+const packager = new PythonDependencyPackager(this, 'Packager', {
+    runtime: lambda.Runtime.PYTHON_3_9,
+    type: DependencyPackagerType.CODEBUILD,
+    preinstallCommands: [
+        'apt install -y libxml2-dev libxslt-dev libffi-dev libssl-dev',
+    ],
+});
+new Function(this, 'Function with external source and requirements', {
+    handler: 'index.handler',
+    code: lambda.Code.fromAsset('lambda-pipenv-src'),
+    runtime: lambda.Runtime.PYTHON_3_9,
+    layers: [packager.layerFromPipenv('pipenv dependencies', 'lambda-pipenv-src')],
+});
+```
+
+Building layers for ARM64 functions is also supported.
+
+```python
+const packager = new PythonDependencyPackager(this, 'Packager', {
+    runtime: lambda.Runtime.PYTHON_3_9,
+    type: DependencyPackagerType.LAMBDA,
+    architecture: Architecture.ARM_64,
+});
+new Function(this, 'Function with external source and requirements', {
+    handler: 'index.handler',
+    code: lambda.Code.fromAsset('lambda-poetry-src'),
+    runtime: lambda.Runtime.PYTHON_3_9,
+    architecture: Architecture.ARM_64,
+    layers: [packager.layerFromPoetry('poetry dependencies', 'lambda-poetry-src')],
+});
+```
+
+All these examples are for Python, but the same API is available for Node.js, Ruby, and Java. The same build options are available. Multiple different package managers are supported. See [Constructs Hub](https://constructs.dev/packages/@cloudsnorkel/cdk-turbo-layers/) for more details.
+
 ## Older Implementations
 
 * [lovage](https://github.com/CloudSnorkel/lovage): standalone Python framework that uses the same trick to deploy decorated functions to AWS

cloudsnorkel.cdk_turbo_layers-0.2.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+cloudsnorkel/cdk_turbo_layers/__init__.py,sha256=JZVvuz5qSTJqRoLsLaKd10OkC296AjSrNZJ3C7s0-v0,56865
+cloudsnorkel/cdk_turbo_layers/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+cloudsnorkel/cdk_turbo_layers/_jsii/__init__.py,sha256=ELmtBGkHIEwnm-DfHUpmk6haAmaYgXnhXBfMNI9GpAY,426
+cloudsnorkel/cdk_turbo_layers/_jsii/cdk-turbo-layers@0.2.2.jsii.tgz,sha256=YRUIhwmAwog-XNDgMZTg6g0u_knogalRa6jNMuHdDdA,331181
+cloudsnorkel.cdk_turbo_layers-0.2.2.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+cloudsnorkel.cdk_turbo_layers-0.2.2.dist-info/METADATA,sha256=UGQ8mcJhAM-XwYDCUoGEsWvQa9tt9EarYBTpMV0Ttz8,9696
+cloudsnorkel.cdk_turbo_layers-0.2.2.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+cloudsnorkel.cdk_turbo_layers-0.2.2.dist-info/top_level.txt,sha256=6vUrT-dcGOiRMT4Q6gEQPznoyS7nHOJ269MHpo4DEd8,13
+cloudsnorkel.cdk_turbo_layers-0.2.2.dist-info/RECORD,,

{cloudsnorkel.cdk_turbo_layers-0.2.0.dist-info → cloudsnorkel.cdk_turbo_layers-0.2.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.41.2)
+Generator: bdist_wheel (0.42.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

cloudsnorkel.cdk_turbo_layers-0.2.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-cloudsnorkel/cdk_turbo_layers/__init__.py,sha256=7F20yuHZpCLLjX-sRftw-ixO24xj4GMWUgN7cCKkz30,54245
-cloudsnorkel/cdk_turbo_layers/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-cloudsnorkel/cdk_turbo_layers/_jsii/__init__.py,sha256=ISETgxvvYmG6HH02RAJ3gEqd_XDTUw6JXy5WXlGM7IU,426
-cloudsnorkel/cdk_turbo_layers/_jsii/cdk-turbo-layers@0.2.0.jsii.tgz,sha256=oXBlGGRVhpAJQHW0yZNjaKgPslFld_ncSv6wZNtBJ_4,525951
-cloudsnorkel.cdk_turbo_layers-0.2.0.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-cloudsnorkel.cdk_turbo_layers-0.2.0.dist-info/METADATA,sha256=vHRPg1Q17JNTUTDs8DmB-ahRKyZKTUj1HH2ylZ-73Ws,7126
-cloudsnorkel.cdk_turbo_layers-0.2.0.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
-cloudsnorkel.cdk_turbo_layers-0.2.0.dist-info/top_level.txt,sha256=6vUrT-dcGOiRMT4Q6gEQPznoyS7nHOJ269MHpo4DEd8,13
-cloudsnorkel.cdk_turbo_layers-0.2.0.dist-info/RECORD,,