paddle-python-sdk 1.3.0__py3-none-any.whl → 1.4.0__py3-none-any.whl

paddle_billing/Client.py

@@ -204,7 +204,7 @@ class Client:
                 "Authorization": f"Bearer {self.__api_key}",
                 "Content-Type": "application/json",
                 "Paddle-Version": str(self.use_api_version),
-                "User-Agent": "PaddleSDK/python 1.3.0",
+                "User-Agent": "PaddleSDK/python 1.4.0",
             }
         )
 

paddle_billing/Entities/Adjustment.py

@@ -53,5 +53,5 @@ class Adjustment(Entity):
             ),
             updated_at=datetime.fromisoformat(data["updated_at"]) if data.get("updated_at") else None,
             tax_rates_used=[AdjustmentTaxRatesUsed.from_dict(item) for item in data["tax_rates_used"]],
-            type=AdjustmentStatus(data["type"]),
+            type=AdjustmentActionType(data["type"]),
         )

paddle_billing/Entities/Subscriptions/SubscriptionOnResume.py

@@ -0,0 +1,6 @@
+from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
+
+
+class SubscriptionOnResume(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
+    ContinueExistingBillingPeriod: "SubscriptionOnResume" = "continue_existing_billing_period"
+    StartNewBillingPeriod: "SubscriptionOnResume" = "start_new_billing_period"

paddle_billing/Entities/Subscriptions/__init__.py

@@ -9,6 +9,7 @@ from paddle_billing.Entities.Subscriptions.SubscriptionItemStatus import Subscri
 from paddle_billing.Entities.Subscriptions.SubscriptionManagementUrls import SubscriptionManagementUrls
 from paddle_billing.Entities.Subscriptions.SubscriptionNextTransaction import SubscriptionNextTransaction
 from paddle_billing.Entities.Subscriptions.SubscriptionOnPaymentFailure import SubscriptionOnPaymentFailure
+from paddle_billing.Entities.Subscriptions.SubscriptionOnResume import SubscriptionOnResume
 from paddle_billing.Entities.Subscriptions.SubscriptionPreviewSubscriptionUpdateSummary import (
     SubscriptionPreviewSubscriptionUpdateSummary,
 )

paddle_billing/Resources/Subscriptions/Operations/PauseSubscription.py

@@ -2,10 +2,12 @@ from dataclasses import dataclass
 
 from paddle_billing.Operation import Operation
 from paddle_billing.Entities.DateTime import DateTime
-from paddle_billing.Entities.Subscriptions import SubscriptionEffectiveFrom
+from paddle_billing.Entities.Subscriptions import SubscriptionEffectiveFrom, SubscriptionOnResume
+from paddle_billing.Undefined import Undefined
 
 
 @dataclass
 class PauseSubscription(Operation):
     effective_from: SubscriptionEffectiveFrom | None = None
     resume_at: DateTime | None = None
+    on_resume: SubscriptionOnResume | Undefined = Undefined()

paddle_billing/Resources/Subscriptions/Operations/ResumeSubscription.py

@@ -2,9 +2,11 @@ from dataclasses import dataclass
 
 from paddle_billing.Operation import Operation
 from paddle_billing.Entities.DateTime import DateTime
-from paddle_billing.Entities.Subscriptions import SubscriptionResumeEffectiveFrom
+from paddle_billing.Entities.Subscriptions import SubscriptionResumeEffectiveFrom, SubscriptionOnResume
+from paddle_billing.Undefined import Undefined
 
 
 @dataclass
 class ResumeSubscription(Operation):
     effective_from: SubscriptionResumeEffectiveFrom | DateTime | None = None
+    on_resume: SubscriptionOnResume | Undefined = Undefined()

{paddle_python_sdk-1.3.0.dist-info → paddle_python_sdk-1.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: paddle-python-sdk
-Version: 1.3.0
+Version: 1.4.0
 Summary: Paddle's Python SDK for Paddle Billing
 Home-page: https://developer.paddle.com/api-reference/overview
 Author: Paddle and contributors

{paddle_python_sdk-1.3.0.dist-info → paddle_python_sdk-1.4.0.dist-info}/RECORD

@@ -5,7 +5,7 @@ examples/event_polling.py,sha256=580dg_8CFrSCA89Mr1ny4V1gtB3-hk-LfePTbI7DT5w,217
 examples/get_products.py,sha256=4V7ZG1SH6Oxojufbtzm_TMySw4cOBMQ99mgQK_hlwFQ,1875
 examples/logger.py,sha256=AxmQmMrsM0ZqMIUnh6iARiczL4S4F9OqQcOu-67owNg,1042
 examples/webhook_verification.py,sha256=qkNscNdNZUAgxEIk83tCiljN2VmfePZ_k8zTliKz2QY,1205
-paddle_billing/Client.py,sha256=gnIKpgFX6ZJovgAqnjh9a91Tw3Cpt-6NgFm3I5xExLE,8787
+paddle_billing/Client.py,sha256=s41MahuyVwWk82lkbMuPSxo0PASfoyIC5cNzqjFYdpg,8787
 paddle_billing/EnumStringify.py,sha256=iDvKULZat3jx9A-_PhvoN6CbFGf2pyxrQeYZxqX9n8M,48
 paddle_billing/Environment.py,sha256=sY4nrJUwlTugsZKncieAnvfCojqCcKWi4X7rFzjFeSQ,417
 paddle_billing/FiltersNone.py,sha256=HxjE6RJb7sy6txphpZSrCTQZt1Ua0XpIz8NDLHC43zo,268
@@ -19,7 +19,7 @@ paddle_billing/ResponseParser.py,sha256=DbbEnVLflzzKiulbtb56Rx7FLEx9Vxe08p1RQRXa
 paddle_billing/Undefined.py,sha256=NJKVAEGbTBDfnfaAS6Vn_pSHmHDGbIS277gVScuB2A8,26
 paddle_billing/__init__.py,sha256=x-mRXflhzomHZamB-g1HflsqW2WSYDo-PpPkhyPlAWA,178
 paddle_billing/Entities/Address.py,sha256=KPnvFIN9S-DX-Y72x9WZScLV-s5vur1Wn1QT2YsS3KI,1500
-paddle_billing/Entities/Adjustment.py,sha256=OtYk2iukRx1S1D_P_IBB5XwW-LjYUI1bmTghVz-gG44,2096
+paddle_billing/Entities/Adjustment.py,sha256=5d9DXhyahb8tlRe5ywMI0ueq5kfGkfbpO__mVemlcp8,2100
 paddle_billing/Entities/AdjustmentCreditNote.py,sha256=nMXkYk4hDyxv4Oaw0iFgslmgMksGwFyoH2wQXiVchOs,305
 paddle_billing/Entities/Business.py,sha256=wlnAd_lC0Fuw7_BHKZGHt8q-aeLYO6MjO92EYedRnmo,1331
 paddle_billing/Entities/CreditBalance.py,sha256=aGCsfSf-qZl6kVTfHd41_1raiNuI29picji-bj7-lvg,673
@@ -179,6 +179,7 @@ paddle_billing/Entities/Subscriptions/SubscriptionItemStatus.py,sha256=vzrvLhi_g
 paddle_billing/Entities/Subscriptions/SubscriptionManagementUrls.py,sha256=7HtoU9nfuPBvShggLTqaJeI7Fi3pMow9DZA81yxI6GQ,407
 paddle_billing/Entities/Subscriptions/SubscriptionNextTransaction.py,sha256=493Wyw4A9CxPQy3S1HnQMY6WkfU8QLQyhVyaZFZCRnI,905
 paddle_billing/Entities/Subscriptions/SubscriptionOnPaymentFailure.py,sha256=RH18bZ_n4HZQBeY6I14ZOJ41iaFCEk54SCqKlQ6r8bY,290
+paddle_billing/Entities/Subscriptions/SubscriptionOnResume.py,sha256=4eBwsExVsRyLSb7Fx72ZAz1jScBdba0ZkRb7wwFV8Qs,322
 paddle_billing/Entities/Subscriptions/SubscriptionPreviewSubscriptionUpdateSummary.py,sha256=GYtBaDUco68X7TfjLczbJ-SFQgYUx9POtCv_Z4tWAEQ,856
 paddle_billing/Entities/Subscriptions/SubscriptionProrationBillingMode.py,sha256=KO2a9asbDMLS5B_WhK237OUGhtzzw1ZXRrBvgSuEtok,578
 paddle_billing/Entities/Subscriptions/SubscriptionResult.py,sha256=UF4dY0xd4FooSMXOAcl4fB1CDDFIp_ExptlRMbLzCOc,627
@@ -187,7 +188,7 @@ paddle_billing/Entities/Subscriptions/SubscriptionResumeEffectiveFrom.py,sha256=
 paddle_billing/Entities/Subscriptions/SubscriptionScheduledChange.py,sha256=tYcsIw7YX-x8CypKeg8d40twc2HqofgTaRMJfLwOWFA,746
 paddle_billing/Entities/Subscriptions/SubscriptionScheduledChangeAction.py,sha256=Ds4S96Bgw-1hH3WAroX2JE_RM1JBEb0YEfJMtl9Umwo,336
 paddle_billing/Entities/Subscriptions/SubscriptionStatus.py,sha256=IC3auB11tT5CZ8_QZbvFTcCDUjhKysDofz_yUMfLUbA,425
-paddle_billing/Entities/Subscriptions/__init__.py,sha256=C0Fv8z9Xrl97KJdYsdr6eI8_2OIh6kK5w-a4ePMkxfY,1961
+paddle_billing/Entities/Subscriptions/__init__.py,sha256=wExUC55cS8KftnoCQokEJ1Tt3pb1MmHNJQqLx9oyc5w,2053
 paddle_billing/Entities/Transactions/TransactionAdjustmentsTotals.py,sha256=lM_3SKojGmcOVBiCRFMC7iHEBKEhlzFH58RHrZ7UlPA,867
 paddle_billing/Entities/Transactions/TransactionBreakdown.py,sha256=TNLicqHrtFqG1V8EqqUT2ekxLBxf0wqdMWLhKbwlg0g,396
 paddle_billing/Entities/Transactions/TransactionCardType.py,sha256=BMSDuiSXSovrtQ7Rq5oYGbE3JueLuow0kD8UgEYJbPc,632
@@ -492,10 +493,10 @@ paddle_billing/Resources/Subscriptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JC
 paddle_billing/Resources/Subscriptions/Operations/CancelSubscription.py,sha256=wELZweZ54xSzXis6OUjgzPumsqrW5I9F8uAEP2_37KY,261
 paddle_billing/Resources/Subscriptions/Operations/CreateOneTimeCharge.py,sha256=vbzsE2IxfE_NlxRysppfL9Srseb8flWWXq_KVJNud3o,638
 paddle_billing/Resources/Subscriptions/Operations/ListSubscriptions.py,sha256=MZWegWXn55sg-S8ANcT62c5YEN9LxGq9KifrBCJWn6Q,2882
-paddle_billing/Resources/Subscriptions/Operations/PauseSubscription.py,sha256=kLqua4o_Ub5v9ND6kqtfSd6XTYe0FpO9qitDWup-8UY,359
+paddle_billing/Resources/Subscriptions/Operations/PauseSubscription.py,sha256=AZTjFBo7DtqYMCDl55YSfZ8atfqF9yfYgy_SCgUX1rg,490
 paddle_billing/Resources/Subscriptions/Operations/PreviewOneTimeCharge.py,sha256=6VK7z1afrr0clTzXbNLWczn0eSbD7WlcVosD8QVck2g,639
 paddle_billing/Resources/Subscriptions/Operations/PreviewUpdateSubscription.py,sha256=NGxJyetafIorxQUgjbH78Bd46QiFsZqs3TjWfDw1wZc,1487
-paddle_billing/Resources/Subscriptions/Operations/ResumeSubscription.py,sha256=zbF4Tg9salUb-_CnJyRWCz8vy0_IwJ52i-zern0SgU0,345
+paddle_billing/Resources/Subscriptions/Operations/ResumeSubscription.py,sha256=jGpbhmQn-dxhELKaxeNiX_h4v7HfenhONWm2T6zsm5Q,476
 paddle_billing/Resources/Subscriptions/Operations/UpdateSubscription.py,sha256=fT1hmyOOBHMcT5lBMBt-RCcvjZoZygwIONWC4xSthBA,1480
 paddle_billing/Resources/Subscriptions/Operations/__init__.py,sha256=BBatMoIegcdt7q5fnY-ldXeDhZul9PpjlOuOqgf3MFg,1035
 paddle_billing/Resources/Subscriptions/Operations/Charge/SubscriptionChargeItem.py,sha256=YX6HoDJsMFkejOonfiCxR6jkt0UWr-n4364T7NEeRUY,148
@@ -549,7 +550,7 @@ tests/Functional/Resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJ
 tests/Functional/Resources/Addresses/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/Functional/Resources/Addresses/test_AddressesClient.py,sha256=mxiSJgvegEpuqKeNMZeSlujih5XLVvRZ5Hw8J_J0Jhk,16204
 tests/Functional/Resources/Adjustments/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/Functional/Resources/Adjustments/test_AdjustmentsClient.py,sha256=6Z8NOEkRJBB4kc9oVYh9cfGs51a3Sc6Ls7jwX-9JCkE,17157
+tests/Functional/Resources/Adjustments/test_AdjustmentsClient.py,sha256=5pfezgaaiz0fykofnXWFCZA4sTj7UIhfedj9b0n1fUQ,17332
 tests/Functional/Resources/Businesses/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/Functional/Resources/Businesses/test_BusinessesClient.py,sha256=uUAydFqmXq3snmu--gGVI5nNrpg6oySQM_Ulg9q-G1Q,12727
 tests/Functional/Resources/CustomerPortalSessions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -581,7 +582,7 @@ tests/Functional/Resources/Products/test_ProductsClient.py,sha256=FlYIjv09RM4rJt
 tests/Functional/Resources/Reports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/Functional/Resources/Reports/test_ReportsClient.py,sha256=jIOHBQ3YSw0rXrOKxlhIUGtqptUZMBWsMJHBwlhjOxg,13438
 tests/Functional/Resources/Subscriptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/Functional/Resources/Subscriptions/test_SubscriptionsClient.py,sha256=9TW7z378xzu-JBTuPkOGY_CThzwQC7P97XYl-PK48bg,61719
+tests/Functional/Resources/Subscriptions/test_SubscriptionsClient.py,sha256=_QNeQ_5hk4sGQyAHpaD43t8z0zlkvZ9xYpdVlfyJanI,64187
 tests/Functional/Resources/Transactions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/Functional/Resources/Transactions/test_TransactionsClient.py,sha256=K3t47sr-HdqPosSXsERsjIGKhbxuWvP2pAdvBD_vLt4,59187
 tests/Unit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -596,8 +597,8 @@ tests/Utils/ReadsFixture.py,sha256=M3Ot3xHXp_C7vwttna9deLPHBAO8ml2Jb4thhHOJJ38,1
 tests/Utils/TestClient.py,sha256=-wc7hJMuR6WC-ukw0c7I59b5-8hj_-nzq__-2M81elg,1453
 tests/Utils/TestLogger.py,sha256=pFO9x711buRmg-8DAqpzIJP_hr21JPty1_ZQRcwoGKk,554
 tests/Utils/__init__.py,sha256=JtqJNPKqbNZ9exlpXlF3yj_9cfylPGlvopjQYi7yYTA,37
-paddle_python_sdk-1.3.0.dist-info/LICENSE,sha256=e5Sn9mzCdpjnqCLxXpGHNKdYB6JlRSTLhN_CD4WSO6w,10770
-paddle_python_sdk-1.3.0.dist-info/METADATA,sha256=yK1BhTY6dJEFsWrr6EwLY8l2TbDn015N4-n2e1Q4RhQ,7376
-paddle_python_sdk-1.3.0.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-paddle_python_sdk-1.3.0.dist-info/top_level.txt,sha256=9a07VPng7o5wK8VAXkl6NC30xrNbW9zff_02jHyHi4c,30
-paddle_python_sdk-1.3.0.dist-info/RECORD,,
+paddle_python_sdk-1.4.0.dist-info/LICENSE,sha256=e5Sn9mzCdpjnqCLxXpGHNKdYB6JlRSTLhN_CD4WSO6w,10770
+paddle_python_sdk-1.4.0.dist-info/METADATA,sha256=v5XdgkA3RwFqUu-nIBHqmC90ejpEwaarn__0BsMx0Qk,7376
+paddle_python_sdk-1.4.0.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+paddle_python_sdk-1.4.0.dist-info/top_level.txt,sha256=9a07VPng7o5wK8VAXkl6NC30xrNbW9zff_02jHyHi4c,30
+paddle_python_sdk-1.4.0.dist-info/RECORD,,

tests/Functional/Resources/Adjustments/test_AdjustmentsClient.py

@@ -177,6 +177,9 @@ class TestAdjustmentsClient:
         )
 
         assert isinstance(response, Adjustment)
+        assert isinstance(response.action, Action)
+        assert isinstance(response.status, AdjustmentStatus)
+        assert isinstance(response.type, AdjustmentActionType)
 
         tax_rates_used = response.tax_rates_used[0]
         assert isinstance(tax_rates_used, AdjustmentTaxRatesUsed)

tests/Functional/Resources/Subscriptions/test_SubscriptionsClient.py

@@ -26,6 +26,7 @@ from paddle_billing.Entities.Shared import (
 from paddle_billing.Entities.Subscriptions import (
     SubscriptionEffectiveFrom,
     SubscriptionOnPaymentFailure,
+    SubscriptionOnResume,
     SubscriptionProrationBillingMode,
     SubscriptionResumeEffectiveFrom,
     SubscriptionScheduledChangeAction,
@@ -516,11 +517,37 @@ class TestSubscriptionsClient:
                 ReadsFixtures.read_raw_json_fixture("response/full_entity"),
                 "/subscriptions/sub_01h8bx8fmywym11t6swgzba704/pause",
             ),
+            (
+                "sub_01h8bx8fmywym11t6swgzba704",
+                PauseSubscription(
+                    SubscriptionEffectiveFrom.NextBillingPeriod,
+                    DateTime("2023-10-09T16:30:00Z"),
+                    SubscriptionOnResume.ContinueExistingBillingPeriod,
+                ),
+                ReadsFixtures.read_raw_json_fixture("request/pause_resume_existing_billing_period"),
+                200,
+                ReadsFixtures.read_raw_json_fixture("response/full_entity"),
+                "/subscriptions/sub_01h8bx8fmywym11t6swgzba704/pause",
+            ),
+            (
+                "sub_01h8bx8fmywym11t6swgzba704",
+                PauseSubscription(
+                    SubscriptionEffectiveFrom.NextBillingPeriod,
+                    DateTime("2023-10-09T16:30:00Z"),
+                    SubscriptionOnResume.StartNewBillingPeriod,
+                ),
+                ReadsFixtures.read_raw_json_fixture("request/pause_resume_new_billing_period"),
+                200,
+                ReadsFixtures.read_raw_json_fixture("response/full_entity"),
+                "/subscriptions/sub_01h8bx8fmywym11t6swgzba704/pause",
+            ),
         ],
         ids=[
             "Pause subscription",
             "Pause subscription as of next billing period",
             "Pause subscription as of next billing period and resume at date",
+            "Pause subscription resume in existing billing period",
+            "Pause subscription resume in new billing period",
         ],
     )
     def test_pause_subscription_uses_expected_payload(
@@ -583,11 +610,33 @@ class TestSubscriptionsClient:
                 ReadsFixtures.read_raw_json_fixture("response/full_entity"),
                 "/subscriptions/sub_01h8bx8fmywym11t6swgzba704/resume",
             ),
+            (
+                "sub_01h8bx8fmywym11t6swgzba704",
+                ResumeSubscription(
+                    SubscriptionResumeEffectiveFrom.Immediately, SubscriptionOnResume.ContinueExistingBillingPeriod
+                ),
+                ReadsFixtures.read_raw_json_fixture("request/resume_existing_billing_period"),
+                200,
+                ReadsFixtures.read_raw_json_fixture("response/full_entity"),
+                "/subscriptions/sub_01h8bx8fmywym11t6swgzba704/resume",
+            ),
+            (
+                "sub_01h8bx8fmywym11t6swgzba704",
+                ResumeSubscription(
+                    SubscriptionResumeEffectiveFrom.Immediately, SubscriptionOnResume.StartNewBillingPeriod
+                ),
+                ReadsFixtures.read_raw_json_fixture("request/resume_new_billing_period"),
+                200,
+                ReadsFixtures.read_raw_json_fixture("response/full_entity"),
+                "/subscriptions/sub_01h8bx8fmywym11t6swgzba704/resume",
+            ),
         ],
         ids=[
             "Resume subscription",
             "Resume subscription with a billing period",
             "Resume subscription with a new date",
+            "Resume subscription in existing billing period",
+            "Resume subscription in new billing period",
         ],
     )
     def test_resume_subscription_uses_expected_payload(