Added Accounts accounts users endpoint

Author: Robert Segal

mpt_api_client/resources/accounts/account.py

@@ -6,6 +6,10 @@
     UpdateMixin,
 )
 from mpt_api_client.models import Model
+from mpt_api_client.resources.accounts.accounts_users import (
+    AccountsUsersService,
+    AsyncAccountsUsersService,
+)
 from mpt_api_client.resources.accounts.mixins import (
     ActivatableMixin,
     AsyncActivatableMixin,
@@ -39,6 +43,12 @@ class AccountsService(
 ):
     """Accounts service."""
 
+    def users(self, account_id: str) -> AccountsUsersService:
+        """Return account users service."""
+        return AccountsUsersService(
+            http_client=self.http_client, endpoint_params={"account_id": account_id}
+        )
+
 
 class AsyncAccountsService(
     AsyncCreateMixin[Account],
@@ -50,3 +60,9 @@ class AsyncAccountsService(
     AccountsServiceConfig,
 ):
     """Async Accounts service."""
+
+    def users(self, account_id: str) -> AsyncAccountsUsersService:
+        """Return account users service."""
+        return AsyncAccountsUsersService(
+            http_client=self.http_client, endpoint_params={"account_id": account_id}
+        )

mpt_api_client/resources/accounts/accounts_users.py

@@ -0,0 +1,48 @@
+from mpt_api_client.http import AsyncService, Service
+from mpt_api_client.http.mixins import (
+    AsyncCreateMixin,
+    AsyncDeleteMixin,
+    AsyncUpdateMixin,
+    CreateMixin,
+    DeleteMixin,
+    UpdateMixin,
+)
+from mpt_api_client.models import Model
+from mpt_api_client.resources.accounts.mixins import (
+    AsyncInvitableMixin,
+    InvitableMixin,
+)
+
+
+class AccountsUser(Model):
+    """Account User Model."""
+
+
+class AccountsUsersServiceConfig:
+    """Account Users Service Configuration."""
+
+    _endpoint = "/public/v1/accounts/accounts/{account_id}/users"
+    _model_class = AccountsUser
+    _collection_key = "data"
+
+
+class AccountsUsersService(
+    UpdateMixin[AccountsUser],
+    DeleteMixin,
+    CreateMixin[AccountsUser],
+    InvitableMixin[AccountsUser],
+    Service[AccountsUser],
+    AccountsUsersServiceConfig,
+):
+    """Account Users Service."""
+
+
+class AsyncAccountsUsersService(
+    AsyncUpdateMixin[AccountsUser],
+    AsyncDeleteMixin,
+    AsyncCreateMixin[AccountsUser],
+    AsyncService[AccountsUser],
+    AsyncInvitableMixin[AccountsUser],
+    AccountsUsersServiceConfig,
+):
+    """Asynchronous Account Users Service."""

mpt_api_client/resources/accounts/mixins.py

@@ -71,6 +71,43 @@ def validate(self, resource_id: str, resource_data: ResourceData | None = None)
         )
 
 
+class InvitableMixin[Model]:
+    """Invitable mixin for sending and managing invites for resources."""
+
+    def accept_invite(self, resource_id: str, resource_data: ResourceData | None = None) -> Model:
+        """Accept an invite for a resource.
+
+        Args:
+            resource_id: Resource ID
+            resource_data: Resource data will be updated
+        """
+        return self._resource_action(  # type: ignore[attr-defined, no-any-return]
+            resource_id, "POST", "accept-invite", json=resource_data
+        )
+
+    def resend_invite(self, resource_id: str, resource_data: ResourceData | None = None) -> Model:
+        """Resend an invite to a resource.
+
+        Args:
+            resource_id: Resource ID
+            resource_data: Resource data will be updated
+        """
+        return self._resource_action(  # type: ignore[attr-defined, no-any-return]
+            resource_id, "POST", "resend-invite", json=resource_data
+        )
+
+    def send_new_invite(self, resource_id: str, resource_data: ResourceData | None = None) -> Model:
+        """Send a new invite to a resource.
+
+        Args:
+            resource_id: Resource ID
+            resource_data: Resource data will be updated
+        """
+        return self._resource_action(  # type: ignore[attr-defined, no-any-return]
+            resource_id, "POST", "send-new-invite", json=resource_data
+        )
+
+
 class AsyncActivatableMixin[Model]:
     """Async activatable mixin for activating, enabling, disabling and deactivating resources."""
 
@@ -138,3 +175,46 @@ async def validate(self, resource_id: str, resource_data: ResourceData | None =
         return await self._resource_action(  # type: ignore[attr-defined, no-any-return]
             resource_id, "POST", "validate", json=resource_data
         )
+
+
+class AsyncInvitableMixin[Model]:
+    """Asynchronous Invitable mixin for sending and managing invites for resources."""
+
+    async def accept_invite(
+        self, resource_id: str, resource_data: ResourceData | None = None
+    ) -> Model:
+        """Accept an invite for a resource.
+
+        Args:
+            resource_id: Resource ID
+            resource_data: Resource data will be updated
+        """
+        return await self._resource_action(  # type: ignore[attr-defined, no-any-return]
+            resource_id, "POST", "accept-invite", json=resource_data
+        )
+
+    async def resend_invite(
+        self, resource_id: str, resource_data: ResourceData | None = None
+    ) -> Model:
+        """Resend an invite to a resource.
+
+        Args:
+            resource_id: Resource ID
+            resource_data: Resource data will be updated
+        """
+        return await self._resource_action(  # type: ignore[attr-defined, no-any-return]
+            resource_id, "POST", "resend-invite", json=resource_data
+        )
+
+    async def send_new_invite(
+        self, resource_id: str, resource_data: ResourceData | None = None
+    ) -> Model:
+        """Send a new invite to a resource.
+
+        Args:
+            resource_id: Resource ID
+            resource_data: Resource data will be updated
+        """
+        return await self._resource_action(  # type: ignore[attr-defined, no-any-return]
+            resource_id, "POST", "send-new-invite", json=resource_data
+        )

setup.cfg

@@ -36,6 +36,7 @@ per-file-ignores =
   mpt_api_client/mpt_client.py: WPS214 WPS235
   mpt_api_client/http/mixins.py: WPS202
   mpt_api_client/resources/*: WPS215
+  mpt_api_client/resources/accounts/*.py: WPS202 WPS215
   mpt_api_client/resources/billing/*.py: WPS202 WPS204 WPS214 WPS215
   mpt_api_client/resources/catalog/*.py: WPS110 WPS214 WPS215
   mpt_api_client/resources/catalog/products.py: WPS204 WPS214 WPS215

tests/resources/accounts/test_account.py

@@ -1,6 +1,10 @@
 import pytest
 
 from mpt_api_client.resources.accounts.account import AccountsService, AsyncAccountsService
+from mpt_api_client.resources.accounts.accounts_users import (
+    AccountsUsersService,
+    AsyncAccountsUsersService,
+)
 
 
 @pytest.fixture
@@ -13,6 +17,20 @@ def async_account_service(async_http_client):
     return AsyncAccountsService(http_client=async_http_client)
 
 
+@pytest.fixture
+def accounts_users_service(http_client):
+    return AccountsUsersService(
+        http_client=http_client, endpoint_params={"account_id": "ACC-0000-0001"}
+    )
+
+
+@pytest.fixture
+def async_accounts_users_service(async_http_client):
+    return AsyncAccountsUsersService(
+        http_client=async_http_client, endpoint_params={"account_id": "ACC-0000-0001"}
+    )
+
+
 @pytest.mark.parametrize(
     "method", ["get", "create", "update", "enable", "disable", "activate", "deactivate", "validate"]
 )
@@ -25,3 +43,29 @@ def test_mixins_present(account_service, method):
 )
 def test_async_mixins_present(async_account_service, method):
     assert hasattr(async_account_service, method)
+
+
+@pytest.mark.parametrize(
+    ("service_method", "expected_service_class"),
+    [
+        ("users", AccountsUsersService),
+    ],
+)
+def test_property_services(account_service, service_method, expected_service_class):
+    service = getattr(account_service, service_method)("ACC-0000-0001")
+
+    assert isinstance(service, expected_service_class)
+    assert service.endpoint_params == {"account_id": "ACC-0000-0001"}
+
+
+@pytest.mark.parametrize(
+    ("service_method", "expected_service_class"),
+    [
+        ("users", AsyncAccountsUsersService),
+    ],
+)
+def test_async_property_services(async_account_service, service_method, expected_service_class):
+    service = getattr(async_account_service, service_method)("ACC-0000-0001")
+
+    assert isinstance(service, expected_service_class)
+    assert service.endpoint_params == {"account_id": "ACC-0000-0001"}

tests/resources/accounts/test_accounts_users.py

@@ -0,0 +1,46 @@
+import pytest
+
+from mpt_api_client.resources.accounts.accounts_users import (
+    AccountsUsersService,
+    AsyncAccountsUsersService,
+)
+
+
+@pytest.fixture
+def accounts_users_service(http_client):
+    return AccountsUsersService(
+        http_client=http_client, endpoint_params={"account_id": "ACC-0000-0001"}
+    )
+
+
+@pytest.fixture
+def async_accounts_users_service(async_http_client):
+    return AsyncAccountsUsersService(
+        http_client=async_http_client, endpoint_params={"account_id": "ACC-0000-0001"}
+    )
+
+
+def test_endpoint(accounts_users_service):
+    assert accounts_users_service.endpoint == "/public/v1/accounts/accounts/ACC-0000-0001/users"
+
+
+def test_async_endpoint(async_accounts_users_service):
+    assert (
+        async_accounts_users_service.endpoint == "/public/v1/accounts/accounts/ACC-0000-0001/users"
+    )
+
+
+@pytest.mark.parametrize(
+    "method",
+    ["get", "create", "update", "accept_invite", "resend_invite", "send_new_invite"],
+)
+def test_methods_present(accounts_users_service, method):
+    assert hasattr(accounts_users_service, method)
+
+
+@pytest.mark.parametrize(
+    "method",
+    ["get", "create", "update", "accept_invite", "resend_invite", "send_new_invite"],
+)
+def test_async_methods_present(async_accounts_users_service, method):
+    assert hasattr(async_accounts_users_service, method)