#1026 mostly done with the bits that actually do things. still need unit tests and detox

Author: allmightyspiff

SoftLayer/CLI/virt/capacity/__init__.py

@@ -9,6 +9,8 @@
 from SoftLayer.CLI import formatting
 
 from pprint import pprint as pp
+CONTEXT = {'help_option_names': ['-h', '--help'],
+           'max_content_width': 999}
 class capacityCommands(click.MultiCommand):
     """Loads module for capacity related commands."""
 
@@ -18,7 +20,6 @@ def __init__(self, *path, **attrs):
 
     def list_commands(self, ctx):
         """List all sub-commands."""
- 
         rv = []
         for filename in os.listdir(self.path):
             if filename == '__init__.py':
@@ -34,9 +35,9 @@ def get_command(self, ctx, name):
         module = importlib.import_module(path)
         return getattr(module, 'cli')
 
-@click.group(cls=capacityCommands, 
-             help="Manages virtual server reserved capacity")
+@click.group(cls=capacityCommands,
+             context_settings=CONTEXT)
 @environment.pass_env
 def cli(env):
-    """Manages Capacity"""
+    """Manages Reserved Capacity"""
     pass

SoftLayer/CLI/virt/capacity/create-guest.py

@@ -117,6 +117,7 @@ def _parse_create_args(client, args):
               help="Test order, will return the order container, but not actually order a server.")
 @environment.pass_env
 def cli(env, **args):
+    """Allows for creating a virtual guest in a reserved capacity."""
     create_args = _parse_create_args(env.client, args)
     manager = CapacityManager(env.client)
     capacity_id = args.get('capacity_id')

SoftLayer/CLI/virt/capacity/create.py

@@ -1,4 +1,7 @@
-"""Create a Reserved Capacity instance"""
+"""Create a Reserved Capacity instance. 
+
+
+"""
 # :license: MIT, see LICENSE for more details.
 
 import click
@@ -27,7 +30,7 @@
               help="Do not actually create the virtual server")
 @environment.pass_env
 def cli(env, name, datacenter, backend_router_id, capacity, quantity, test=False):
-    """Create a Reserved Capacity instance"""
+    """Create a Reserved Capacity instance. *WARNING*: Reserved Capacity is on a yearly contract and not cancelable until the contract is expired."""
     manager = CapacityManager(env.client)
     result = manager.create(
         name=name,

SoftLayer/CLI/virt/capacity/detail.py

@@ -47,7 +47,7 @@
               show_default=True)
 @environment.pass_env
 def cli(env, identifier, columns):
-    """Reserved Capacity Group Details"""
+    """Reserved Capacity Group details. Will show which guests are assigned to a reservation."""
     manager = CapacityManager(env.client)
     mask = "mask[instances[billingItem[category], guest]]"
     result = manager.get_object(identifier, mask)

SoftLayer/CLI/virt/capacity/list.py

@@ -14,7 +14,7 @@
 @click.command()
 @environment.pass_env
 def cli(env):
-    """List Reserved Capacity"""
+    """List Reserved Capacity groups."""
     manager = CapacityManager(env.client)
     result = manager.list()
     table = formatting.Table(