mpt-extension-sdk 5.7.0__tar.gz → 5.9.0__tar.gz

{mpt_extension_sdk-5.7.0 → mpt_extension_sdk-5.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mpt-extension-sdk
-Version: 5.7.0
+Version: 5.9.0
 Summary: Extensions SDK for SoftwareONE Marketplace Platform
 Author: SoftwareOne AG
 License: Apache-2.0 license

{mpt_extension_sdk-5.7.0 → mpt_extension_sdk-5.9.0}/mpt_extension_sdk/mpt_http/mpt.py

@@ -1,4 +1,5 @@
 import logging
+from collections.abc import Iterable
 from functools import cache
 from itertools import batched
 
@@ -272,6 +273,40 @@ def get_product_onetime_items_by_ids(mpt_client, product_id, item_ids):
     return _paginated(mpt_client, url)
 
 
+@wrap_mpt_http_error
+def get_product_items_by_period(
+    mpt_client,
+    product_id: str,
+    period: str,
+    vendor_external_ids: Iterable[str] | None = None,
+):
+    """
+    Fetches product items based on a specified period and filters.
+
+    Args:
+        mpt_client: Client in tance to interact with the required API.
+        product_id (str): The unique identifier of the product to fetch items for.
+        period (str): The period for which to fetch the product items.
+        vendor_external_ids (Iterable[str] | None):
+            Optional. A list of vendor external IDs to filter out the product items by. Defaults
+            to None.
+
+    Returns:
+        list:
+            A paginated list of product items matching the specified criteria.
+
+    """
+    product_cond = f"eq(product.id,{product_id})"
+    vendors_cond = ""
+    if vendor_external_ids:
+        vendor_ids = ",".join(vendor_external_ids)
+        vendors_cond = f",in(externalIds.vendor,({vendor_ids})))"
+    rql_query = f"and({product_cond},eq(terms.period,{period}){vendors_cond})"
+    url = f"/catalog/items?{rql_query}"
+
+    return _paginated(mpt_client, url)
+
+
 def get_agreements_by_ids(mpt_client, ids):
     """Retrieve agreements by their IDs."""
     ids_str = ",".join(ids)

{mpt_extension_sdk-5.7.0 → mpt_extension_sdk-5.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mpt-extension-sdk"
-version = "5.7.0"
+version = "5.9.0"
 description = "Extensions SDK for SoftwareONE Marketplace Platform"
 authors = [{ name = "SoftwareOne AG" }]
 requires-python = ">=3.12,<4"