Entities, entities, entities...

setup.py

@@ -26,6 +26,7 @@
     extras_require={
         'dev': [
             'pytest>=7.0.0',
+            'pylint>=3.0.3',
             'setuptools>=69.0.3',
         ],
     },

src/Entities/Adjustment.py

@@ -0,0 +1,51 @@
+from __future__  import annotations
+from dataclasses import dataclass
+from datetime    import datetime
+from typing      import Optional, List
+
+from src.Entities.Entity import Entity
+
+from src.Entities.Shared.Action                 import Action
+from src.Entities.Shared.AdjustmentItemTotals   import AdjustmentItemTotals
+from src.Entities.Shared.CurrencyCode           import CurrencyCode
+from src.Entities.Shared.PayoutTotalsAdjustment import PayoutTotalsAdjustment
+from src.Entities.Shared.StatusAdjustment       import StatusAdjustment
+from src.Entities.Shared.TotalAdjustments       import TotalAdjustments
+
+
+@dataclass
+class Adjustment(Entity):
+    id:                     str
+    action:                 Action
+    transactionId:          str
+    subscriptionId:         Optional[str]
+    customerId:             str
+    reason:                 str
+    creditAppliedToBalance: Optional[bool]
+    currencyCode:           CurrencyCode
+    status:                 StatusAdjustment
+    items:                  List[AdjustmentItemTotals]
+    totals:                 TotalAdjustments
+    payoutTotals:           Optional[PayoutTotalsAdjustment]
+    createdAt:              datetime
+    updatedAt:              Optional[datetime]
+
+
+    @classmethod
+    def from_dict(cls, data: dict) -> Adjustment:
+        return Adjustment(
+            id                     = data['id'],
+            action                 = Action(data['action']),
+            transactionId          = data['transaction_id'],
+            subscriptionId         = data.get('subscription_id'),
+            customerId             = data['customer_id'],
+            reason                 = data['reason'],
+            creditAppliedToBalance = data.get('credit_applied_to_balance'),
+            currencyCode           = CurrencyCode(data['currency_code']),
+            status                 = StatusAdjustment(data['status']),
+            items                  = [AdjustmentItemTotals(item) for item in data['items']],
+            totals                 = TotalAdjustments.from_dict(data['totals']),
+            payoutTotals           = PayoutTotalsAdjustment.from_dict(data['payout_totals']) if 'payout_totals' in data else None,
+            createdAt              = datetime.fromisoformat(data['created_at']),
+            updatedAt              = datetime.fromisoformat(data['updated_at']) if 'updated_at' in data else None,
+        )

src/Entities/Reports/ReportFilters.py

@@ -1,8 +1,9 @@
-from __future__      import annotations
-from dataclasses     import dataclass
-from .ReportName     import ReportName
-from .ReportOperator import ReportOperator
-from typing          import Union, Optional
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import Union, Optional
+
+from src.Entities.Reports.ReportName     import ReportName
+from src.Entities.Reports.ReportOperator import ReportOperator
 
 
 @dataclass

src/Entities/Shared/AddressPreview.py

@@ -1,7 +1,8 @@
-from __future__   import annotations
-from .CountryCode import CountryCode
-from dataclasses  import dataclass
-from typing       import Optional
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import Optional
+
+from src.Entities.Shared.CountryCode import CountryCode
 
 
 @dataclass

src/Entities/Shared/BillingDetails.py

@@ -1,8 +1,9 @@
 from __future__  import annotations
-from .TimePeriod import TimePeriod
 from dataclasses import dataclass
 from typing      import Optional
 
+from src.Entities.Shared.TimePeriod import TimePeriod
+
 
 @dataclass
 class BillingDetails:

src/Entities/Shared/BillingDetailsUpdate.py

@@ -1,7 +1,8 @@
 from __future__  import annotations
-from .TimePeriod import TimePeriod
 from dataclasses import dataclass
 
+from src.Entities.Shared.TimePeriod import TimePeriod
+
 
 @dataclass
 class BillingDetailsUpdate:

src/Entities/Shared/Card.py

@@ -1,7 +1,8 @@
-from __future__                                   import annotations
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import Optional
+
 from src.Entities.Transactions.TransactionCardType import TransactionCardType
-from dataclasses                                  import dataclass
-from typing                                       import Optional
 
 
 @dataclass

src/Entities/Shared/ChargebackFee.py

@@ -1,8 +1,9 @@
 from __future__  import annotations
-from .Original   import Original
 from dataclasses import dataclass
 from typing      import Optional
 
+from src.Entities.Shared.Original import Original
+
 
 @dataclass
 class ChargebackFee:

src/Entities/Shared/ImportMeta.py

@@ -0,0 +1,17 @@
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import Optional
+
+
+@dataclass(frozen=True)
+class ImportMeta:
+    externalId:   Optional[str]
+    importedFrom: str
+
+
+    @classmethod
+    def from_dict(cls, data: dict) -> ImportMeta:
+        return ImportMeta(
+            externalId   = data.get('external_id'),
+            importedFrom = data['imported_from']
+        )

src/Entities/Shared/MetaPaginated.py

@@ -1,7 +1,8 @@
 from __future__  import annotations
-from .Pagination import Pagination
 from dataclasses import dataclass
 
+from src.Entities.Shared.Pagination import Pagination
+
 
 @dataclass
 class MetaPaginated:

src/Entities/Shared/MethodDetails.py

@@ -1,9 +1,10 @@
 from __future__  import annotations
-from .Card       import Card
-from .Type       import Type
 from dataclasses import dataclass
 from typing      import Optional
 
+from src.Entities.Shared.Card import Card
+from src.Entities.Shared.Type import Type
+
 
 @dataclass
 class MethodDetails:

src/Entities/Shared/Money.py

@@ -1,7 +1,8 @@
-from __future__    import annotations
-from .CurrencyCode import CurrencyCode
-from dataclasses   import dataclass
-from typing        import Optional
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import Optional
+
+from src.Entities.Shared.CurrencyCode import CurrencyCode
 
 
 @dataclass

src/Entities/Shared/Original.py

@@ -1,6 +1,7 @@
-from __future__               import annotations
-from .CurrencyCodeAdjustments import CurrencyCodeAdjustments
-from dataclasses              import dataclass
+from __future__  import annotations
+from dataclasses import dataclass
+
+from src.Entities.Shared.CurrencyCodeAdjustments import CurrencyCodeAdjustments
 
 
 @dataclass

src/Entities/Shared/PayoutTotalsAdjustment.py

@@ -1,8 +1,9 @@
-from __future__           import annotations
-from .ChargebackFee       import ChargebackFee
-from .CurrencyCodePayouts import CurrencyCodePayouts
-from dataclasses          import dataclass
-from typing               import Optional
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import Optional
+
+from src.Entities.Shared.ChargebackFee       import ChargebackFee
+from src.Entities.Shared.CurrencyCodePayouts import CurrencyCodePayouts
 
 
 @dataclass

src/Entities/Shared/TaxRatesUsed.py

@@ -1,7 +1,8 @@
 from __future__  import annotations
-from .Totals     import Totals
 from dataclasses import dataclass
 
+from src.Entities.Shared.Totals import Totals
+
 
 @dataclass
 class TaxRatesUsed:

src/Entities/Shared/TimePeriod.py

@@ -1,7 +1,8 @@
 from __future__  import annotations
-from .Interval   import Interval
 from dataclasses import dataclass
 
+from src.Entities.Shared.Interval import Interval
+
 
 @dataclass
 class TimePeriod:

src/Entities/Shared/TotalAdjustments.py

@@ -1,6 +1,7 @@
-from __future__    import annotations
-from .CurrencyCode import CurrencyCode
-from dataclasses   import dataclass
+from __future__  import annotations
+from dataclasses import dataclass
+
+from src.Entities.Shared.CurrencyCode import CurrencyCode
 
 
 @dataclass

src/Entities/Shared/TransactionDetailsPreview.py

@@ -1,9 +1,10 @@
-from __future__                  import annotations
-from .TaxRatesUsed               import TaxRatesUsed
-from .TransactionTotals          import TransactionTotals
-from .TransactionLineItemPreview import TransactionLineItemPreview
-from dataclasses                 import dataclass
-from typing                      import List
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import List
+
+from src.Entities.Shared.TaxRatesUsed               import TaxRatesUsed
+from src.Entities.Shared.TransactionLineItemPreview import TransactionLineItemPreview
+from src.Entities.Shared.TransactionTotals          import TransactionTotals
 
 
 @dataclass

src/Entities/Shared/TransactionLineItemPreview.py

@@ -1,9 +1,11 @@
-from __future__                       import annotations
-from .UnitTotals                      import UnitTotals
-from .Totals                          import Totals
-from dataclasses                      import dataclass
+from __future__  import annotations
+from dataclasses import dataclass
+
 from src.Entities.ProductWithIncludes import ProductWithIncludes
 
+from src.Entities.Shared.Totals     import Totals
+from src.Entities.Shared.UnitTotals import UnitTotals
+
 
 @dataclass
 class TransactionLineItemPreview:

src/Entities/Shared/TransactionPaymentAttempt.py

@@ -1,10 +1,11 @@
-from __future__            import annotations
-from .ErrorCode            import ErrorCode
-from .MethodDetails        import MethodDetails
-from .StatusPaymentAttempt import StatusPaymentAttempt
-from dataclasses           import dataclass
-from datetime              import datetime
-from typing                import Optional
+from __future__  import annotations
+from dataclasses import dataclass
+from datetime    import datetime
+from typing      import Optional
+
+from src.Entities.Shared.ErrorCode            import ErrorCode
+from src.Entities.Shared.MethodDetails        import MethodDetails
+from src.Entities.Shared.StatusPaymentAttempt import StatusPaymentAttempt
 
 
 @dataclass

src/Entities/Shared/TransactionPayoutTotals.py

@@ -1,7 +1,8 @@
-from __future__           import annotations
-from .CurrencyCodePayouts import CurrencyCodePayouts
-from dataclasses          import dataclass
-from typing               import Optional
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import Optional
+
+from src.Entities.Shared.CurrencyCodePayouts import CurrencyCodePayouts
 
 
 @dataclass

src/Entities/Shared/TransactionPayoutTotalsAdjusted.py

@@ -1,7 +1,8 @@
-from __future__           import annotations
-from .ChargebackFee       import ChargebackFee
-from .CurrencyCodePayouts import CurrencyCodePayouts
-from dataclasses          import dataclass
+from __future__  import annotations
+from dataclasses import dataclass
+
+from src.Entities.Shared.ChargebackFee       import ChargebackFee
+from src.Entities.Shared.CurrencyCodePayouts import CurrencyCodePayouts
 
 
 @dataclass

src/Entities/Shared/TransactionTotals.py

@@ -1,7 +1,8 @@
-from __future__    import annotations
-from .CurrencyCode import CurrencyCode
-from dataclasses   import dataclass
-from typing        import Optional
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import Optional
+
+from src.Entities.Shared.CurrencyCode import CurrencyCode
 
 
 @dataclass

src/Entities/Shared/TransactionTotalsAdjusted.py

@@ -1,7 +1,8 @@
-from __future__    import annotations
-from .CurrencyCode import CurrencyCode
-from dataclasses   import dataclass
-from typing        import Optional
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import Optional
+
+from src.Entities.Shared.CurrencyCode import CurrencyCode
 
 
 @dataclass

src/Entities/Shared/UnitPriceOverride.py

@@ -1,8 +1,9 @@
-from __future__   import annotations
-from .CountryCode import CountryCode
-from .Money       import Money
-from dataclasses  import dataclass
-from typing       import List
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import List
+
+from src.Entities.Shared.CountryCode import CountryCode
+from src.Entities.Shared.Money       import Money
 
 
 @dataclass

src/Entities/Subscriptions/SubscriptionDetails.py

@@ -1,12 +1,14 @@
-from __future__                                          import annotations
-from .SubscriptionTransactionLineItem                    import SubscriptionTransactionLineItem
-from dataclasses                                         import dataclass
+from __future__  import annotations
+from dataclasses import dataclass
+from typing      import List
+
 from src.Entities.Shared.TaxRatesUsed                    import TaxRatesUsed
-from src.Entities.Shared.TransactionTotals               import TransactionTotals
-from src.Entities.Shared.TransactionTotalsAdjusted       import TransactionTotalsAdjusted
 from src.Entities.Shared.TransactionPayoutTotals         import TransactionPayoutTotals
 from src.Entities.Shared.TransactionPayoutTotalsAdjusted import TransactionPayoutTotalsAdjusted
-from typing                                              import List
+from src.Entities.Shared.TransactionTotals               import TransactionTotals
+from src.Entities.Shared.TransactionTotalsAdjusted       import TransactionTotalsAdjusted
+
+from src.Entities.Subscriptions.SubscriptionTransactionLineItem import SubscriptionTransactionLineItem
 
 
 @dataclass