{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This guide will show how to add unit tests and debug CBA Kotlin scripts.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Add pom.xml to your CBA","type":"text"}]},{"type":"paragraph","content":[{"text":".","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"text":"├── Definitions\n│ └── definition.json\n├── Scripts\n│ └── kotlin\n│ └── Script.kt\n├── TOSCA-Metadata\n│ └── TOSCA.meta\n├── pom.xml","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"pom.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n\n\n 4.0.0\n\n \n org.onap.ccsdk.cds.components.cba\n test-blueprint-kotlin-parent\n 1.1.0-SNAPSHOT\n \n\n test-kotlin-script\n 1.1.0-SNAPSHOT\n pom\n\n \n \n ccsdkapps\n ccsdkapps\n \n \n\n\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Add the above pom.xml to your CBA and change artifactId to your-cba-name.","type":"text"}]},{"type":"paragraph","content":[{"text":"The pom references a parent which defines all test dependencies. The parent also includes a profile (-Pdeploy-cba) which will enrich and publish the CBA to a running CDS instance.","type":"text"}]},{"type":"paragraph","content":[{"text":"The deploy-cba profile can be configured by setting properties described in the example pom.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Run tests with maven","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn clean test","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Build zip file","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"# This will build /target/your-cba-name-1.0.0-SNAPSHOT-cba.zip\nmvn clean install","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Deploy cba with maven","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"# This will build /target/your-cba-name-1.0.0-SNAPSHOT-cba.zip \n# Enrich CBA and add /target/your-cba-name-1.0.0-SNAPSHOT-enriched-cba.zip\n# Publish CBA to CDS \nmvn clean install -Pdeploy-cba","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Add Unit tests","type":"text"}]},{"type":"paragraph","content":[{"text":".\n├── Definitions\n│ └── definition.json\n├── Scripts\n│ └── kotlin\n│ └── Script.kt\n├── TOSCA-Metadata\n│ └── TOSCA.meta\n├── Tests\n│ └── kotlin\n│ └── ScriptTest.kt\n├── pom.xml\n","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"Kotlin unit tests should be added under /Tests/kotlin as show above. Test files must contain \"Test\" in the filename, for example ","type":"text"},{"text":"ScriptTest.kt","type":"text","marks":[{"type":"em"}]},{"text":" or ","type":"text"},{"text":"TestScript.kt","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Example project:","type":"text"}]},{"type":"paragraph","content":[{"text":"test-kotlin-script.zip","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/download/attachments/16441083/test-kotlin-script.zip?version=2&modificationDate=1614016224000&cacheVersion=1&api=v2"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Libraries:","type":"text"}]},{"type":"paragraph","content":[{"text":"https://junit.org/junit4/","type":"text","marks":[{"type":"link","attrs":{"href":"https://junit.org/junit4/"}}]}]},{"type":"paragraph","content":[{"text":"https://mockk.io/","type":"text","marks":[{"type":"link","attrs":{"href":"https://mockk.io/"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Debugging","type":"text"}]},{"type":"paragraph","content":[{"text":"After the pom is added, the CBA can be used in IntelliJ as a maven project.","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a new empty project","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":70.0},"content":[{"type":"media","attrs":{"width":2342,"id":"162086d2-db80-47a2-a466-8cbb1b157f9a","collection":"contentId-16441083","type":"file","height":1040}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Give it a name","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":81.0},"content":[{"type":"media","attrs":{"width":2346,"id":"48444ba0-c54d-4a0c-b419-e2ef2a497c66","collection":"contentId-16441083","type":"file","height":900}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Click the + symbol and select import module","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":821,"id":"88886a1e-6327-4384-940a-69b4c296f0d6","collection":"contentId-16441083","type":"file","height":434}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Select the pom.xml in your CBA directory","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":796,"id":"4fc5c12f-a04d-49a3-982b-7901acbd49c2","collection":"contentId-16441083","type":"file","height":251}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"You should now be able to write, run and debug unit tests","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":1916,"id":"1b71007b-cfa6-48d4-b4b6-40f98fae7d46","collection":"contentId-16441083","type":"file","height":1057}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"CDS Runtime debuging","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Open File → Project Structure","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":704,"id":"8e3b26bc-3b78-463f-9ad6-f38bc8aca215","collection":"contentId-16441083","type":"file","height":452}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Click the + symbol and select Import Module","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":62.0},"content":[{"type":"media","attrs":{"width":672,"id":"5c4ce4f0-32a8-4e19-bb46-3efcf50bb7be","collection":"contentId-16441083","type":"file","height":336}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Select pom.xml in the CDS root directory","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":82.0},"content":[{"type":"media","attrs":{"width":1058,"id":"c0744389-6dbf-40a9-9b05-87b8fe826bf6","collection":"contentId-16441083","type":"file","height":399}}]},{"type":"paragraph","content":[{"text":"You should now have both your CBA and CDS as modules in the project","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":944,"id":"6aeb5dc2-c93f-40bc-aa98-6795938ecd8b","collection":"contentId-16441083","type":"file","height":608}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Make sure your cds run configuration is setup properly and then start CDS in debug mode","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":1898,"id":"bf9202a9-1e86-434e-a27e-84eb5f281688","collection":"contentId-16441083","type":"file","height":1052}}]},{"type":"paragraph","content":[{"text":"Right-click your cba package and select Open In Terminal","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":907,"id":"cb0e5e7a-0082-467c-9525-415846db09da","collection":"contentId-16441083","type":"file","height":857}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Make sure your cds properties are correct in your CBA pom.xml, then run the below command in the terminal","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn clean install -Pdeploy-cba","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":1696,"id":"05804f42-d3ff-4ba1-88d7-34ff6c954408","collection":"contentId-16441083","type":"file","height":1047}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Maven will enrich and deploy your CBA to CDS","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":1883,"id":"da2380ff-3fd6-4e3b-95b0-1079afb11fd9","collection":"contentId-16441083","type":"file","height":345}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"You should now be able to place breakpoints in your script","type":"text"}]},{"type":"paragraph","content":[{"text":"Send your request to CDS and start debugging","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":1916,"id":"ac7cdeeb-0c0a-4733-8034-43a4ef5d309e","collection":"contentId-16441083","type":"file","height":1055}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}