Merge branch 'master' of https://github.com/softlayer/softlayer-python into issue887

Author: Daniel Cabero Barrios

.github/workflows/documentation.yml

@@ -0,0 +1,27 @@
+name: softlayer
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [3.8]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v1
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r tools/test-requirements.txt
+    - name: Documentation Checks
+      run: |
+        python docCheck.py

CHANGELOG.md

@@ -1,7 +1,21 @@
 # Change Log
 
-
-## [5.8.5] - 2012-01-29
+## [5.8.7] - 2020-03-26
+https://github.com/softlayer/softlayer-python/compare/v5.8.5...v5.8.7
+
+- #1222 Get load balancer (LBaaS) by name
+- #1221 Added version checker
+- #1227 Updated unit test suite for TravisCI to run properly
+- #1225 Add note about using multiple colon symbols not working when setting tags.
+- #1228 Support ordering [Dependent Duplicate Volumes](https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-dependentduplicate)
+- #1233 Refactored File/Block managers to reduce duplicated code.
+- #1231 Added Refresh functions for Dependent Duplicate Volumes
+- #801 Added support for JSON styled parameters and object filters
+- #1234 Added ability to change which datacenters an image template was stored in
+
+## [5.8.6] - Skipped
+
+## [5.8.5] - 2020-01-29
 https://github.com/softlayer/softlayer-python/compare/v5.8.4...v5.8.5
 
 -  #1195 Fixed an issue with `slcli vs dns-sync --ptr`. Added `slcli hw dns-sync`

SoftLayer/CLI/account/billing_items.py

@@ -0,0 +1,60 @@
+"""Lists all active billing items on this account. See https://cloud.ibm.com/billing/billing-items"""
+# :license: MIT, see LICENSE for more details.
+import click
+
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import formatting
+from SoftLayer.managers.account import AccountManager as AccountManager
+from SoftLayer import utils
+
+
+@click.command()
+@environment.pass_env
+def cli(env):
+    """Lists billing items with some other useful information.
+
+    Similiar to https://cloud.ibm.com/billing/billing-items
+    """
+
+    manager = AccountManager(env.client)
+    items = manager.get_account_billing_items()
+    table = item_table(items)
+
+    env.fout(table)
+
+
+def item_table(items):
+    """Formats a table for billing items"""
+    table = formatting.Table([
+        "Id",
+        "Create Date",
+        "Cost",
+        "Category Code",
+        "Ordered By",
+        "Description",
+        "Notes"
+    ], title="Billing Items")
+    table.align['Description'] = 'l'
+    table.align['Category Code'] = 'l'
+    for item in items:
+        description = item.get('description')
+        fqdn = "{}.{}".format(item.get('hostName', ''), item.get('domainName', ''))
+        if fqdn != ".":
+            description = fqdn
+        user = utils.lookup(item, 'orderItem', 'order', 'userRecord')
+        ordered_by = "IBM"
+        create_date = utils.clean_time(item.get('createDate'), in_format='%Y-%m-%d', out_format='%Y-%m-%d')
+        if user:
+            # ordered_by = "{} ({})".format(user.get('displayName'), utils.lookup(user, 'userStatus', 'name'))
+            ordered_by = user.get('displayName')
+
+        table.add_row([
+            item.get('id'),
+            create_date,
+            item.get('nextInvoiceTotalRecurringAmount'),
+            item.get('categoryCode'),
+            ordered_by,
+            utils.trim_to(description, 50),
+            utils.trim_to(item.get('notes', 'None'), 40),
+        ])
+    return table

SoftLayer/CLI/account/cancel_item.py

@@ -0,0 +1,18 @@
+"""Cancels a billing item."""
+# :license: MIT, see LICENSE for more details.
+import click
+
+from SoftLayer.CLI import environment
+from SoftLayer.managers.account import AccountManager as AccountManager
+
+
+@click.command()
+@click.argument('identifier')
+@environment.pass_env
+def cli(env, identifier):
+    """Cancels a billing item."""
+
+    manager = AccountManager(env.client)
+    item = manager.cancel_item(identifier)
+
+    env.fout(item)

SoftLayer/CLI/account/item_detail.py

@@ -0,0 +1,52 @@
+"""Gets some details about a specific billing item."""
+# :license: MIT, see LICENSE for more details.
+import click
+
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import formatting
+from SoftLayer.managers.account import AccountManager as AccountManager
+from SoftLayer import utils
+
+
+@click.command()
+@click.argument('identifier')
+@environment.pass_env
+def cli(env, identifier):
+    """Gets detailed information about a billing item."""
+    manager = AccountManager(env.client)
+    item = manager.get_billing_item(identifier)
+    env.fout(item_table(item))
+
+
+def item_table(item):
+    """Formats a table for billing items"""
+
+    date_format = '%Y-%m-%d'
+    table = formatting.KeyValueTable(["Key", "Value"], title="{}".format(item.get('description', 'Billing Item')))
+    table.add_row(['createDate', utils.clean_time(item.get('createDate'), date_format, date_format)])
+    table.add_row(['cycleStartDate', utils.clean_time(item.get('cycleStartDate'), date_format, date_format)])
+    table.add_row(['cancellationDate', utils.clean_time(item.get('cancellationDate'), date_format, date_format)])
+    table.add_row(['description', item.get('description')])
+    fqdn = "{}.{}".format(item.get('hostName'), item.get('domain'))
+    if fqdn != ".":
+        table.add_row(['FQDN', fqdn])
+
+    if item.get('hourlyFlag', False):
+        table.add_row(['hourlyRecurringFee', item.get('hourlyRecurringFee')])
+        table.add_row(['hoursUsed', item.get('hoursUsed')])
+        table.add_row(['currentHourlyCharge', item.get('currentHourlyCharge')])
+    else:
+        table.add_row(['recurringFee', item.get('recurringFee')])
+
+    ordered_by = "IBM"
+    user = utils.lookup(item, 'orderItem', 'order', 'userRecord')
+    if user:
+        ordered_by = "{} ({})".format(user.get('displayName'), utils.lookup(user, 'userStatus', 'name'))
+    table.add_row(['Ordered By', ordered_by])
+    table.add_row(['Notes', item.get('notes')])
+    table.add_row(['Location', utils.lookup(item, 'location', 'name')])
+    if item.get('children'):
+        for child in item.get('children'):
+            table.add_row([child.get('categoryCode'), child.get('description')])
+
+    return table

SoftLayer/CLI/hardware/billing.py

@@ -0,0 +1,38 @@
+"""Get billing for a hardware device."""
+# :license: MIT, see LICENSE for more details.
+
+import click
+
+import SoftLayer
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import formatting
+from SoftLayer.CLI import helpers
+from SoftLayer import utils
+
+
+@click.command()
+@click.argument('identifier')
+@environment.pass_env
+def cli(env, identifier):
+    """Get billing for a hardware device."""
+    hardware = SoftLayer.HardwareManager(env.client)
+
+    hardware_id = helpers.resolve_id(hardware.resolve_ids, identifier, 'hardware')
+    result = hardware.get_hardware(hardware_id)
+    table = formatting.KeyValueTable(['name', 'value'])
+    table.align['name'] = 'r'
+    table.align['value'] = 'l'
+
+    table.add_row(['Id', identifier])
+
+    table.add_row(['Billing Item Id', utils.lookup(result, 'billingItem', 'id')])
+    table.add_row(['Recurring Fee', utils.lookup(result, 'billingItem', 'recurringFee')])
+    table.add_row(['Total', utils.lookup(result, 'billingItem', 'nextInvoiceTotalRecurringAmount')])
+    table.add_row(['Provision Date', utils.lookup(result, 'billingItem', 'provisionDate')])
+
+    price_table = formatting.Table(['Item', 'Recurring Price'])
+    for item in utils.lookup(result, 'billingItem', 'children') or []:
+        price_table.add_row([item['description'], item['nextInvoiceTotalRecurringAmount']])
+
+    table.add_row(['prices', price_table])
+    env.fout(table)

SoftLayer/CLI/hardware/detail.py

@@ -27,13 +27,23 @@ def cli(env, identifier, passwords, price):
     hardware_id = helpers.resolve_id(hardware.resolve_ids, identifier, 'hardware')
     result = hardware.get_hardware(hardware_id)
     result = utils.NestedDict(result)
+    hard_drives = hardware.get_hard_drives(hardware_id)
 
     operating_system = utils.lookup(result, 'operatingSystem', 'softwareLicense', 'softwareDescription') or {}
     memory = formatting.gb(result.get('memoryCapacity', 0))
     owner = None
     if utils.lookup(result, 'billingItem') != []:
         owner = utils.lookup(result, 'billingItem', 'orderItem', 'order', 'userRecord', 'username')
 
+    table_hard_drives = formatting.Table(['Name', 'Capacity', 'Serial #'])
+    for drives in hard_drives:
+        name = drives['hardwareComponentModel']['manufacturer'] + " " + drives['hardwareComponentModel']['name']
+        capacity = str(drives['hardwareComponentModel']['hardwareGenericComponentModel']['capacity']) + " " + str(
+            drives['hardwareComponentModel']['hardwareGenericComponentModel']['units'])
+        serial = drives['serialNumber']
+
+        table_hard_drives.add_row([name, capacity, serial])
+
     table.add_row(['id', result['id']])
     table.add_row(['guid', result['globalIdentifier'] or formatting.blank()])
     table.add_row(['hostname', result['hostname']])
@@ -43,6 +53,7 @@ def cli(env, identifier, passwords, price):
     table.add_row(['datacenter', result['datacenter']['name'] or formatting.blank()])
     table.add_row(['cores', result['processorPhysicalCoreAmount']])
     table.add_row(['memory', memory])
+    table.add_row(['drives', table_hard_drives])
     table.add_row(['public_ip', result['primaryIpAddress'] or formatting.blank()])
     table.add_row(['private_ip', result['primaryBackendIpAddress'] or formatting.blank()])
     table.add_row(['ipmi_ip', result['networkManagementIpAddress'] or formatting.blank()])

SoftLayer/CLI/hardware/storage.py

@@ -0,0 +1,59 @@
+"""Get storage details for a hardware server."""
+# :license: MIT, see LICENSE for more details.
+
+import click
+
+import SoftLayer
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import formatting
+from SoftLayer.CLI import helpers
+
+
+@click.command()
+@click.argument('identifier')
+@environment.pass_env
+def cli(env, identifier):
+    """Get storage details for a hardware server."""
+
+    hardware = SoftLayer.HardwareManager(env.client)
+    hardware_id = helpers.resolve_id(hardware.resolve_ids, identifier, 'hardware')
+    iscsi_storage_data = hardware.get_storage_details(hardware_id, "ISCSI")
+    nas_storage_data = hardware.get_storage_details(hardware_id, "NAS")
+    storage_credentials = hardware.get_storage_credentials(hardware_id)
+    hard_drives = hardware.get_hard_drives(hardware_id)
+
+    table_credentials = formatting.Table(['Username', 'Password', 'IQN'], title="Block Storage Details \n iSCSI")
+    if storage_credentials:
+        table_credentials.add_row([storage_credentials['credential']['username'],
+                                   storage_credentials['credential']['password'],
+                                   storage_credentials['name']])
+
+    table_iscsi = formatting.Table(['LUN name', 'capacity', 'Target address', 'Location', 'Notes'])
+    for iscsi in iscsi_storage_data:
+        table_iscsi.add_row([iscsi['username'], iscsi['capacityGb'],
+                             iscsi['serviceResourceBackendIpAddress'],
+                             iscsi['allowedHardware'][0]['datacenter']['longName'],
+                             iscsi.get('notes', None)])
+
+    table_nas = formatting.Table(['Volume name', 'capacity', 'Host Name', 'Location', 'Notes'],
+                                 title="File Storage Details")
+    for nas in nas_storage_data:
+        table_nas.add_row([nas['username'], nas['capacityGb'],
+                           nas['serviceResourceBackendIpAddress'],
+                           nas['allowedHardware'][0]['datacenter']['longName'],
+                           nas.get('notes', None)])
+
+    table_hard_drives = formatting.Table(['Type', 'Name', 'Capacity', 'Serial #'], title="Other storage details")
+    for drives in hard_drives:
+        type_drive = drives['hardwareComponentModel']['hardwareGenericComponentModel']['hardwareComponentType']['type']
+        name = drives['hardwareComponentModel']['manufacturer'] + " " + drives['hardwareComponentModel']['name']
+        capacity = str(drives['hardwareComponentModel']['hardwareGenericComponentModel']['capacity']) + " " + str(
+            drives['hardwareComponentModel']['hardwareGenericComponentModel']['units'])
+        serial = drives['serialNumber']
+
+        table_hard_drives.add_row([type_drive, name, capacity, serial])
+
+    env.fout(table_credentials)
+    env.fout(table_iscsi)
+    env.fout(table_nas)
+    env.fout(table_hard_drives)

SoftLayer/CLI/image/datacenter.py

@@ -0,0 +1,28 @@
+"""Edit details of an image."""
+# :license: MIT, see LICENSE for more details.
+
+import click
+
+import SoftLayer
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import helpers
+
+
+@click.command()
+@click.argument('identifier')
+@click.option('--add/--remove', default=True,
+              help="To add or remove Datacenter")
+@click.argument('locations', nargs=-1, required=True)
+@environment.pass_env
+def cli(env, identifier, add, locations):
+    """Add/Remove datacenter of an image."""
+
+    image_mgr = SoftLayer.ImageManager(env.client)
+    image_id = helpers.resolve_id(image_mgr.resolve_ids, identifier, 'image')
+
+    if add:
+        result = image_mgr.add_locations(image_id, locations)
+    else:
+        result = image_mgr.remove_locations(image_id, locations)
+
+    env.fout(result)