feat: Add webusage and mailusage endpoints

Author: yqdv

src/opalstack/api.py

@@ -26,6 +26,7 @@
 from .addresses import AddressesManager
 from .mailusers import MailusersManager
 from .quarantinedmails import QuarantinedmailsManager
+from .usage import UsageManager
 
 API_URL = 'https://my.opalstack.com/api/v1'
 
@@ -56,6 +57,7 @@ def __init__(self, token):
         self.sites = SitesManager(self)
         self.mailusers= MailusersManager(self)
         self.addresses = AddressesManager(self)
+        self.usage = UsageManager(self)
 
         ## Not live yet ##
         # self.quarantinedmails = QuarantinedmailsManager(self)

src/opalstack/usage.py

@@ -0,0 +1,26 @@
+from .manager import ApiModelManager
+
+class UsageManager(ApiModelManager):
+    def __init__(self, api):
+        self.model_name        = 'usage'
+        self.model_name_plural = 'usages'
+        self.is_instantaneous  = True
+        self.primary_key       = None
+        super().__init__(api)
+
+    def webusage_latest(self, embed=[]):
+        qs = ('?embed=' + ','.join(embed)) if embed else ''
+        return self.api.http_get_result(f'/{self.model_name}/web/latest/{qs}', ensure_status=[200])
+
+    def mailusage_latest(self, embed=[]):
+        qs = ('?embed=' + ','.join(embed)) if embed else ''
+        return self.api.http_get_result(f'/{self.model_name}/mail/latest/{qs}', ensure_status=[200])
+
+    def check_equals(self, a, b):
+        return ( a['id'] == b['id'] )
+
+    def check_obstructs(self, existing, new):
+        return False
+
+    def check_satisfies(self, existing, new):
+        return False