Add --labelmatch option for jclouds-templates

Author: felfert

CLI.md

@@ -24,7 +24,12 @@ The following CLI commands are provided by the jclouds-plugin:
 <a name="jclouds-templates"></a>
 ### jclouds-templates
 SYNTAX:
-```java -jar jenkins-cli.jar jclouds-templates ```
+```
+java -jar jenkins-cli.jar jclouds-templates [-l (--labelmatch) EXPR]
+List all JClouds templates.
+ -l (--labelmatch) EXPR : List templates that satisfy the specified label
+                          expression.
+```
 
 With this command you can list all configured JClouds templates on the controller.
 A typical output is shown here:
@@ -58,6 +63,7 @@ google       bh-stretch-64
 DigitalOcean dub2204             dub2204
 DigitalOcean dub2004jnlp         dub2004jnlp
 ```
+By specifying a [`label expression`](https://www.jenkins.io/doc/pipeline/steps/workflow-durable-task-step/#node-allocate-node), you can find out, which templates would satisfy that expression. Of course the label expression usually should be quoted, so that your shell does not try to interpret it.
 <a name="jclouds-provision"></a>
 ### jclouds-provision
 SYNTAX:

src/main/java/jenkins/plugins/jclouds/cli/JCloudsTemplatesCommand.java

@@ -16,11 +16,14 @@
 package jenkins.plugins.jclouds.cli;
 
 import hudson.Extension;
+import hudson.Util;
 import hudson.cli.CLICommand;
+import hudson.model.Label;
 import hudson.security.Permission;
 import java.io.IOException;
 import jenkins.plugins.jclouds.compute.JCloudsCloud;
 import jenkins.plugins.jclouds.compute.JCloudsSlaveTemplate;
+import org.kohsuke.args4j.Option;
 
 /**
  * Provisions an agent.
@@ -38,22 +41,34 @@ public String getShortDescription() {
         return Messages.TemplatesCommand_shortDescription();
     }
 
+    @Option(
+            required = false,
+            metaVar = "EXPR",
+            name = "-l",
+            aliases = "--labelmatch",
+            usage = "List templates that satisfy the specified label expression.")
+    private String labelExpr;
+
     @Override
     protected int run() throws IOException {
         int maxProfileLen = 0;
         int maxTemplateLen = 0;
         int maxLabelLen = 0;
+        labelExpr = Util.fixEmptyAndTrim(labelExpr);
+        Label label = null == labelExpr ? null : Label.parseExpression(labelExpr);
         for (final JCloudsCloud c : CliHelper.getAllJCloudClouds()) {
             if (c.hasPermission(Permission.READ)) {
                 if (c.profile.length() > maxProfileLen) {
                     maxProfileLen = c.profile.length();
                 }
                 for (final JCloudsSlaveTemplate t : c.getTemplates()) {
-                    if (t.name.length() > maxTemplateLen) {
-                        maxTemplateLen = t.name.length();
-                    }
-                    if (t.labelString.length() > maxLabelLen) {
-                        maxLabelLen = t.labelString.length();
+                    if (label == null || label.matches(t.getLabelSet())) {
+                        if (t.name.length() > maxTemplateLen) {
+                            maxTemplateLen = t.name.length();
+                        }
+                        if (t.labelString.length() > maxLabelLen) {
+                            maxLabelLen = t.labelString.length();
+                        }
                     }
                 }
             }
@@ -76,7 +91,9 @@ protected int run() throws IOException {
             final String indent = String.format("%-" + (maxProfileLen + maxTemplateLen + maxLabelLen + 4) + "s", "\n");
             for (final JCloudsCloud c : CliHelper.getAllJCloudClouds()) {
                 for (final JCloudsSlaveTemplate t : c.getTemplates()) {
-                    stdout.printf(fmt, c.profile, t.name, t.labelString, t.description.replaceAll("\n", indent));
+                    if (label == null || label.matches(t.getLabelSet())) {
+                        stdout.printf(fmt, c.profile, t.name, t.labelString, t.description.replaceAll("\n", indent));
+                    }
                 }
             }
         }