Add ordering APIs and commands

This change adds a new command, and 5 new subcommands:

slcli order - command for interacting with the ordering API

slcli order category-list -- subcommand for listing categories in a
package

slcli order item-list -- subcommand for listing items in a package

slcli order package-list -- subcommand for listing available packages

slcli order place -- subcommand for verifying/placing orders

slcli order preset-list -- subcommand for listing presets of a package

API functions in SoftLayer.managers.ordering.OrderingManager were also
added to programmatically interact with all of these functions as well.

The place_order() and verify_order() commands are built to pass a
package keyname, a location, and a list of item keynames. It then
transforms the keynames into IDs, which the place/verifyOrder APIs
accept.

Author: Ryan Rossiter

SoftLayer/CLI/order/__init__.py

@@ -0,0 +1,37 @@
+"""List package categories."""
+# :license: MIT, see LICENSE for more details.
+
+import click
+
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import formatting
+from SoftLayer.managers import ordering
+
+COLUMNS = ['name', 'categoryCode', 'isRequired']
+
+
+@click.command()
+@click.argument('package_keyname')
+@click.option('--required',
+              is_flag=True,
+              help="List only the required categories for the package")
+@environment.pass_env
+def cli(env, package_keyname, required):
+    """List package categories."""
+    client = env.client
+    manager = ordering.OrderingManager(client)
+    table = formatting.Table(COLUMNS)
+
+    categories = manager.list_categories(package_keyname)
+
+    if required:
+        categories = [cat for cat in categories if cat['isRequired']]
+
+    for cat in categories:
+        table.add_row([
+            cat['itemCategory']['name'],
+            cat['itemCategory']['categoryCode'],
+            'Y' if cat['isRequired'] else 'N'
+        ])
+
+    env.fout(table)

SoftLayer/CLI/order/category_list.py

@@ -0,0 +1,39 @@
+"""List package items."""
+# :license: MIT, see LICENSE for more details.
+
+import click
+
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import formatting
+from SoftLayer.managers import ordering
+
+COLUMNS = ['keyName',
+           'description', ]
+
+
+@click.command()
+@click.argument('package_keyname')
+@click.option('--keyword',
+              help="A word (or string) used to filter item names.")
+@click.option('--category',
+              help="Category code to filter items by")
+@environment.pass_env
+def cli(env, package_keyname, keyword, category):
+    """List package items."""
+    table = formatting.Table(COLUMNS)
+    manager = ordering.OrderingManager(env.client)
+
+    _filter = {'items': {}}
+    if keyword:
+        _filter['items']['description'] = {'operation': '*= %s' % keyword}
+    if category:
+        _filter['items']['categories'] = {'categoryCode': {'operation': '_= %s' % category}}
+
+    items = manager.list_items(package_keyname, filter=_filter)
+
+    for item in items:
+        table.add_row([
+            item['keyName'],
+            item['description'],
+        ])
+    env.fout(table)

SoftLayer/CLI/order/item_list.py

@@ -0,0 +1,34 @@
+"""List package presets."""
+# :license: MIT, see LICENSE for more details.
+
+import click
+
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import formatting
+from SoftLayer.managers import ordering
+
+COLUMNS = ['name',
+           'keyName', ]
+
+
+@click.command()
+@click.option('--keyword',
+              help="A word (or string) used to filter package names.")
+@environment.pass_env
+def cli(env, keyword):
+    """List package presets."""
+    manager = ordering.OrderingManager(env.client)
+    table = formatting.Table(COLUMNS)
+
+    _filter = {}
+    if keyword:
+        _filter = {'name': {'operation': '*= %s' % keyword}}
+
+    packages = manager.list_packages(filter=_filter)
+
+    for package in packages:
+        table.add_row([
+            package['name'],
+            package['keyName'],
+        ])
+    env.fout(table)

SoftLayer/CLI/order/package_list.py

@@ -0,0 +1,72 @@
+"""Verify or place an order."""
+# :license: MIT, see LICENSE for more details.
+
+import json
+
+import click
+
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import exceptions
+from SoftLayer.CLI import formatting
+from SoftLayer.managers import ordering
+
+COLUMNS = ['keyName',
+           'description',
+           'cost', ]
+
+
+@click.command()
+@click.argument('package_keyname')
+@click.argument('location')
+@click.option('--preset',
+              help="The order preset (if required by the package)")
+@click.option('--verify',
+              is_flag=True,
+              help="Flag denoting whether or not to only verify the order, not place it")
+@click.option('--billing',
+              type=click.Choice(['hourly', 'monthly']),
+              default='hourly',
+              show_default=True,
+              help="Billing rate")
+@click.option('--extras',
+              help="JSON string denoting extra data that needs to be sent with the order")
+@click.argument('order_items', nargs=-1)
+@environment.pass_env
+def cli(env, package_keyname, location, preset, verify, billing, extras, order_items):
+    """Place or verify an order."""
+    manager = ordering.OrderingManager(env.client)
+
+    if extras:
+        extras = json.loads(extras)
+
+    args = (package_keyname, location, order_items)
+    kwargs = {'preset_keyname': preset,
+              'extras': extras,
+              'quantity': 1,
+              'hourly': True if billing == 'hourly' else False}
+
+    if verify:
+        table = formatting.Table(COLUMNS)
+        order_to_place = manager.verify_order(*args, **kwargs)
+        for price in order_to_place['prices']:
+            cost_key = 'hourlyRecurringFee' if billing == 'hourly' else 'recurringFee'
+            table.add_row([
+                price['item']['keyName'],
+                price['item']['description'],
+                price[cost_key] if cost_key in price else formatting.blank()
+            ])
+
+    else:
+        if not (env.skip_confirmations or formatting.confirm(
+                "This action will incur charges on your account. Continue?")):
+            raise exceptions.CLIAbort("Aborting order.")
+
+        order = manager.place_order(*args, **kwargs)
+
+        table = formatting.KeyValueTable(['name', 'value'])
+        table.align['name'] = 'r'
+        table.align['value'] = 'l'
+        table.add_row(['id', order['orderId']])
+        table.add_row(['created', order['orderDate']])
+        table.add_row(['status', order['placedOrder']['status']])
+    env.fout(table)

SoftLayer/CLI/order/place.py

@@ -0,0 +1,36 @@
+"""List package presets."""
+# :license: MIT, see LICENSE for more details.
+
+import click
+
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import formatting
+from SoftLayer.managers import ordering
+
+COLUMNS = ['name',
+           'keyName',
+           'description', ]
+
+
+@click.command()
+@click.argument('package_keyname')
+@click.option('--keyword',
+              help="A word (or string) used to filter preset names.")
+@environment.pass_env
+def cli(env, package_keyname, keyword):
+    """List package presets."""
+    table = formatting.Table(COLUMNS)
+    manager = ordering.OrderingManager(env.client)
+
+    _filter = {}
+    if keyword:
+        _filter = {'presets': {'name': {'operation': '*= %s' % keyword}}}
+    presets = manager.list_presets(package_keyname, filter=_filter)
+
+    for preset in presets:
+        table.add_row([
+            preset['name'],
+            preset['keyName'],
+            preset['description']
+        ])
+    env.fout(table)

SoftLayer/CLI/order/preset_list.py

@@ -191,6 +191,13 @@
     ('object-storage:endpoints',
      'SoftLayer.CLI.object_storage.list_endpoints:cli'),
 
+    ('order', 'SoftLayer.CLI.order'),
+    ('order:category-list', 'SoftLayer.CLI.order.category_list:cli'),
+    ('order:item-list', 'SoftLayer.CLI.order.item_list:cli'),
+    ('order:package-list', 'SoftLayer.CLI.order.package_list:cli'),
+    ('order:place', 'SoftLayer.CLI.order.place:cli'),
+    ('order:preset-list', 'SoftLayer.CLI.order.preset_list:cli'),
+
     ('rwhois', 'SoftLayer.CLI.rwhois'),
     ('rwhois:edit', 'SoftLayer.CLI.rwhois.edit:cli'),
     ('rwhois:show', 'SoftLayer.CLI.rwhois.show:cli'),