diaspora-event-sdk 0.2.0__tar.gz → 0.2.2__tar.gz

{diaspora-event-sdk-0.2.0/diaspora_event_sdk.egg-info → diaspora-event-sdk-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: diaspora-event-sdk
-Version: 0.2.0
+Version: 0.2.2
 Summary: SDK of Diaspora Event Fabric: Resilience-enabling services for science from HPC to edge
 Home-page: https://github.com/globus-labs/diaspora-event-sdk
 License: LICENSE

{diaspora-event-sdk-0.2.0 → diaspora-event-sdk-0.2.2}/diaspora_event_sdk/sdk/client.py

@@ -37,7 +37,7 @@ class Client:
     @requires_login
     def create_key(self):
         """
-        Invalidate previous keys (if any) and generate a new one
+        Revokes existing keys, generates a new key, and updates the token storage with the newly created key and the Diaspora endpoint.
         """
         resp = self.web_client.create_key(self.subject_openid)
         if resp["status"] == "error":
@@ -70,7 +70,7 @@ class Client:
     @requires_login
     def retrieve_key(self):
         """
-        Attempt to retrieve the key from local token storage, and call create_key if local key is not found
+        Retrieves the key from local token storage, and calls create_key() if the local key is not found.
         """
         tokens = self.login_manager._token_storage.get_token_data(
             DIASPORA_RESOURCE_SERVER
@@ -114,83 +114,85 @@ class Client:
     @requires_login
     def list_topics(self):
         """
-        Retrieves the list of topics associated with the user's OpenID.
+        Returns a list of topics currently registered under the user's account.
         """
         return self.web_client.list_topics(self.subject_openid)
 
     @requires_login
     def register_topic(self, topic):
         """
-        Registers a new topic under the user's OpenID.
+        Registers a new topic the user's account with permissions to read, write, and describe the topic.
         """
         return self.web_client.register_topic(self.subject_openid, topic, "register")
 
     @requires_login
     def unregister_topic(self, topic):
         """
-        Unregisters a topic from the user's OpenID.
+        Unregisters a topic from a user's account, but all existing events within the topic are unaffected.
         """
         return self.web_client.register_topic(self.subject_openid, topic, "unregister")
 
     @requires_login
     def get_topic_configs(self, topic):
         """
-        Get topic configurations.
+        Retrieves the current configurations for a registered topic.
         """
         return self.web_client.get_topic_configs(self.subject_openid, topic)
 
     @requires_login
     def update_topic_configs(self, topic, configs):
         """
-        Set topic configurations.
+        Updates the configurations for a registered topic.
         """
         return self.web_client.update_topic_configs(self.subject_openid, topic, configs)
 
     @requires_login
     def update_topic_partitions(self, topic, new_partitions):
         """
-        Adjust topic number of partitions
+        Increases the number of partitions for a given topic to the specified new partition count.
         """
         return self.web_client.update_topic_partitions(self.subject_openid, topic, new_partitions)
 
     @requires_login
     def grant_user_access(self, topic, user):
         """
-        Registers a new topic under the user's OpenID.
+        Authorizes another user to access a registered topic under the invoker's account.
         """
         return self.web_client.grant_user_access(self.subject_openid, topic, user, "grant")
 
     @requires_login
     def revoke_user_access(self, topic, user):
         """
-        Unregisters a topic from the user's OpenID.
+        Removes access permissions for another user from a registered topic under the invoker's account.
         """
         return self.web_client.grant_user_access(self.subject_openid, topic, user, "revoke")
 
     @requires_login
     def list_triggers(self):
         """
-        Retrieves the list of functions associated with the user's OpenID.
+        Retrieves a list of triggers associated created under the user's account, showing each trigger's configurations and UUID.
         """
         return self.web_client.list_triggers(self.subject_openid)
 
     @requires_login
-    def create_trigger(self, topic, function, function_configs):
+    def create_trigger(self, topic, function, function_configs, trigger_configs):
         """
-        Registers a new functions under the user's OpenID.
+        Creates a new trigger under the user's account with specific function and invocation configurations. 
         """
-        return self.web_client.create_trigger(self.subject_openid, topic, function, "create", function_configs)
+        return self.web_client.create_trigger(
+            self.subject_openid, topic, function, "create", function_configs, trigger_configs)
 
     @requires_login
     def delete_trigger(self, topic, function):
         """
-        Unregisters a functions from the user's OpenID.
+        Deletes a trigger and related AWS resources, while the associated topic remains unaffected.
         """
-        return self.web_client.create_trigger(self.subject_openid, topic, function, "delete", {})
+        return self.web_client.create_trigger(
+            self.subject_openid, topic, function, "delete", {}, {})
 
     @requires_login
     def update_trigger(self, trigger_uuid, trigger_configs):
         """
-        Update a functions's trigger'.
+        Updates invocation configurations of an existing trigger, identified by its unique trigger UUID.
         """
         return self.web_client.update_trigger(self.subject_openid, trigger_uuid, trigger_configs)

{diaspora-event-sdk-0.2.0 → diaspora-event-sdk-0.2.2}/diaspora_event_sdk/sdk/login_manager/client_login.py

@@ -1,7 +1,7 @@
 """
-Logic for using client identities with the Diaspora Event SDK
+Logic for using client identities with the Diaspora SDK
 
-This is based on the Globus CLI client login:
+The design is based on the Globus CLI client login:
 https://github.com/globus/globus-cli/blob/main/src/globus_cli/login_manager/client_login.py
 """
 from __future__ import annotations
@@ -9,13 +9,14 @@ from __future__ import annotations
 import logging
 import os
 import uuid
+from typing import Union
 
 import globus_sdk
 
 log = logging.getLogger(__name__)
 
 
-def _get_client_creds_from_env() -> tuple[str | None, str | None]:
+def _get_client_creds_from_env() -> tuple[Union[str, None], Union[str, None]]:
     client_id = os.getenv("DIASPORA_SDK_CLIENT_ID")
     client_secret = os.getenv("DIASPORA_SDK_CLIENT_SECRET")
     return client_id, client_secret

{diaspora-event-sdk-0.2.0 → diaspora-event-sdk-0.2.2}/diaspora_event_sdk/sdk/login_manager/globus_auth.py

@@ -3,14 +3,14 @@ import os
 import globus_sdk
 
 
-def internal_auth_client():
+def internal_auth_client() -> globus_sdk.NativeAppAuthClient:
     """
-    This is the client that represents the Diaspora Event Fabric application itself
+    This is the client that represents the Diaspora Event Fabric application itself.
     """
 
-    client_id = os.environ.get(
+    client_id: str = os.environ.get(
         "DIASPORA_SDK_CLIENT_ID", "c5d4fab4-7f0d-422e-b0c8-5c74329b52fe"
     )
     return globus_sdk.NativeAppAuthClient(
         client_id, app_name="Diaspora Event Fabric (internal client)"
-    )
+    )

{diaspora-event-sdk-0.2.0 → diaspora-event-sdk-0.2.2}/diaspora_event_sdk/sdk/login_manager/login_flow.py

@@ -1,11 +1,12 @@
 from __future__ import annotations
 
 import platform
+from typing import List
 
 from .globus_auth import internal_auth_client
 
 
-def do_link_auth_flow(scopes: list[str]):
+def do_link_auth_flow(scopes: List[str]):
     auth_client = internal_auth_client()
 
     # start the Confidential App Grant flow
@@ -31,4 +32,4 @@ def do_link_auth_flow(scopes: list[str]):
     auth_code = input("Enter the resulting Authorization Code here: ").strip()
 
     # finish auth flow
-    return auth_client.oauth2_exchange_code_for_tokens(auth_code)
+    return auth_client.oauth2_exchange_code_for_tokens(auth_code)

{diaspora-event-sdk-0.2.0 → diaspora-event-sdk-0.2.2}/diaspora_event_sdk/sdk/web_client.py

@@ -33,7 +33,8 @@ class WebClient(globus_sdk.BaseClient):
         self, subject: UUID_LIKE_T, topic: str, action: str
     ) -> globus_sdk.GlobusHTTPResponse:
         return self.put(
-            f"/api/v2/topic/{topic}", headers={"Subject": str(subject), "Action": action}
+            f"/api/v2/topic/{topic}",
+            headers={"Subject": str(subject), "Action": action}
         )
 
     def get_topic_configs(
@@ -41,8 +42,7 @@ class WebClient(globus_sdk.BaseClient):
     ) -> globus_sdk.GlobusHTTPResponse:
         return self.get(
             f"/api/v2/topic/{topic}",
-            headers={"Subject": str(subject), "Topic": topic},
-            # data=json.dumps(configs).encode("utf-8")
+            headers={"Subject": str(subject), "Topic": topic}
         )
 
     def update_topic_configs(
@@ -61,7 +61,7 @@ class WebClient(globus_sdk.BaseClient):
         return self.post(
             f"/api/v2/topic/{topic}/partitions",
             headers={"Subject": str(subject), "Topic": topic,
-                     "NewPartitions": str(new_partitions)},
+                     "NewPartitions": str(new_partitions)}
         )
 
     def grant_user_access(
@@ -78,14 +78,15 @@ class WebClient(globus_sdk.BaseClient):
 
     def create_trigger(
         self, subject: UUID_LIKE_T, topic: str, function: str, action: str,
-        function_configs: dict
+        function_configs: dict, trigger_configs: dict
     ) -> globus_sdk.GlobusHTTPResponse:
         return self.put(
             "/api/v2/trigger",
             headers={"Subject": str(subject), "Topic": topic,
                      "Trigger": function, "Action": action,
                      "Content-Type": "text/plain"},
-            data=json.dumps(function_configs).encode("utf-8")
+            data=json.dumps({"function": function_configs,
+                             "trigger": trigger_configs}).encode("utf-8")
         )
 
     def update_trigger(

diaspora-event-sdk-0.2.2/diaspora_event_sdk/version.py

@@ -0,0 +1 @@
+__version__ = "0.2.2"

{diaspora-event-sdk-0.2.0 → diaspora-event-sdk-0.2.2/diaspora_event_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: diaspora-event-sdk
-Version: 0.2.0
+Version: 0.2.2
 Summary: SDK of Diaspora Event Fabric: Resilience-enabling services for science from HPC to edge
 Home-page: https://github.com/globus-labs/diaspora-event-sdk
 License: LICENSE

{diaspora-event-sdk-0.2.0 → diaspora-event-sdk-0.2.2}/tests/unit/test_client.py

@@ -91,10 +91,10 @@ def test_list_topics(client):
 def test_register_topic(client):
     topic = "test_topic"
     client.register_topic(topic)
-    client.web_client.register_topic.assert_called_with("test_sub", topic)
+    client.web_client.register_topic.assert_called_with("test_sub", topic, "register")
 
 
 def test_unregister_topic(client):
     topic = "test_topic"
     client.unregister_topic(topic)
-    client.web_client.unregister_topic.assert_called_with("test_sub", topic)
+    client.web_client.register_topic.assert_called_with("test_sub", topic, "unregister")

{diaspora-event-sdk-0.2.0 → diaspora-event-sdk-0.2.2}/tox.ini

@@ -1,5 +1,5 @@
 [tox]
-envlist = py{37, 38, 39, 310, 311}, mypy
+envlist = py{37, 38, 39, 310, 311, 312}, mypy
 
 [testenv]
 deps =

diaspora-event-sdk-0.2.0/diaspora_event_sdk/version.py

@@ -1 +0,0 @@
-__version__ = "0.2.0"