edx-enterprise-subsidy-client 0.4.2__py2.py3-none-any.whl → 0.4.4__py2.py3-none-any.whl

edx_enterprise_subsidy_client/__init__.py

@@ -2,6 +2,6 @@
 Client for interacting with the enterprise-subsidy service..
 """
 
-__version__ = '0.4.2'
+__version__ = '0.4.4'
 
 from .client import EnterpriseSubsidyAPIClient, EnterpriseSubsidyAPIClientV2, get_enterprise_subsidy_api_client

edx_enterprise_subsidy_client/client.py

@@ -73,6 +73,41 @@ class EnterpriseSubsidyAPIClient:
             settings.BACKEND_SERVICE_EDX_OAUTH2_SECRET,
         )
 
+    def get_subsidy_aggregates_by_learner_url(self, subsidy_uuid):
+        """
+        Helper method to fetch subsidy learner aggregate data API url.
+        """
+        return f"{self.SUBSIDIES_ENDPOINT}{subsidy_uuid}/aggregates-by-learner"
+
+    def get_subsidy_aggregates_by_learner_data(self, subsidy_uuid, policy_uuid=None):
+        """
+        Client method to fetch subsidy specific learner aggregate data.
+
+        Args:
+            subsidy_uuid (str): Subsidy record UUID
+            policy_uuid (string): Optional param to filter subsidy aggregate data by subsidy access policy UUID
+        Returns:
+            json subsidy learner aggregate data response:
+                [{
+                    'lms_user_id': '1337',
+                    'enrollment_count': 45,
+                } ... ]
+        """
+        url = self.get_subsidy_aggregates_by_learner_url(subsidy_uuid)
+        if policy_uuid:
+            url += f"?subsidy_access_policy_uuid={policy_uuid}"
+        try:
+            resp = self.client.get(url)
+            response_data = resp
+            resp.raise_for_status()
+        except requests.exceptions.HTTPError as exc:
+            logger.exception(
+                f'Subsidy client failed to fetch aggregate data for {subsidy_uuid} '
+                f'and policy: {policy_uuid}'
+            )
+            raise exc
+        return response_data.json()
+
     def get_content_metadata_url(self, content_identifier):
         """Helper method to generate the subsidy service metadata API url, with a trailing slash."""
         return self.CONTENT_METADATA_ENDPOINT + content_identifier + '/'
@@ -256,6 +291,7 @@ class EnterpriseSubsidyAPIClientV2(EnterpriseSubsidyAPIClient):  # pylint: disab
     """
     V2_BASE_URL = EnterpriseSubsidyAPIClient.API_BASE_URL + 'v2/'
     TRANSACTIONS_LIST_ENDPOINT = V2_BASE_URL + 'subsidies/{subsidy_uuid}/admin/transactions/'
+    DEPOSITS_CREATE_ENDPOINT = V2_BASE_URL + 'subsidies/{subsidy_uuid}/admin/deposits/'
 
     def list_subsidy_transactions(
         self, subsidy_uuid, include_aggregates=True,
@@ -335,3 +371,42 @@ class EnterpriseSubsidyAPIClientV2(EnterpriseSubsidyAPIClient):  # pylint: disab
         )
         response.raise_for_status()
         return response.json()
+
+    def create_subsidy_deposit(
+        self,
+        subsidy_uuid,
+        desired_deposit_quantity,
+        sales_contract_reference_id,
+        sales_contract_reference_provider,
+        metadata,
+        idempotency_key=None,
+    ):
+        """
+        Creates a deposit in the given subsidy, requires operator-level permissions.
+
+        Raises:
+            requests.exceptions.HTTPError:
+                - 403 Forbidden: If auth failed.
+                - 429 Too Many Requests: If the ledger was locked (resource contention, try again later).
+                - 400 Bad Request: If any of the values were invalid. Reasons include:
+                      * non-positive quantity.
+                      * provider slug does not exist in database.
+                - 422 Unprocessable Entity: Catchall status for anything that prevented the deposit from being
+                  created.  Reasons include, but are not limited to:
+                      * Subsidy is inactive.
+                      * Another deposit with same idempotency_key already exists.
+        """
+        request_payload = {
+            'desired_deposit_quantity': desired_deposit_quantity,
+            'sales_contract_reference_id': sales_contract_reference_id,
+            'sales_contract_reference_provider': sales_contract_reference_provider,
+            'metadata': metadata,
+        }
+        if idempotency_key is not None:
+            request_payload['idempotency_key'] = idempotency_key
+        response = self.client.post(
+            self.DEPOSITS_CREATE_ENDPOINT.format(subsidy_uuid=subsidy_uuid),
+            json=request_payload,
+        )
+        response.raise_for_status()
+        return response.json()

{edx_enterprise_subsidy_client-0.4.2.dist-info → edx_enterprise_subsidy_client-0.4.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: edx-enterprise-subsidy-client
-Version: 0.4.2
+Version: 0.4.4
 Summary: Client for interacting with the enterprise-subsidy service.
 Home-page: https://github.com/openedx/edx-enterprise-subsidy-client
 Author: edX
@@ -225,6 +225,14 @@ Change Log
 Unreleased
 **********
 
+[0.4.4]
+*******
+* feat: add support for deposit creation (ENT-9133)
+
+[0.4.3]
+*******
+* feat: adding new subsidy client method to fetch subsidy aggregate data
+
 [0.4.2]
 *******
 * Switch from ``edx-sphinx-theme`` to ``sphinx-book-theme`` since the former is

edx_enterprise_subsidy_client-0.4.4.dist-info/RECORD

@@ -0,0 +1,8 @@
+edx_enterprise_subsidy_client/__init__.py,sha256=Zdci1Zm-K660uWJ1Y_Vs13g1SARbGrIhH5KBHBQwbWM,205
+edx_enterprise_subsidy_client/client.py,sha256=z2LwIaS3Wf2j16eTjfFKJDR4DKZNegO9mlESLgb_pJQ,14993
+edx_enterprise_subsidy_client-0.4.4.dist-info/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+edx_enterprise_subsidy_client-0.4.4.dist-info/LICENSE.txt,sha256=QTW2QN7q3XszgUAXm9Dzgtu5LXYKbR1SGnqMa7ufEuY,35139
+edx_enterprise_subsidy_client-0.4.4.dist-info/METADATA,sha256=6hG5lkL-BlcmYA7qb_n3UbXGV4wqsiOr-nEZkaHCy1c,9654
+edx_enterprise_subsidy_client-0.4.4.dist-info/WHEEL,sha256=DZajD4pwLWue70CAfc7YaxT1wLUciNBvN_TTcvXpltE,110
+edx_enterprise_subsidy_client-0.4.4.dist-info/top_level.txt,sha256=X3PxOH44rjQXFaA8EX-ZpUEL4SjfMM_yUkS-KbvNIZk,30
+edx_enterprise_subsidy_client-0.4.4.dist-info/RECORD,,

edx_enterprise_subsidy_client-0.4.2.dist-info/RECORD

@@ -1,8 +0,0 @@
-edx_enterprise_subsidy_client/__init__.py,sha256=pVBRY-wyZG5jjNn36RKC6TwPZOewHBLgPB9X51mm9dA,205
-edx_enterprise_subsidy_client/client.py,sha256=56yVQkW6Mgbcm1qTYpJInBVMyIqG3QQSIm4q5MB1MHc,11836
-edx_enterprise_subsidy_client-0.4.2.dist-info/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
-edx_enterprise_subsidy_client-0.4.2.dist-info/LICENSE.txt,sha256=QTW2QN7q3XszgUAXm9Dzgtu5LXYKbR1SGnqMa7ufEuY,35139
-edx_enterprise_subsidy_client-0.4.2.dist-info/METADATA,sha256=hN5GPSj3BnKA78NVjG5S9PeBSQvkNKBEgPdBMZ2ybUo,9495
-edx_enterprise_subsidy_client-0.4.2.dist-info/WHEEL,sha256=DZajD4pwLWue70CAfc7YaxT1wLUciNBvN_TTcvXpltE,110
-edx_enterprise_subsidy_client-0.4.2.dist-info/top_level.txt,sha256=X3PxOH44rjQXFaA8EX-ZpUEL4SjfMM_yUkS-KbvNIZk,30
-edx_enterprise_subsidy_client-0.4.2.dist-info/RECORD,,