new: Add available field to AccountAvailability class (#395)

* Add available field to account availabilities response

* Update docs

Author: lgarber-akamai

linode_api4/groups/account.py

@@ -487,10 +487,10 @@ def join_beta_program(self, beta: Union[str, BetaProgram]):
 
     def availabilities(self, *filters):
         """
-        Returns a list of all available regions and the resources which are NOT available
+        Returns a list of all available regions and the resource types which are available
         to the account.
 
-        API doc: TBD
+        API doc: https://www.linode.com/docs/api/account/#region-service-availability
 
         :returns: a list of region availability information.
         :rtype: PaginatedList of AccountAvailability

linode_api4/objects/account.py

@@ -660,9 +660,10 @@ class AccountBetaProgram(Base):
 
 class AccountAvailability(Base):
     """
-    The resources information in a region which are NOT available to an account.
+    Contains information about the resources available for a region under the
+    current account.
 
-    API doc: TBD
+    API doc: https://www.linode.com/docs/api/account/#region-service-availability
     """
 
     api_endpoint = "/account/availability/{region}"
@@ -671,4 +672,5 @@ class AccountAvailability(Base):
     properties = {
         "region": Property(identifier=True),
         "unavailable": Property(unordered=True),
+        "available": Property(unordered=True),
     }

test/fixtures/account_availability.json

@@ -2,47 +2,58 @@
   "data": [
     {
       "region": "ap-west",
-      "unavailable": []
+      "unavailable": [],
+      "available": ["Linodes", "NodeBalancers"]
     },
     {
       "region": "ca-central",
-      "unavailable": []
+      "unavailable": [],
+      "available": ["Linodes", "NodeBalancers"]
     },
     {
       "region": "ap-southeast",
-      "unavailable": []
+      "unavailable": [],
+      "available": ["Linodes", "NodeBalancers"]
     },
     {
       "region": "us-central",
-      "unavailable": []
+      "unavailable": [],
+      "available": ["Linodes", "NodeBalancers"]
     },
     {
       "region": "us-west",
-      "unavailable": []
+      "unavailable": [],
+      "available": ["Linodes", "NodeBalancers"]
     },
     {
       "region": "us-southeast",
-      "unavailable": []
+      "unavailable": [],
+      "available": ["Linodes", "NodeBalancers"]
     },
     {
       "region": "us-east",
-      "unavailable": []
+      "unavailable": [],
+      "available": ["Linodes", "Kubernetes"]
     },
     {
       "region": "eu-west",
-      "unavailable": []
+      "unavailable": [],
+      "available": ["Linodes", "Cloud Firewall"]
     },
     {
       "region": "ap-south",
-      "unavailable": []
+      "unavailable": [],
+      "available": ["Linodes", "NodeBalancers"]
     },
     {
       "region": "eu-central",
-      "unavailable": []
+      "unavailable": [],
+      "available": ["Linodes", "NodeBalancers"]
     },
     {
       "region": "ap-northeast",
-      "unavailable": []
+      "unavailable": [],
+      "available": ["Linodes"]
     }
   ],
   "page": 1,

test/fixtures/account_availability_us-east.json

@@ -1,4 +1,5 @@
 {
   "region": "us-east",
-  "unavailable": []
+  "unavailable": [],
+  "available": ["Linodes", "Kubernetes"]
 }

test/unit/objects/account_test.py

@@ -268,6 +268,17 @@ class AccountAvailabilityTest(ClientBaseCase):
     Test methods of the AccountAvailability
     """
 
+    def test_account_availability_api_list(self):
+        with self.mock_get("/account/availability") as m:
+            availabilities = self.client.account.availabilities()
+
+            for avail in availabilities:
+                assert avail.region is not None
+                assert len(avail.unavailable) == 0
+                assert len(avail.available) > 0
+
+                self.assertEqual(m.call_url, "/account/availability")
+
     def test_account_availability_api_get(self):
         region_id = "us-east"
         account_availability_url = "/account/availability/{}".format(region_id)
@@ -276,5 +287,6 @@ def test_account_availability_api_get(self):
             availability = AccountAvailability(self.client, region_id)
             self.assertEqual(availability.region, region_id)
             self.assertEqual(availability.unavailable, [])
+            self.assertEqual(availability.available, ["Linodes", "Kubernetes"])
 
             self.assertEqual(m.call_url, account_availability_url)