add new email features, email detail and email edit

Author: caberos

SoftLayer/CLI/email/__init__.py

@@ -0,0 +1 @@
+"""Network Delivery account"""

SoftLayer/CLI/email/detail.py

@@ -0,0 +1,33 @@
+"""Display details for a specified email."""
+# :license: MIT, see LICENSE for more details.
+
+import click
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import formatting
+from SoftLayer.managers.email import EmailManager
+from SoftLayer import utils
+
+
+@click.command()
+@click.argument('identifier')
+@environment.pass_env
+def cli(env, identifier):
+    """Display details for a specified email."""
+
+    email_manager = EmailManager(env.client)
+    result = email_manager.get_instance(identifier)
+
+    table = formatting.KeyValueTable(['name', 'value'])
+    table.align['name'] = 'r'
+    table.align['value'] = 'l'
+
+    table.add_row(['id', result.get('id')])
+    table.add_row(['username', result.get('username')])
+    table.add_row(['create_date', result.get('createDate')])
+    table.add_row(['categoryCode', utils.lookup(result, 'billingItem', 'categoryCode')])
+    table.add_row(['description', utils.lookup(result, 'billingItem', 'description')])
+    table.add_row(['type_description', utils.lookup(result, 'type', 'description')])
+    table.add_row(['type', utils.lookup(result, 'type', 'keyName')])
+    table.add_row(['vendor', utils.lookup(result, 'vendor', 'keyName')])
+
+    env.fout(table)

SoftLayer/CLI/email/edit.py

@@ -0,0 +1,32 @@
+"""Edit details of an Delivery email account."""
+# :license: MIT, see LICENSE for more details.
+
+import click
+
+from SoftLayer.CLI import environment
+from SoftLayer.CLI import exceptions
+from SoftLayer.managers.email import EmailManager
+
+
+@click.command()
+@click.argument('identifier')
+@click.option('--username', help="username account")
+@click.option('--email', help="Additional note for the image")
+@click.option('--password',
+              help="Password must be between 8 and 20 characters "
+                   "and must contain one letter and one number.")
+@environment.pass_env
+def cli(env, identifier, username, email, password):
+    """Edit details of an email delivery account."""
+    data = {}
+    if username:
+        data['username'] = username
+    if email:
+        data['emailAddress'] = email
+    if password:
+        data['password'] = password
+
+    email_manager = EmailManager(env.client)
+
+    if not email_manager.editObject(identifier, data):
+        raise exceptions.CLIAbort("Failed to Edit email account")

SoftLayer/CLI/routes.py

@@ -121,6 +121,8 @@
 
     ('email', 'SoftLayer.CLI.email'),
     ('email:list', 'SoftLayer.CLI.email.list:cli'),
+    ('email:detail', 'SoftLayer.CLI.email.detail:cli'),
+    ('email:edit', 'SoftLayer.CLI.email.edit:cli'),
 
     ('event-log', 'SoftLayer.CLI.event_log'),
     ('event-log:get', 'SoftLayer.CLI.event_log.get:cli'),

SoftLayer/fixtures/SoftLayer_Network_Message_Delivery_Email_Sendgrid.py

@@ -25,3 +25,34 @@
     "uniqueOpens": 0,
     "unsubscribes": 0
 }]
+
+getObject = {
+    "accountId": 123456,
+    "createDate": "2020-07-06T10:29:11-06:00",
+    "id": 1232123,
+    "password": "Test123456789",
+    "typeId": 21,
+    "username": "techsupport3@ie.ibm.com",
+    "vendorId": 1,
+    "billingItem": {
+        "categoryCode": "network_message_delivery",
+        "description": "Free Package",
+        "id": 695735054,
+        "notes": "techsupport3@ie.ibm.com",
+    },
+    "type": {
+        "description": "Delivery of messages through e-mail",
+        "id": 21,
+        "keyName": "EMAIL",
+        "name": "Email"
+    },
+    "vendor": {
+        "id": 1,
+        "keyName": "SENDGRID",
+        "name": "SendGrid"
+    },
+    "emailAddress": "techsupport3@ie.ibm.com",
+    "smtpAccess": "1"
+}
+
+editObject = True

SoftLayer/managers/email.py

@@ -45,3 +45,33 @@ def get_statistics(self, identifier, days=30):
 
         return self.client.call('SoftLayer_Network_Message_Delivery_Email_Sendgrid',
                                 'getStatistics', id=identifier, *body)
+
+    def get_instance(self, identifier):
+        """Gets the Network_Message_Delivery_Email_Sendgrid instance
+
+        :return: Network_Message_Delivery_Email_Sendgrid
+        """
+
+        _mask = """emailAddress,type,billingItem,vendor"""
+
+        return self.client.call('SoftLayer_Network_Message_Delivery_Email_Sendgrid',
+                                'getObject', id=identifier, mask=_mask)
+
+    def editObject(self, identifier, username=None, emailAddress=None, password=None):
+        """Edit email delivery account related details.
+
+               :param int identifier: The ID of the email account
+               :param string username: username of the email account.
+               :param string email: email of the email account.
+               :param string password: password of the email account to be updated to.
+               """
+        data = {}
+        if username:
+            data['username'] = username
+        if emailAddress:
+            data['emailAddress'] = emailAddress
+        if password:
+            data['password'] = password
+
+        return self.client.call('SoftLayer_Network_Message_Delivery_Email_Sendgrid',
+                                'editObject', data, id=identifier)

docs/cli.rst

@@ -79,6 +79,7 @@ To discover the available commands, simply type `slcli`.
           config          CLI configuration.
           dedicatedhost   Dedicated Host.
           dns             Domain Name System.
+          email           Email Deliviry Network
           event-log       Event Logs.
           file            File Storage.
           firewall        Firewalls.

docs/cli/email.rst

@@ -6,4 +6,12 @@ Email Commands
 
 .. click:: SoftLayer.CLI.email.list:cli
     :prog: email list
+    :show-nested:
+
+.. click:: SoftLayer.CLI.email.detail:cli
+    :prog: email detail
+    :show-nested:
+
+.. click:: SoftLayer.CLI.email.edit:cli
+    :prog: email edit
     :show-nested:

tests/CLI/modules/email_tests.py

@@ -9,7 +9,21 @@
 
 class EmailCLITests(testing.TestCase):
 
-    def test_detail(self):
+    def test_list(self):
         result = self.run_command(['email', 'list'])
         self.assert_no_fail(result)
         self.assert_called_with('SoftLayer_Account', 'getNetworkMessageDeliveryAccounts')
+
+    def test_detail(self):
+        result = self.run_command(['email', 'detail', '1232123'])
+        self.assert_no_fail(result)
+        self.assert_called_with('SoftLayer_Network_Message_Delivery_Email_Sendgrid', 'getObject')
+
+    def test_edit(self):
+        result = self.run_command(['email', 'edit', '1232123',
+                                   '--username=test@ibm.com',
+                                   '--email=test@ibm.com',
+                                   '--password=test123456789'])
+        self.assert_no_fail(result)
+        self.assert_called_with('SoftLayer_Network_Message_Delivery_Email_Sendgrid',
+                                'editObject')

tests/managers/email_tests.py

@@ -21,3 +21,9 @@ def test_get_statistics(self):
         self.manager.get_statistics(1232123, 6)
         self.assert_called_with('SoftLayer_Network_Message_Delivery_Email_Sendgrid',
                                 'getStatistics')
+
+    def test_get_object(self):
+        self.manager = EmailManager(self.client)
+        self.manager.get_instance(1232123)
+        self.assert_called_with('SoftLayer_Network_Message_Delivery_Email_Sendgrid',
+                                'getObject')