[MPT-13828] Adding billing invoices endpoints (#55)

Adding billing invoices endpoints
https://softwareone.atlassian.net/browse/MPT-13828

Author: d3rky

mpt_api_client/resources/billing/billing.py

@@ -1,4 +1,5 @@
 from mpt_api_client.http import AsyncHTTPClient, HTTPClient
+from mpt_api_client.resources.billing.invoices import AsyncInvoicesService, InvoicesService
 from mpt_api_client.resources.billing.journals import AsyncJournalsService, JournalsService
 from mpt_api_client.resources.billing.ledgers import AsyncLedgersService, LedgersService
 from mpt_api_client.resources.billing.statements import AsyncStatementsService, StatementsService
@@ -25,6 +26,11 @@ def statements(self) -> StatementsService:
         """Statements service."""
         return StatementsService(http_client=self.http_client)
 
+    @property
+    def invoices(self) -> InvoicesService:
+        """Invoices service."""
+        return InvoicesService(http_client=self.http_client)
+
 
 class AsyncBilling:
     """Billing MPT API Module."""
@@ -46,3 +52,8 @@ def ledgers(self) -> AsyncLedgersService:
     def statements(self) -> AsyncStatementsService:
         """Statements service."""
         return AsyncStatementsService(http_client=self.http_client)
+
+    @property
+    def invoices(self) -> AsyncInvoicesService:
+        """Invoices service."""
+        return AsyncInvoicesService(http_client=self.http_client)

mpt_api_client/resources/billing/invoices.py

@@ -0,0 +1,33 @@
+from mpt_api_client.http import AsyncService, Service
+from mpt_api_client.http.mixins import AsyncCreateMixin, AsyncUpdateMixin, CreateMixin, UpdateMixin
+from mpt_api_client.models import Model
+
+
+class Invoice(Model):
+    """Invoice resource."""
+
+
+class InvoicesServiceConfig:
+    """Invoices service configuration."""
+
+    _endpoint = "/public/v1/billing/invoices"
+    _model_class = Invoice
+    _collection_key = "data"
+
+
+class InvoicesService(
+    CreateMixin[Invoice],
+    UpdateMixin[Invoice],
+    Service[Invoice],
+    InvoicesServiceConfig,
+):
+    """Invoices service."""
+
+
+class AsyncInvoicesService(
+    AsyncCreateMixin[Invoice],
+    AsyncUpdateMixin[Invoice],
+    AsyncService[Invoice],
+    InvoicesServiceConfig,
+):
+    """Async Invoices service."""

tests/resources/billing/test_billing.py

@@ -1,6 +1,7 @@
 import pytest
 
 from mpt_api_client.resources.billing.billing import AsyncBilling, Billing
+from mpt_api_client.resources.billing.invoices import AsyncInvoicesService, InvoicesService
 from mpt_api_client.resources.billing.journals import AsyncJournalsService, JournalsService
 from mpt_api_client.resources.billing.ledgers import AsyncLedgersService, LedgersService
 from mpt_api_client.resources.billing.statements import AsyncStatementsService, StatementsService
@@ -22,6 +23,7 @@ def async_billing(async_http_client):
         ("journals", JournalsService),
         ("ledgers", LedgersService),
         ("statements", StatementsService),
+        ("invoices", InvoicesService),
     ],
 )
 def test_billing_properties(billing, property_name, expected_service_class):
@@ -38,6 +40,7 @@ def test_billing_properties(billing, property_name, expected_service_class):
         ("journals", AsyncJournalsService),
         ("ledgers", AsyncLedgersService),
         ("statements", AsyncStatementsService),
+        ("invoices", AsyncInvoicesService),
     ],
 )
 def test_async_billing_properties(async_billing, property_name, expected_service_class):

tests/resources/billing/test_invoices.py

@@ -0,0 +1,32 @@
+import pytest
+
+from mpt_api_client.resources.billing.invoices import (
+    AsyncInvoicesService,
+    InvoicesService,
+)
+
+
+@pytest.fixture
+def invoices_service(http_client):
+    return InvoicesService(http_client=http_client)
+
+
+@pytest.fixture
+def async_invoices_service(async_http_client):
+    return AsyncInvoicesService(http_client=async_http_client)
+
+
+@pytest.mark.parametrize(
+    "method",
+    ["get", "create", "update"],
+)
+def test_mixins_present(invoices_service, method):
+    assert hasattr(invoices_service, method)
+
+
+@pytest.mark.parametrize(
+    "method",
+    ["get", "create", "update"],
+)
+def test_async_mixins_present(async_invoices_service, method):
+    assert hasattr(async_invoices_service, method)