Create TNB jbang script

README.md

@@ -4,6 +4,8 @@ TNB is a collection of JUnit 5 extensions designed for testing with external ser
 
 For testing Camel based applications see [fuse-products](./fuse-products/README.md) README file.
 
+For using System-X services from your terminal see [jbang integration](./jbang/README.md) README file.
+
 ---
 
 There are two categories of System-X services: `Remote` and `Self-hosted`.

common/src/main/java/software/tnb/common/config/TestConfiguration.java

@@ -17,7 +17,6 @@ public class TestConfiguration extends Configuration {
     public static final String PRODUCT = "test.product";
     public static final String CREDENTIALS_FILE = "test.credentials.file";
     public static final String CREDENTIALS = "test.credentials";
-    public static final String USE_VAULT = "test.credentials.use.vault";
     public static final String VAULT_TOKEN = "test.credentials.vault.token";
     private static final String VAULT_SECRET_ID = "test.credentials.vault.secret.id";
     private static final String VAULT_ROLE_ID = "test.credentials.vault.role.id";
@@ -52,10 +51,6 @@ public static ProductType product() {
                 () -> new IllegalArgumentException(String.format("Unable to find enum for system property %s = %s", PRODUCT, getProperty(PRODUCT))));
     }
 
-    public static boolean useVault() {
-        return getBoolean(USE_VAULT, false);
-    }
-
     public static String vaultToken() {
         return getProperty(VAULT_TOKEN);
     }
@@ -77,11 +72,7 @@ public static String vaultAddress() {
     }
 
     public static String credentialsFile() {
-        final String credentials = getProperty(CREDENTIALS_FILE);
-        if (credentials == null) {
-            throw new IllegalArgumentException("No credentials file specified!");
-        }
-        return credentials;
+        return getProperty(CREDENTIALS_FILE);
     }
 
     public static String credentials() {

jbang/README.md

@@ -0,0 +1,38 @@
+# TNB CLI
+
+If you want to use System-X services from your terminal without writing a test case you can use the `tnb` script.
+
+## Installation
+You'll need `jbang` installed and TNB build locally. Use command
+`jbang app install jbang/tnb.java` to register the `tnb` command globally.
+
+## Usage
+The `tnb` CLI uses groovy shell, so any groovy language features should be valid.
+
+You can see it in action in this demo: 
+
+[![demo](demo.gif)](https://asciinema.org/a/585241)
+
+### Deploying System-X services
+To deploy a System-X service you can use the `deploy <System-X Classname>` command. 
+By default the services are deployed locally, you can use the `--openshift` flag to deploy on OCP cluster you are currently logged in.
+
+Or use commands `setOpenshift` and `setLocal` to use OCP or local installation always.
+
+### Using deployed services
+After deploying the service you'll be prompted with the service name to use in shell.
+You can then use this name to use it as a normal System-X service. `<name>.validation().[TAB]` will help you.
+
+Services are undeployed by default after you close the `tnb` session, or use the `undeploy` command.
+
+### Configuration
+The CLI uses `~/.tnb` directory for its configuration. `~/.tnb/init.groovy` file is executed on startup. You can use this to setup any properties, for example:
+
+```groovy
+System.setProperty('test.credentials.file', '~/credentials.yaml')
+System.setProperty('openshift.kubeconfig', '~/kubeconfig.yaml')
+```
+
+#### Credentials
+In a case where a service needs credentials that can't be found then you'll be asked to provide the credentials.
+These credentials are then stored in `~/.tnb/credentials/<id>.properties` and will be used for later use.