add a new command on order items-cancelation

Author: caberos

SoftLayer/CLI/order/cancelation.py

@@ -0,0 +1,32 @@
+"""List active quotes on an account."""
+# :license: MIT, see LICENSE for more details.
+import click
+
+from SoftLayer.CLI.command import SLCommand as SLCommand
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import formatting
+from SoftLayer.managers import ordering
+from SoftLayer.utils import clean_time
+
+
+@click.command(cls=SLCommand)
+@environment.pass_env
+def cli(env):
+    """List all active quotes on an account"""
+    table = formatting.Table([
+        'Case Number', 'Number Of Items Cancelled', 'Created', 'Status', 'Requested by'])
+    table.align['Name'] = 'l'
+    table.align['Package Name'] = 'r'
+    table.align['Package Id'] = 'l'
+
+    manager = ordering.OrderingManager(env.client)
+    cancelations = manager.get_all_cancelation()
+
+    for item in cancelations:
+        table.add_row([item.get('ticketId'), item.get('itemCount'),
+                       item.get('createDate'),
+                       item['status']['name'],
+                       item['user']['firstName'] + ' ' + item['user']['lastName']
+                       ])
+
+    env.fout(table)

SoftLayer/CLI/routes.py

@@ -278,6 +278,7 @@
     ('order:quote-save', 'SoftLayer.CLI.order.quote_save:cli'),
     ('order:quote', 'SoftLayer.CLI.order.quote:cli'),
     ('order:lookup', 'SoftLayer.CLI.order.lookup:cli'),
+    ('order:cancelation', 'SoftLayer.CLI.order.cancelation:cli'),
 
     ('hardware', 'SoftLayer.CLI.hardware'),
     ('hardware:bandwidth', 'SoftLayer.CLI.hardware.bandwidth:cli'),

SoftLayer/fixtures/SoftLayer_Billing_Item_Cancellation_Request.py

@@ -0,0 +1,25 @@
+getAllCancellationRequests = [
+    {"createDate": "2023-04-20T06:53:17-06:00",
+     "id": 123456,
+     "ticketId": 147258,
+     "itemCount": 1,
+     "items": [
+         {
+             "billingItemId": 369852,
+             "id": 147852369,
+             "billingItem": {
+                 "cancellationDate": "2023-05-03T22:59:59-06:00",
+                 "categoryCode": "server",
+             }
+         }
+     ],
+     "status": {
+         "id": 4,
+         "name": "Approved"
+     },
+     "user": {
+         "firstName": "CHRISTOPHER",
+         "id": 167758,
+         "lastName": "GALLO"
+     }
+     }]

SoftLayer/managers/ordering.py

@@ -737,3 +737,14 @@ def get_regions(self, package_id, location=None):
         if location:
             _filter = {"regions": {"location": {"location": {"name": {"operation": location}}}}}
         return self.client.call('SoftLayer_Product_Package', 'getRegions', id=package_id, filter=_filter)
+
+    def get_all_cancelation(self):
+        """returns the all cancelations, completed orders"""
+
+        mask = 'mask[id,itemCount,modifyDate,createDate,ticketId,' \
+               'ticket[assignedUserId,id,attachedHardware[id,hostname,domain],' \
+               'attachedVirtualGuests[id,hostname,domain],' \
+               'attachedDedicatedHosts[id,name],serviceProviderResourceId],' \
+               'status[name,id],user[id,firstName,lastName],' \
+               'items[billingItem[cancellationDate,categoryCode,pendingCancellationFlag]]]'
+        return self.client.call('SoftLayer_Billing_Item_Cancellation_Request', 'getAllCancellationRequests', mask=mask)

docs/cli/ordering.rst

@@ -139,6 +139,10 @@ Quotes
     :prog: order place-quote
     :show-nested:
 
+.. click:: SoftLayer.CLI.order.cancelation:cli
+    :prog: order cancelation
+    :show-nested:
+
 Lookup
 ======
 .. click:: SoftLayer.CLI.order.lookup:cli

tests/CLI/modules/order_tests.py

@@ -415,6 +415,11 @@ def test_quote_list(self):
         self.assert_no_fail(result)
         self.assert_called_with('SoftLayer_Account', 'getActiveQuotes')
 
+    def test_cancelation(self):
+        result = self.run_command(['order', 'cancelation'])
+        self.assert_no_fail(result)
+        self.assert_called_with('SoftLayer_Billing_Item_Cancellation_Request', 'getAllCancellationRequests')
+
     def _get_order_items(self):
         item1 = {'keyName': 'ITEM1', 'description': 'description1',
                  'itemCategory': {'categoryCode': 'cat1'},

tests/managers/ordering_tests.py

@@ -901,3 +901,7 @@ def test_get_items(self):
     def test_get_regions(self):
         self.ordering.get_regions(123)
         self.assert_called_with('SoftLayer_Product_Package', 'getRegions')
+
+    def test_get_all_cancelations(self):
+        self.ordering.get_all_cancelation()
+        self.assert_called_with('SoftLayer_Billing_Item_Cancellation_Request', 'getAllCancellationRequests')