feat(manager): Loadbalancer service support with one-way objects

Author: Antti Myyrä

CHANGELOG.md

@@ -23,7 +23,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for labels in servers, storages and server groups
 - Server network interface support
 - Server simple backup rule support
+- Loadbalancer object support with labels included
 - Manager support for listing server plans
+- Manager support for load balancers with dictionary responses
 
 ## [2.0.1] - 2023-03-22
 

upcloud_api/__init__.py

@@ -18,6 +18,14 @@
 from upcloud_api.ip_address import IPAddress
 from upcloud_api.ip_network import IpNetwork
 from upcloud_api.label import Label
+from upcloud_api.load_balancer import (
+    LoadBalancer,
+    LoadBalancerBackend,
+    LoadBalancerBackendMember,
+    LoadBalancerFrontend,
+    LoadBalancerFrontEndRule,
+    LoadBalancerNetwork,
+)
 from upcloud_api.network import Network
 from upcloud_api.object_storage import ObjectStorage
 from upcloud_api.router import Router

upcloud_api/cloud_manager/__init__.py

@@ -4,6 +4,7 @@
 from upcloud_api.cloud_manager.firewall_mixin import FirewallManager
 from upcloud_api.cloud_manager.host_mixin import HostManager
 from upcloud_api.cloud_manager.ip_address_mixin import IPManager
+from upcloud_api.cloud_manager.lb_mixin import LoadBalancerManager
 from upcloud_api.cloud_manager.network_mixin import NetworkManager
 from upcloud_api.cloud_manager.object_storage_mixin import ObjectStorageManager
 from upcloud_api.cloud_manager.server_mixin import ServerManager
@@ -12,14 +13,15 @@
 
 
 class CloudManager(
-    ServerManager,
-    IPManager,
-    StorageManager,
     FirewallManager,
-    TagManager,
-    NetworkManager,
     HostManager,
+    IPManager,
+    LoadBalancerManager,
+    NetworkManager,
     ObjectStorageManager,
+    ServerManager,
+    StorageManager,
+    TagManager,
 ):
     """
     CloudManager contains the core functionality of the upcloud API library.

upcloud_api/cloud_manager/lb_mixin.py

@@ -0,0 +1,109 @@
+from upcloud_api.api import API
+from upcloud_api.load_balancer import LoadBalancer, LoadBalancerBackend
+
+
+class LoadBalancerManager:
+    """
+    Functions for managing UpCloud loadbalancer instances and their properties with basic dictionary objects
+    """
+
+    api: API
+
+    def get_loadbalancers(self):
+        """
+        Returns a list of loadbalancer dictionary objects
+        """
+
+        url = '/load-balancer'
+        return self.api.get_request(url)
+
+    def get_loadbalancer(self, lb_uuid: str):
+        """
+        Returns details for a single loadbalancer as a dictionary
+
+        :param lb_uuid:
+        :return: LB details
+        """
+        url = f'/load-balancer/{lb_uuid}'
+        return self.api.get_request(url)
+
+    def create_loadbalancer(self, body: LoadBalancer):
+        """
+        Creates a loadbalancer service specified in body and returns its details
+
+        :param body:
+        :return: LB details
+        """
+
+        url = '/load-balancer'
+        return self.api.post_request(url, body.to_dict())
+
+    def delete_loadbalancer(self, lb_uuid: str):
+        """
+        Deletes a loadbalancer service
+
+        :param lb_uuid:
+        """
+
+        url = f'/load-balancer/{lb_uuid}'
+        return self.api.delete_request(url)
+
+    def get_loadbalancer_backends(self, lb_uuid: str):
+        """
+        Returns a list of backends for a loadbalancer service
+
+        :param lb_uuid:
+        :return: List of LB backends
+        """
+
+        url = f'/load-balancer/{lb_uuid}/backends'
+        return self.api.get_request(url)
+
+    def get_loadbalancer_backend(self, lb_uuid: str, backend: LoadBalancerBackend):
+        """
+        Returns details for a single loadbalancer backend
+
+        :param lb_uuid:
+        :param backend:
+        :return: LB backend details
+        """
+
+        url = f'/load-balancer/{lb_uuid}/backends/{backend.name}'
+        return self.api.get_request(url)
+
+    def create_loadbalancer_backend(self, lb_uuid: str, body: LoadBalancerBackend):
+        """
+        Creates a new backend for a loadbalancer and returns its details
+
+        :param lb_uuid:
+        :param body:
+        :return: LB backend details
+        """
+
+        url = f'/load-balancer/{lb_uuid}/backends'
+        return self.api.post_request(url, body.to_dict())
+
+    def modify_loadbalancer_backend(self, lb_uuid: str, backend: str, body: LoadBalancerBackend):
+        """
+        Modifies an existing loadbalancer backend and returns its details
+
+        :param lb_uuid:
+        :param backend:
+        :param body:
+        :return: LB backend details
+        """
+
+        url = f'/load-balancer/{lb_uuid}/backends/{backend}'
+        return self.api.patch_request(url, body.to_dict())
+
+    def delete_loadbalancer_backend(self, lb_uuid: str, backend: str):
+        """
+        Deletes a loadbalancer backend
+
+        :param lb_uuid:
+        :param backend:
+        :return:
+        """
+
+        url = f'/load-balancer/{lb_uuid}/backends/{backend}'
+        return self.api.delete_request(url)