Add annotations for cloud_manager instance variable

Author: akx

upcloud_api/server.py

@@ -1,11 +1,14 @@
 from time import sleep
-from typing import Any, Optional
+from typing import TYPE_CHECKING, Any, Optional
 
 from upcloud_api.firewall import FirewallRule
 from upcloud_api.ip_address import IPAddress
 from upcloud_api.storage import Storage
 from upcloud_api.utils import try_it_n_times
 
+if TYPE_CHECKING:
+    from upcloud_api import CloudManager
+
 
 def login_user_block(username, ssh_keys, create_password=True):
     """
@@ -24,6 +27,7 @@ def login_user_block(username, ssh_keys, create_password=True):
     return block
 
 
+# TODO: should this inherit from UpcloudResource too?
 class Server:
     """
     Class representation of UpCloud Server instance.
@@ -32,6 +36,8 @@ class Server:
     with the server.field=value syntax. See __setattr__ override.
     """
 
+    cloud_manager: 'CloudManager'
+
     #
     # Functionality for partial immutability and repopulating the object from API.
     #

upcloud_api/upcloud_resource.py

@@ -1,3 +1,9 @@
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from upcloud_api import CloudManager
+
+
 class UpCloudResource:
     """
     Base class for all API resources.
@@ -15,6 +21,8 @@ class UpCloudResource:
 
     ATTRIBUTES = {}  # subclass should define this
 
+    cloud_manager: 'CloudManager'
+
     def __init__(self, **kwargs) -> None:
         """
         Create a resource object from a dict.