template stats --experimental

docs/docs/interface.md

@@ -2692,7 +2692,7 @@ collects stats of a given service template (experimental)
 
 === "CLI"
     ```shell linenums="1"
-    vintner template stats --template ${TEMPLATE}
+    vintner template stats --experimental --template ${TEMPLATE}
     ```
 
 === "cURL"

examples/unfurl-artifacts/stats/stats.sh

@@ -15,9 +15,9 @@ yarn cli template stats \
 echo
 
 echo "VDMMv1"
-yarn cli template stats --template examples/unfurl-artifacts/stats/variable-service-template-v1.yaml
+yarn cli template stats --experimental --template examples/unfurl-artifacts/stats/variable-service-template-v1.yaml
 echo
 
 echo "VDMMv2"
-yarn cli template stats --template examples/unfurl-artifacts/stats/variable-service-template-v2.yaml
+yarn cli template stats --experimental --template examples/unfurl-artifacts/stats/variable-service-template-v2.yaml
 echo

examples/unfurl-technology-automated-counting/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/variable-service-template.yaml
+yarn cli template stats --experimental --template ${PWD}/variable-service-template.yaml

examples/unfurl-technology-automated-random/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/variable-service-template.yaml
+yarn cli template stats --experimental --template ${PWD}/variable-service-template.yaml

examples/unfurl-technology-automated-weighted/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/variable-service-template.yaml
+yarn cli template stats --experimental --template ${PWD}/variable-service-template.yaml

examples/unfurl-technology-baseline-elastic/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/variable-service-template.yaml
+yarn cli template stats --experimental --template ${PWD}/variable-service-template.yaml

examples/unfurl-technology-baseline-kubernetes/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/variable-service-template.yaml
+yarn cli template stats --experimental --template ${PWD}/variable-service-template.yaml

examples/unfurl-technology-baseline-static-large/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/variable-service-template.yaml
+yarn cli template stats --experimental --template ${PWD}/variable-service-template.yaml

examples/unfurl-technology-baseline-static/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/variable-service-template.yaml
+yarn cli template stats --experimental --template ${PWD}/variable-service-template.yaml

examples/unfurl-technology-maintenance/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/variable-service-template.yaml
+yarn cli template stats --experimental --template ${PWD}/variable-service-template.yaml

examples/unfurl-technology-manual/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/variable-service-template.yaml
+yarn cli template stats --experimental --template ${PWD}/variable-service-template.yaml

examples/xopera-pruning-consistent-loose/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/enriched.yaml
+yarn cli template stats --experimental --template ${PWD}/enriched.yaml

examples/xopera-pruning/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/enriched.yaml
+yarn cli template stats --experimental --template ${PWD}/enriched.yaml

src/cli/program.ts

@@ -400,6 +400,7 @@ template
     .command('stats')
     .description('collects stats of a given service template (experimental)')
     .requiredOption('--template <strings...>', 'path to service template')
+    .requiredOption('--experimental', 'enable experimental feature')
     .action(
         hae.exit(async options => {
             const result = await Controller.template.stats(options)

src/controller/template/stats.ts

@@ -8,6 +8,7 @@ import * as utils from '#utils'
 
 export type TemplateStatsOptions = {
     template: string[]
+    experimental: boolean
 }
 
 export type TemplateStats = {
@@ -31,6 +32,7 @@ export type TemplateStats = {
 
 export default async function (options: TemplateStatsOptions) {
     assert.isDefined(options.template, 'Template not defined')
+    assert.isTrue(options.experimental)
 
     // TODO: count technologies encoded in node type
 

src/utils/assert.ts

@@ -37,6 +37,10 @@ export function isBoolean(element: unknown): asserts element is boolean {
     if (!check.isBoolean(element)) throw new Error(`Element "${utils.stringify(element)}" is not a boolean`)
 }
 
+export function isTrue(element: unknown): asserts element is true {
+    if (!check.isTrue(element)) throw new Error(`Element "${utils.stringify(element)} is not "true"`)
+}
+
 export function isStatement(boolean: boolean, msg: string) {
     if (!boolean) throw new Error(msg)
 }

tests/pruning-modes/01-manual/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/enriched.yaml
+yarn cli template stats --experimental --template ${PWD}/enriched.yaml

tests/pruning-modes/02-consistent-strict/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/enriched.yaml
+yarn cli template stats --experimental --template ${PWD}/enriched.yaml

tests/pruning-modes/04-default/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/enriched.yaml
+yarn cli template stats --experimental --template ${PWD}/enriched.yaml

tests/pruning-modes/05-semantic-strict/stats.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/bash
 set -e
 
-yarn cli template stats --template ${PWD}/enriched.yaml
+yarn cli template stats --experimental --template ${PWD}/enriched.yaml