Misc doc fix + make clusters argument required

images/portal/resources/toolset/toolset/commands/grep.py

@@ -36,7 +36,7 @@ class _Tool(Template):
 
         def customize(self, parser):
 
-            parser.add_argument('clusters', type=str, nargs='*', default='*', help='1+ clusters (can be a glob pattern, e.g foo*)')
+            parser.add_argument('clusters', type=str, nargs='+', help='1+ clusters (can be a glob pattern, e.g foo*)')
             parser.add_argument('-j', '--json', action='store_true', help='switch for json output')
 
         def body(self, args, proxy):
@@ -67,7 +67,7 @@ def _query(zk):
                         logger.info('  '.join((val.ljust(width) for val, width in zip(row, widths))))
 
             if args.json:
-                
+
                 logger.info(json.dumps(outs))
 
-    return _Tool()
+    return _Tool()

images/portal/resources/toolset/toolset/commands/log.py

@@ -37,7 +37,7 @@ class _Tool(Template):
 
         def customize(self, parser):
 
-            parser.add_argument('clusters', type=str, nargs='*', default='*', help='1+ clusters (can be a glob pattern, e.g foo*)')
+            parser.add_argument('clusters', type=str, nargs='+', help='1+ clusters (can be a glob pattern, e.g foo*)')
             parser.add_argument('-l', action='store_true', dest='long', help='display the entire log')
             parser.add_argument('-i', '--indices', action='store', dest='indices', type=int, nargs='+', help='1+ indices')
 
@@ -56,4 +56,4 @@ def _query(zk):
                     logger.info('<%s> -> %d%% replies (%d pods total) ->\n%s' % (token, pct, len(js), '\n'.join(unrolled)))
 
 
-    return _Tool()
+    return _Tool()

images/portal/resources/toolset/toolset/commands/ls.py

@@ -82,4 +82,4 @@ def _query(zk):
                     for row in rows:
                         logger.info('  '.join((val.ljust(width) for val, width in zip(row, widths))))
 
-    return _Tool()
+    return _Tool()

images/portal/resources/toolset/toolset/commands/off.py

@@ -39,7 +39,7 @@ class _Tool(Template):
 
         def customize(self, parser):
 
-            parser.add_argument('clusters', type=str, nargs='*', default='*', help='1+ clusters (can be a glob pattern, e.g foo*)')
+            parser.add_argument('clusters', type=str, nargs='+', help='1+ clusters (can be a glob pattern, e.g foo*)')
             parser.add_argument('-i', '--indices', action='store', dest='indices', type=int, nargs='+', help='1+ indices')
             parser.add_argument('--force', action='store_true', dest='force', help='enables wildcards')
 
@@ -58,4 +58,4 @@ def _query(zk):
                     pct = (len(js) * 100) / total
                     logger.info('<%s> -> %d%% replies, %d pods off' % (token, pct, len(js)))
 
-    return _Tool()
+    return _Tool()

images/portal/resources/toolset/toolset/commands/on.py

@@ -29,16 +29,15 @@ class _Tool(Template):
 
         help = \
             '''
-                Switches one or more containers off (their sub-process being gracefully shutdown while the pod keeps
-                running). Individual containers can also be cherry-picked by specifying their sequence index and using
-                -i.
+                Switches one or more containers on. Individual containers can also be cherry-picked by specifying
+                their sequence index and using -i.
             '''
 
         tag = 'on'
 
         def customize(self, parser):
 
-            parser.add_argument('clusters', type=str, nargs='*', default='*', help='1+ clusters (can be a glob pattern, e.g foo*)')
+            parser.add_argument('clusters', type=str, nargs='+', help='1+ clusters (can be a glob pattern, e.g foo*)')
             parser.add_argument('-i', '--indices', action='store', dest='indices', type=int, nargs='+', help='1+ indices')
 
         def body(self, args, proxy):
@@ -54,4 +53,4 @@ def _query(zk):
                     pct = (len(js) * 100) / total
                     logger.info('<%s> -> %d%% replies, %d pods on' % (token, pct, len(js)))
 
-    return _Tool()
+    return _Tool()

images/portal/resources/toolset/toolset/commands/ping.py

@@ -43,7 +43,7 @@ class _Tool(Template):
         def customize(self, parser):
 
             parser.add_argument('yaml', nargs=1, help='YAML file')
-            parser.add_argument('clusters', type=str, nargs='*', default='*', help='1+ clusters (can be a glob pattern, e.g foo*)')
+            parser.add_argument('clusters', type=str, nargs='+', help='1+ clusters (can be a glob pattern, e.g foo*)')
             parser.add_argument('-j', action='store_true', dest='json', help='json output')
 
         def body(self, args, proxy):
@@ -77,4 +77,4 @@ def _query(zk):
                     mark = failure.problem_mark
                     assert 0, '%s is invalid (line %s, column %s)' % (args.yaml, mark.line+1, mark.column+1)
 
-    return _Tool()
+    return _Tool()

images/portal/resources/toolset/toolset/commands/poll.py

@@ -37,7 +37,7 @@ class _Tool(Template):
 
         def customize(self, parser):
 
-            parser.add_argument('clusters', type=str, nargs='*', default='*', help='1+ clusters (can be a glob pattern, e.g foo*).')
+            parser.add_argument('clusters', type=str, nargs='+', help='1+ clusters (can be a glob pattern, e.g foo*).')
             parser.add_argument('-j', '--json', action='store_true', help='switch for json output')
 
         def body(self, args, proxy):
@@ -55,7 +55,7 @@ def _query(zk):
                     return len(replies), {key: hints['metrics'] for key, (index, hints, code) in replies.items() if code == 200 and 'metrics' in hints}
 
                 total, js = run(proxy, _query)
-                
+
                 outs.update(js)
 
                 #
@@ -69,7 +69,7 @@ def _query(zk):
                     widths = [max(map(len, col)) for col in zip(*rows)]
                     for row in rows:
                         logger.info('  '.join((val.ljust(width) for val, width in zip(row, widths))))
-            
+
             if args.json:
 
                 logger.info(json.dumps(outs))

images/portal/resources/toolset/toolset/commands/port.py

@@ -37,7 +37,7 @@ class _Tool(Template):
         def customize(self, parser):
 
             parser.add_argument('port', type=int, nargs=1, help='TCP port to lookup')
-            parser.add_argument('clusters', type=str, nargs='*', default='*', help='1+ clusters (can be a glob pattern, e.g foo*)')
+            parser.add_argument('clusters', type=str, nargs='+', help='1+ clusters (can be a glob pattern, e.g foo*)')
             parser.add_argument('-j', '--json', action='store_true', help='switch for json output')
 
         def body(self, args, proxy):
@@ -67,7 +67,7 @@ def _query(zk):
                         logger.info('  '.join((val.ljust(width) for val, width in zip(row, widths))))
 
             if args.json:
-                
+
                 logger.info(json.dumps(outs))
 
-    return _Tool()
+    return _Tool()

images/portal/resources/toolset/toolset/commands/reset.py

@@ -109,7 +109,7 @@ class _Tool(Template):
 
         def customize(self, parser):
 
-            parser.add_argument('clusters', type=str, nargs='*', default='*', help='1+ clusters (can be a glob pattern, e.g foo*)')
+            parser.add_argument('clusters', type=str, nargs='+', help='1+ clusters (can be a glob pattern, e.g foo*)')
             parser.add_argument('-i', '--indices', action='store', dest='indices', type=int, nargs='+', help='1+ indices')
             parser.add_argument('-j', action='store_true', dest='json', help='json output')
             parser.add_argument('--force', action='store_true', dest='force', help='enables wildcards')
@@ -134,4 +134,4 @@ def body(self, args, proxy):
             return 0 if pct == 100 else 1
 
 
-    return _Tool()
+    return _Tool()

images/portal/resources/toolset/toolset/commands/scale.py

@@ -252,4 +252,4 @@ def body(self, args, proxy):
             logger.info(json.dumps(outcome) if args.json else '%d%% success (%+d pods)' % (pct, delta))
             return 0 if pct == 100 else 1
 
-    return _Tool()
+    return _Tool()