Merge pull request #56 from mailtrap/ISSUE-53

Fix issue #53: Add full usage in all examples

Author: yanchuk

examples/contacts/contact_fields.py

@@ -46,4 +46,21 @@ def delete_contact_field(contact_field_id: int) -> DeletedObject:
 
 
 if __name__ == "__main__":
-    print(list_contact_fields())
+    created = create_contact_field(
+        name="example_field", data_type="string", merge_tag="EXAMPLE"
+    )
+    print(created)
+
+    fields = list_contact_fields()
+    print(fields)
+
+    field = get_contact_field(contact_field_id=created.id)
+    print(field)
+
+    updated = update_contact_field(
+        contact_field_id=created.id, name=f"{field.name}-updated"
+    )
+    print(updated)
+
+    deleted = delete_contact_field(contact_field_id=created.id)
+    print(deleted)

examples/contacts/contact_lists.py

@@ -32,4 +32,20 @@ def delete_contact_list(contact_list_id: int) -> DeletedObject:
 
 
 if __name__ == "__main__":
-    print(list_contact_lists())
+    created = create_contact_list(name="example-list")
+    print(created)
+
+    lists = list_contact_lists()
+    print(lists)
+
+    contact_list = get_contact_list(contact_list_id=created.id)
+    print(contact_list)
+
+    updated = update_contact_list(
+        contact_list_id=created.id,
+        name=f"{contact_list.name}-updated",
+    )
+    print(updated)
+
+    deleted = delete_contact_list(contact_list_id=created.id)
+    print(deleted)

examples/contacts/contacts.py

@@ -60,6 +60,7 @@ def delete_contact(contact_id_or_email: str) -> DeletedObject:
         },
     )
     print(created_contact)
+
     updated_contact = update_contact(
         created_contact.id,
         fields={
@@ -68,5 +69,9 @@ def delete_contact(contact_id_or_email: str) -> DeletedObject:
         },
     )
     print(updated_contact)
+
+    contact = get_contact(updated_contact.id)
+    print(contact)
+
     deleted_contact = delete_contact(updated_contact.id)
     print(deleted_contact)

examples/email_templates/templates.py

@@ -32,12 +32,12 @@ def create_template(
     return templates_api.create(params)
 
 
-def get_template(template_id: str) -> EmailTemplate:
+def get_template(template_id: int) -> EmailTemplate:
     return templates_api.get_by_id(template_id)
 
 
 def update_template(
-    template_id: str,
+    template_id: int,
     name: Optional[str] = None,
     subject: Optional[str] = None,
     category: Optional[str] = None,
@@ -54,9 +54,32 @@ def update_template(
     return templates_api.update(template_id, params)
 
 
-def delete_template(template_id: str) -> DeletedObject:
+def delete_template(template_id: int) -> DeletedObject:
     return templates_api.delete(template_id)
 
 
 if __name__ == "__main__":
-    print(list_templates())
+    created = create_template(
+        name="Example Template",
+        subject="Hello",
+        category="transactional",
+        body_text="Hello world",
+    )
+    print(created)
+
+    templates = list_templates()
+    print(templates)
+
+    template = get_template(template_id=created.id)
+    print(template)
+
+    updated = update_template(
+        template_id=created.id,
+        name=f"{template.name}-updated",
+        subject=f"{template.subject}-updated",
+        body_text=f"{template.body_text}\nUpdated content.",
+    )
+    print(updated)
+
+    deleted = delete_template(template_id=created.id)
+    print(deleted)

examples/general/account_accesses.py

@@ -20,4 +20,11 @@ def delete_account_access(account_id: int, account_access_id: int) -> DeletedObj
 
 
 if __name__ == "__main__":
-    print(get_account_accesses(ACCOUNT_ID))
+    accesses = get_account_accesses(ACCOUNT_ID)
+    print(accesses)
+    if accesses:
+        access_id = accesses[0].id
+        deleted = delete_account_access(
+            account_id=ACCOUNT_ID, account_access_id=access_id
+        )
+        print(deleted)

examples/general/accounts.py

@@ -12,4 +12,5 @@ def get_accounts() -> list[Account]:
 
 
 if __name__ == "__main__":
-    print(get_accounts())
+    accounts = get_accounts()
+    print(accounts)

examples/general/billing.py

@@ -13,4 +13,5 @@ def get_current_billing_usage(account_id: int) -> BillingCycleUsage:
 
 
 if __name__ == "__main__":
-    print(get_current_billing_usage(ACCOUNT_ID))
+    usage = get_current_billing_usage(ACCOUNT_ID)
+    print(usage)

examples/general/permissions.py

@@ -26,4 +26,20 @@ def bulk_permissions_update(
 
 
 if __name__ == "__main__":
-    print(get_permission_resources(ACCOUNT_ID))
+    resources = get_permission_resources(ACCOUNT_ID)
+    print(resources)
+    if resources:
+        account_access_id = resources[0].id
+        permissions = [
+            mt.PermissionResourceParams(
+                resource_id=resources[0].id,
+                resource_type=resources[0].type,
+                access_level="viewer",
+            )
+        ]
+        updated = bulk_permissions_update(
+            ACCOUNT_ID,
+            account_access_id,
+            permissions,
+        )
+        print(updated)

examples/sending/advanced_sending.py

@@ -23,6 +23,7 @@ def get_client(type_: SendingType) -> mt.MailtrapClient:
             sandbox=True,
             inbox_id="<YOUR_INBOX_ID>",
         )
+    raise ValueError(f"Invalid sending type: {type_}")
 
 
 # Image should be in the same level in directory like this python file.

examples/sending/batch_advanced_sending.py

@@ -23,6 +23,7 @@ def get_client(type_: SendingType) -> mt.MailtrapClient:
             sandbox=True,
             inbox_id="<YOUR_INBOX_ID>",
         )
+    raise ValueError(f"Invalid sending type: {type_}")
 
 
 # Image should be in the same level in directory like this python file.