MPT-13323 Add catalog products terms

Author: albertsola

mpt_api_client/resources/catalog/product_terms.py

@@ -0,0 +1,43 @@
+from mpt_api_client.http import AsyncService, CreateMixin, DeleteMixin, Service
+from mpt_api_client.http.mixins import (
+    AsyncCreateMixin,
+    AsyncDeleteMixin,
+    AsyncUpdateMixin,
+    UpdateMixin,
+)
+from mpt_api_client.models import Model
+from mpt_api_client.resources.catalog.mixins import AsyncPublishableMixin, PublishableMixin
+
+
+class Term(Model):
+    """Term resource."""
+
+
+class TermServiceConfig:
+    """Term service configuration."""
+
+    _endpoint = "/public/v1/catalog/products/{product_id}/terms"
+    _model_class = Term
+    _collection_key = "data"
+
+
+class TermService(
+    CreateMixin[Term],
+    DeleteMixin,
+    UpdateMixin[Term],
+    PublishableMixin[Term],
+    Service[Term],
+    TermServiceConfig,
+):
+    """Term service."""
+
+
+class AsyncTermService(
+    AsyncCreateMixin[Term],
+    AsyncDeleteMixin,
+    AsyncUpdateMixin[Term],
+    AsyncPublishableMixin[Term],
+    AsyncService[Term],
+    TermServiceConfig,
+):
+    """Async Term service."""

mpt_api_client/resources/catalog/products.py

@@ -11,6 +11,10 @@
     AsyncPublishableMixin,
     PublishableMixin,
 )
+from mpt_api_client.resources.catalog.product_terms import (
+    AsyncTermService,
+    TermService,
+)
 from mpt_api_client.resources.catalog.products_documents import (
     AsyncDocumentService,
     DocumentService,
@@ -95,6 +99,10 @@ def templates(self, product_id: str) -> TemplatesService:
             http_client=self.http_client, endpoint_params={"product_id": product_id}
         )
 
+    def terms(self, product_id: str) -> TermService:
+        """Return terms service."""
+        return TermService(http_client=self.http_client, endpoint_params={"product_id": product_id})
+
 
 class AsyncProductsService(
     AsyncCreateMixin[Product],
@@ -141,3 +149,9 @@ def templates(self, product_id: str) -> AsyncTemplatesService:
         return AsyncTemplatesService(
             http_client=self.http_client, endpoint_params={"product_id": product_id}
         )
+
+    def terms(self, product_id: str) -> AsyncTermService:
+        """Return terms service."""
+        return AsyncTermService(
+            http_client=self.http_client, endpoint_params={"product_id": product_id}
+        )

setup.cfg

@@ -41,6 +41,7 @@ per-file-ignores =
   mpt_api_client/resources/catalog/products_media.py: WPS215
   mpt_api_client/resources/catalog/products_documents.py: WPS215
   mpt_api_client/resources/catalog/products_templates.py: WPS215
+  mpt_api_client/resources/catalog/product_terms.py: WPS215
   tests/http/test_async_service.py: WPS204 WPS202
   tests/http/test_service.py: WPS204 WPS202
 

tests/resources/catalog/test_product_terms.py

@@ -0,0 +1,40 @@
+import pytest
+
+from mpt_api_client.resources.catalog.product_terms import (
+    AsyncTermService,
+    TermService,
+)
+
+
+@pytest.fixture
+def term_service(http_client):
+    return TermService(http_client=http_client, endpoint_params={"product_id": "PRD-001"})
+
+
+@pytest.fixture
+def async_term_service(async_http_client):
+    return AsyncTermService(
+        http_client=async_http_client, endpoint_params={"product_id": "PRD-001"}
+    )
+
+
+def test_endpoint(term_service):
+    assert term_service.endpoint == "/public/v1/catalog/products/PRD-001/terms"
+
+
+def test_async_endpoint(async_term_service):
+    assert async_term_service.endpoint == "/public/v1/catalog/products/PRD-001/terms"
+
+
+@pytest.mark.parametrize(
+    "method", ["get", "create", "delete", "update", "review", "publish", "unpublish"]
+)
+def test_methods_present(term_service, method):
+    assert hasattr(term_service, method)
+
+
+@pytest.mark.parametrize(
+    "method", ["get", "create", "delete", "update", "review", "publish", "unpublish"]
+)
+def test_async_methods_present(async_term_service, method):
+    assert hasattr(async_term_service, method)

tests/resources/catalog/test_products.py

@@ -1,5 +1,9 @@
 import pytest
 
+from mpt_api_client.resources.catalog.product_terms import (
+    AsyncTermService,
+    TermService,
+)
 from mpt_api_client.resources.catalog.products import AsyncProductsService, ProductsService
 from mpt_api_client.resources.catalog.products_documents import (
     AsyncDocumentService,
@@ -60,6 +64,7 @@ def test_async_mixins_present(async_products_service, method):
         ("documents", DocumentService),
         ("product_parameters", ParametersService),
         ("templates", TemplatesService),
+        ("terms", TermService),
     ],
 )
 def test_property_services(products_service, service_method, expected_service_class):
@@ -78,6 +83,7 @@ def test_property_services(products_service, service_method, expected_service_cl
         ("documents", AsyncDocumentService),
         ("product_parameters", AsyncParametersService),
         ("templates", AsyncTemplatesService),
+        ("terms", AsyncTermService),
     ],
 )
 def test_async_property_services(async_products_service, service_method, expected_service_class):