projen 0.100.5 → 0.100.7

package/.jsii

@@ -61,7 +61,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/projen/projen.git",
-  "jsiiVersion": "6.0.3 (build 3c89083)",
+  "jsiiVersion": "6.0.4 (build 308d98d)",
   "keywords": [
     "cdk",
     "cicd",
@@ -10526,7 +10526,7 @@
         },
         "locationInModule": {
           "filename": "src/task.ts",
-          "line": 57
+          "line": 76
         },
         "parameters": [
           {
@@ -10547,7 +10547,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/task.ts",
-        "line": 42
+        "line": 61
       },
       "methods": [
         {
@@ -10559,7 +10559,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 130
+            "line": 161
           },
           "name": "addCondition",
           "parameters": [
@@ -10584,7 +10584,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 161
+            "line": 192
           },
           "name": "addSteps",
           "parameters": [
@@ -10609,7 +10609,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 185
+            "line": 234
           },
           "name": "builtin",
           "parameters": [
@@ -10631,7 +10631,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 268
+            "line": 317
           },
           "name": "env",
           "parameters": [
@@ -10663,7 +10663,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 170
+            "line": 201
           },
           "name": "exec",
           "parameters": [
@@ -10688,6 +10688,45 @@
             }
           ]
         },
+        {
+          "docs": {
+            "example": "task.execArgs([\"echo\", \"hello world\"]);",
+            "remarks": "A convenient alternative to `Task.exec`: arguments with spaces or\nspecial characters are passed through as-is, with no quoting needed. The\nelements are not run through a shell, so environment variables (`$FOO`) are\nnot expanded and other shell features are unavailable.",
+            "stability": "experimental",
+            "summary": "Executes a command provided as a list of the program followed by its arguments (an \"argv\")."
+          },
+          "locationInModule": {
+            "filename": "src/task.ts",
+            "line": 219
+          },
+          "name": "execArgs",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "The program followed by its arguments."
+              },
+              "name": "command",
+              "type": {
+                "collection": {
+                  "elementtype": {
+                    "primitive": "string"
+                  },
+                  "kind": "array"
+                }
+              }
+            },
+            {
+              "docs": {
+                "summary": "Options."
+              },
+              "name": "options",
+              "optional": true,
+              "type": {
+                "fqn": "projen.TaskStepOptions"
+              }
+            }
+          ]
+        },
         {
           "docs": {
             "stability": "experimental",
@@ -10695,7 +10734,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 299
+            "line": 348
           },
           "name": "insertStep",
           "parameters": [
@@ -10729,7 +10768,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 80
+            "line": 111
           },
           "name": "lock"
         },
@@ -10740,7 +10779,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 219
+            "line": 268
           },
           "name": "prependExec",
           "parameters": [
@@ -10769,7 +10808,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 235
+            "line": 284
           },
           "name": "prependSay",
           "parameters": [
@@ -10798,7 +10837,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 227
+            "line": 276
           },
           "name": "prependSpawn",
           "parameters": [
@@ -10827,7 +10866,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 211
+            "line": 260
           },
           "name": "prependSteps",
           "parameters": [
@@ -10850,7 +10889,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 343
+            "line": 392
           },
           "name": "removeStep",
           "parameters": [
@@ -10872,7 +10911,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 138
+            "line": 169
           },
           "name": "reset",
           "parameters": [
@@ -10902,7 +10941,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 194
+            "line": 243
           },
           "name": "say",
           "parameters": [
@@ -10934,7 +10973,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 202
+            "line": 251
           },
           "name": "spawn",
           "parameters": [
@@ -10962,7 +11001,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 321
+            "line": 370
           },
           "name": "updateStep",
           "parameters": [
@@ -10997,7 +11036,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 276
+            "line": 325
           },
           "name": "envVars",
           "type": {
@@ -11017,7 +11056,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 46
+            "line": 65
           },
           "name": "name",
           "type": {
@@ -11032,7 +11071,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 283
+            "line": 332
           },
           "name": "steps",
           "type": {
@@ -11053,7 +11092,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 116
+            "line": 147
           },
           "name": "condition",
           "optional": true,
@@ -11069,7 +11108,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 87
+            "line": 118
           },
           "name": "cwd",
           "optional": true,
@@ -11085,7 +11124,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 101
+            "line": 132
           },
           "name": "description",
           "optional": true,
@@ -11242,7 +11281,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 35
+            "line": 54
           },
           "name": "args",
           "optional": true,
@@ -11259,13 +11298,14 @@
           "abstract": true,
           "docs": {
             "default": "- add steps using `task.exec(command)` or `task.spawn(subtask)`",
+            "remarks": "Mutually exclusive with `execArgs`.",
             "stability": "experimental",
             "summary": "Shell command to execute as the first command of the task."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 14
+            "line": 17
           },
           "name": "exec",
           "optional": true,
@@ -11273,6 +11313,31 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- add steps using `task.execArgs(args)`, `task.exec(command)` or `task.spawn(subtask)`",
+            "remarks": "A convenient alternative to `exec`: arguments with spaces or special\ncharacters are passed through as-is, with no quoting needed. The elements\nare not run through a shell, so environment variables (`$FOO`) are not\nexpanded and other shell features are unavailable.",
+            "see": "TaskStep.execArgs *\nMutually exclusive with `exec`.",
+            "stability": "experimental",
+            "summary": "Shell command to execute as the first command of the task, provided as a list of the program followed by its arguments (an \"argv\")."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task.ts",
+            "line": 33
+          },
+          "name": "execArgs",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -11284,7 +11349,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 27
+            "line": 46
           },
           "name": "receiveArgs",
           "optional": true,
@@ -11301,7 +11366,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 19
+            "line": 38
           },
           "name": "steps",
           "optional": true,
@@ -11406,7 +11471,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 191
+            "line": 216
           },
           "name": "builtin",
           "optional": true,
@@ -11418,13 +11483,14 @@
           "abstract": true,
           "docs": {
             "default": "- don't execute a shell command",
+            "remarks": "The whole command is a single shell string. To pass arguments as a list\ninstead - without having to quote spaces or other characters yourself -\nuse `execArgs`.",
             "stability": "experimental",
             "summary": "Shell command to execute."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 164
+            "line": 168
           },
           "name": "exec",
           "optional": true,
@@ -11432,6 +11498,31 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- don't execute a shell command",
+            "example": "{ execArgs: [\"echo\", \"hello world\"] }",
+            "remarks": "Often more convenient than `exec`: each element is passed to the\nprogram as-is, so arguments with spaces or special characters don't need\nquoting. Fixed (`args`) or received (`receiveArgs`) arguments are inserted\nwherever a `$@` element appears, or appended at the end if there is none.\n\nThe elements are not run through a shell, so environment variables (`$FOO`)\nare not expanded and other shell features are unavailable. Use `exec`\nif you need them.\n\nMutually exclusive with `exec`.",
+            "stability": "experimental",
+            "summary": "Shell command to execute, provided as a list of the program followed by its arguments (an \"argv\")."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 189
+          },
+          "name": "execArgs",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -11442,7 +11533,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 177
+            "line": 202
           },
           "name": "say",
           "optional": true,
@@ -11460,7 +11551,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 171
+            "line": 196
           },
           "name": "spawn",
           "optional": true,
@@ -14266,7 +14357,7 @@
         },
         "locationInModule": {
           "filename": "src/awscdk/awscdk-app-ts.ts",
-          "line": 130
+          "line": 131
         },
         "parameters": [
           {
@@ -14280,7 +14371,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/awscdk/awscdk-app-ts.ts",
-        "line": 105
+        "line": 106
       },
       "name": "AwsCdkTypeScriptApp",
       "namespace": "awscdk",
@@ -14293,7 +14384,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 116
+            "line": 117
           },
           "name": "appEntrypoint",
           "type": {
@@ -14308,7 +14399,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 126
+            "line": 127
           },
           "name": "cdkConfig",
           "type": {
@@ -14322,7 +14413,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 128
+            "line": 129
           },
           "name": "cdkDeps",
           "type": {
@@ -14337,7 +14428,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 121
+            "line": 122
           },
           "name": "cdkTasks",
           "type": {
@@ -14352,7 +14443,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 109
+            "line": 110
           },
           "name": "cdkVersion",
           "type": {
@@ -14377,7 +14468,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/awscdk/awscdk-app-ts.ts",
-        "line": 23
+        "line": 24
       },
       "name": "AwsCdkTypeScriptAppOptions",
       "namespace": "awscdk",
@@ -14391,7 +14482,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 39
+            "line": 40
           },
           "name": "app",
           "optional": true,
@@ -14409,7 +14500,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 34
+            "line": 35
           },
           "name": "appEntrypoint",
           "optional": true,
@@ -14427,7 +14518,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 56
+            "line": 57
           },
           "name": "edgeLambdaAutoDiscover",
           "optional": true,
@@ -14445,7 +14536,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 90
+            "line": 91
           },
           "name": "experimentalIntegRunner",
           "optional": true,
@@ -14463,7 +14554,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 82
+            "line": 83
           },
           "name": "integrationTestAutoDiscover",
           "optional": true,
@@ -14481,7 +14572,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 47
+            "line": 48
           },
           "name": "lambdaAutoDiscover",
           "optional": true,
@@ -14499,7 +14590,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 74
+            "line": 75
           },
           "name": "lambdaExtensionAutoDiscover",
           "optional": true,
@@ -14517,7 +14608,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 97
+            "line": 98
           },
           "name": "lambdaOptions",
           "optional": true,
@@ -14535,7 +14626,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/awscdk-app-ts.ts",
-            "line": 65
+            "line": 66
           },
           "name": "singletonLambdaAutoDiscover",
           "optional": true,
@@ -50407,7 +50498,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 972
+            "line": 979
           },
           "name": "addBins",
           "parameters": [
@@ -50432,7 +50523,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1236
+            "line": 1243
           },
           "name": "addBundledDeps",
           "parameters": [
@@ -50457,7 +50548,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1190
+            "line": 1197
           },
           "name": "addDeps",
           "parameters": [
@@ -50482,7 +50573,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1203
+            "line": 1210
           },
           "name": "addDevDeps",
           "parameters": [
@@ -50507,7 +50598,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1008
+            "line": 1015
           },
           "name": "addFields",
           "parameters": [
@@ -50534,7 +50625,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1018
+            "line": 1025
           },
           "name": "addKeywords",
           "parameters": [
@@ -50561,7 +50652,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1248
+            "line": 1255
           },
           "name": "addPackageIgnore",
           "overrides": "projen.Project",
@@ -50585,7 +50676,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1220
+            "line": 1227
           },
           "name": "addPeerDeps",
           "parameters": [
@@ -50610,7 +50701,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 990
+            "line": 997
           },
           "name": "addScripts",
           "parameters": [
@@ -50637,7 +50728,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1000
+            "line": 1007
           },
           "name": "removeScript",
           "parameters": [
@@ -50660,7 +50751,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1110
+            "line": 1117
           },
           "name": "renderWorkflowSetup",
           "parameters": [
@@ -50694,7 +50785,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1321
+            "line": 1328
           },
           "name": "runTaskCommand",
           "overrides": "projen.Project",
@@ -50722,7 +50813,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 982
+            "line": 989
           },
           "name": "setScript",
           "parameters": [
@@ -50931,7 +51022,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1328
+            "line": 1335
           },
           "name": "buildWorkflowJobId",
           "optional": true,
@@ -53116,7 +53207,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/javascript/node-project.ts",
-        "line": 1446
+        "line": 1453
       },
       "name": "RenderWorkflowSetupOptions",
       "namespace": "javascript",
@@ -53132,7 +53223,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1455
+            "line": 1462
           },
           "name": "installStepConfiguration",
           "optional": true,
@@ -53150,7 +53241,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1460
+            "line": 1467
           },
           "name": "mutable",
           "optional": true,
@@ -65360,7 +65451,7 @@
           },
           "locationInModule": {
             "filename": "src/python/pip.ts",
-            "line": 43
+            "line": 55
           },
           "name": "addDependency",
           "overrides": "projen.python.IPythonDeps",
@@ -65383,7 +65474,7 @@
           },
           "locationInModule": {
             "filename": "src/python/pip.ts",
-            "line": 52
+            "line": 64
           },
           "name": "addDevDependency",
           "overrides": "projen.python.IPythonDeps",
@@ -65406,7 +65497,7 @@
           },
           "locationInModule": {
             "filename": "src/python/pip.ts",
-            "line": 59
+            "line": 71
           },
           "name": "installDependencies",
           "overrides": "projen.python.IPythonDeps"
@@ -78983,7 +79074,7 @@
         },
         "locationInModule": {
           "filename": "src/typescript/typescript.ts",
-          "line": 931
+          "line": 933
         },
         "parameters": [
           {
@@ -78997,7 +79088,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/typescript/typescript.ts",
-        "line": 930
+        "line": 932
       },
       "name": "TypeScriptAppProject",
       "namespace": "typescript",
@@ -79044,7 +79135,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 674
+            "line": 676
           },
           "name": "defaultTypeScriptCompilerOptions",
           "protected": true,
@@ -82226,6 +82317,6 @@
   "usedFeatures": [
     "class-covariant-overrides"
   ],
-  "version": "0.100.5",
-  "fingerprint": "q1tbyPsADtVpgt9826jOU5tKIDY9zzN5RVu6xtBw4mk="
+  "version": "0.100.7",
+  "fingerprint": "dOi6JcK8AnWZhGPP66lf133THWYYINUK+iww8kM+ptA="
 }