Add Customer.subscriptions and mark CustomerSubscription.list_imported as deprecated

[wscourge]

• Added deprecation warning to Subscription.list_imported() method
• Added CustomerSubscription import to customer module
• Updated tests to use correct imports and assertions

[Copilot]

Pull request overview

This PR deprecates CustomerSubscription.list_imported() in favor of a new Customer.subscriptions() method and updates documentation examples to use correct field names.

• Adds new Customer.subscriptions() method for retrieving customer subscriptions
• Marks CustomerSubscription.list_imported() as deprecated with a warning
• Corrects field names from external_id to uuid in subscription connection examples

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File	Description
chartmogul/api/customer.py	Adds new Customer.subscriptions() method
chartmogul/api/customers/subscription.py	Implements deprecation warning for list_imported() method
test/api/test_customer.py	Adds test coverage for new subscriptions() method and updates field names in existing tests
README.md	Documents new subscriptions() method and corrects field names in examples

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[loomchild]

Overall, LGTM, but I have some trouble testing it. Please provide testing instructions and which environment to use.

[loomchild]

I get the following error in production, am I doing something wrong?

customer.subscriptions(config).get()

requests.exceptions.HTTPError: 400 Client Error: Bad Request for url: https://api.chartmogul.com/v1/customers//subscriptions

[wscourge]

It is documented in the README. Same as other methods that require uuid in the URL, it requires passing it:

>>> customer = Customer.retrieve(config, uuid='cus_c9352490-8d66-403c-90c5-01663aae2959').get()
>>> customer.subscriptions(config, uuid='cus_c9352490-8d66-403c-90c5-01663aae2959').get()
Subscriptions(entries=[<CustomerSubscription{arr=217200, billing_cycle='year', billing_cycle_count=1, currency='PLN', currency_sign='zł', end_date=datetime.datetime(2026, 11, 23, 17, 51, 44, tzinfo=UTC), external_id='cbdemo_ZpbKpmKUbu83EsNv', id=5322874574, mrr=18100, plan='Professional Suite Annual(cbdemo_omnisupport-solutions)', quantity=1, start_date=datetime.datetime(2024, 11, 22, 17, 51, 46, tzinfo=UTC), status='active', subscription_set_external_id='cbdemo_ZpbKpmKUbu83EsNv', uuid='8d80f275-a494-4957-8968-6cb68acdcfab'}>, <CustomerSubscription{arr=108576, billing_cycle='year', billing_cycle_count=1, currency='PLN', currency_sign='zł', end_date=datetime.datetime(2026, 11, 23, 17, 51, 44, tzinfo=UTC), external_id='cbdemo_ZpbKpmKUbu83EsNv_cbdemo_workforce-optimizer-addon-annual', id=5322874575, mrr=9048, plan='Workforce Optimizer Add-on Annual(cbdemo_omnisupport-solutions)', quantity=1, start_date=datetime.datetime(2024, 11, 22, 17, 51, 46, tzinfo=UTC), status='active', subscription_set_external_id='cbdemo_ZpbKpmKUbu83EsNv', uuid='77867070-2435-4da1-8bde-014f6817bd49'}>, <CustomerSubscription{arr=233184, billing_cycle='month', billing_cycle_count=1, currency='PLN', currency_sign='zł', end_date=datetime.datetime(2026, 1, 11, 14, 9, 32, tzinfo=UTC), external_id='169vEGV551MI2J0', id=5322874576, mrr=19432, plan='Professional Suite Monthly(cbdemo_omnisupport-solutions)', quantity=1, start_date=datetime.datetime(2025, 12, 11, 14, 9, 32, tzinfo=UTC), status='active', subscription_set_external_id='169vEGV551MI2J0', uuid='a8640a5a-0d43-41c7-803e-76fc042267b0'}>], has_more=False, cursor='c3Vic2NyaXB0aW9uc19uZXh0X3BhZ2U9Mg==')

[loomchild]

This works. Maybe also worth updating the README.

[wscourge]

There is a README.md update, I added this comment:

# DEPRECATED: use chartmogul.Customer.subscriptions() instead

Do you have anything else in mind?