docs(examples/python-app): fixes for python example

.projenrc.ts

@@ -214,6 +214,7 @@ new JsonFile(project, '.vscode/settings.json', {
     '[svg]': {
       'editor.defaultFormatter': 'jock.svg',
     },
+    'python.formatting.provider': 'black',
   },
 });
 

examples/python-app/README.md

@@ -9,20 +9,20 @@ All interfaces are available, but the esbuild binary must be available in path,
 
 To set up a new virtualenv, run
 
-```
-$ python3 -m venv .venv
+```bash
+python3 -m venv .venv
 ```
 
 Then activate the venv and install all dependencies:
 
-```
-$ source .venv/bin/activate
-$ pip install -r requirements.txt
-$ npm install --location=global esbuild
+```bash
+source .venv/bin/activate
+pip install -r requirements.txt -r requirements-dev.txt
+npm install -g esbuild
 ```
 
-Finally run the CDK app:
+Run the CDK app providing the `CDK_ESBUILD_MODULE_PATH`:
 
+```bash
+CDK_ESBUILD_MODULE_PATH="$(npm prefix -g)/lib/node_modules/esbuild" cdk synth
 ```
-$ cdk synth
-```

examples/python-app/python_app/python_app_stack.py

@@ -1,3 +1,4 @@
+import os
 from aws_cdk import Stack
 import aws_cdk.aws_lambda as lambda_
 import aws_cdk.aws_s3 as s3
@@ -19,7 +20,10 @@ def __init__(self, scope: Construct, construct_id: str, **kwargs) -> None:
             self,
             "Website",
             sources=[
-                TypeScriptSource("lambda-handler/index.ts", copy_dir="lambda-handler")
+                TypeScriptSource(
+                    "lambda-handler/index.ts",
+                    copy_dir="lambda-handler",
+                )
             ],
             destination_bucket=s3.Bucket(
                 self,
@@ -37,6 +41,9 @@ def __init__(self, scope: Construct, construct_id: str, **kwargs) -> None:
                 build_options=BuildOptions(
                     format="esm", outfile="index.mjs", external=["aws-sdk"]
                 ),
+                # Override the global setting with a specific path per Construct
+                # This can be useful if a Construct requires a different version of esbuild
+                esbuild_module_path="/project/node_modules/esbuild@13",
             ),
         )
 

examples/python-app/requirements-dev.txt

@@ -1 +1,2 @@
 pytest==6.2.5
+black>=22.6.0

examples/python-app/requirements.txt

@@ -1,3 +1,3 @@
-aws-cdk-lib==2.27.0
+aws-cdk-lib==2.37.1
 constructs>=10.0.0,<11.0.0
-mrgrain.cdk-esbuild>=4.0.0
+mrgrain.cdk-esbuild>=3.10.0