Merge pull request #97 from gocardless/template-changes

Template changes
gocardless · Aug 6, 2024 · 08df1ba · 08df1ba
2 parents 89ffc32 + 49ce5a1
commit 08df1ba
Show file tree

Hide file tree

Showing 44 changed files with 393 additions and 73 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,4 +1,8 @@
 <!-- @format -->
+# 1.53.0
+
+- Added `/exports` APIs and added `exports` as a new event type available for Embed merchants
+
 # 1.52.0
 
 - Added new endpoints `/branding/logos` and `/branding/payer_themes` available for Embed merchants

diff --git a/README.rst b/README.rst
@@ -315,6 +315,20 @@ Events
     # Get a single event
     client.events.get('EV123', params={...})
 
+Exports
+''''''''''''''''''''''''''''''''''''''''''
+
+.. code:: python
+
+    # Get a single export
+    client.exports.get('EX123', params={...})
+
+    # List exports
+    client.exports.list(params={...})
+
+    # Iterate through all exports
+    client.exports.all(params={...})
+
 Instalment schedules
 ''''''''''''''''''''''''''''''''''''''''''
 

diff --git a/gocardless_pro/__init__.py b/gocardless_pro/__init__.py
@@ -2,5 +2,5 @@
 
 from .client import Client
 
-__version__ = '1.52.0'
+__version__ = '1.53.0'
 
diff --git a/gocardless_pro/api_client.py b/gocardless_pro/api_client.py
@@ -150,7 +150,7 @@ def _default_headers(self):
             'Authorization': 'Bearer {0}'.format(self.access_token),
             'Content-Type': 'application/json',
             'GoCardless-Client-Library': 'gocardless-pro-python',
-            'GoCardless-Client-Version': '1.52.0',
+            'GoCardless-Client-Version': '1.53.0',
             'User-Agent': self._user_agent(),
             'GoCardless-Version': '2015-07-06',
         }
@@ -159,7 +159,7 @@ def _user_agent(self):
         python_version = '.'.join(platform.python_version_tuple()[0:2])
         vm_version = '{}.{}.{}-{}{}'.format(*sys.version_info)
         return ' '.join([
-            'gocardless-pro-python/1.52.0',
+            'gocardless-pro-python/1.53.0',
             'python/{0}'.format(python_version),
             '{0}/{1}'.format(platform.python_implementation(), vm_version),
             '{0}/{1}'.format(platform.system(), platform.release()),

diff --git a/gocardless_pro/client.py b/gocardless_pro/client.py
@@ -89,6 +89,10 @@ def customer_notifications(self):
     def events(self):
         return services.EventsService(self._api_client, 3, 0.5, self._raise_on_idempotency_conflict)
 
+    @property
+    def exports(self):
+        return services.ExportsService(self._api_client, 3, 0.5, self._raise_on_idempotency_conflict)
+
     @property
     def instalment_schedules(self):
         return services.InstalmentSchedulesService(self._api_client, 3, 0.5, self._raise_on_idempotency_conflict)

diff --git a/gocardless_pro/resources/__init__.py b/gocardless_pro/resources/__init__.py
@@ -29,6 +29,8 @@
 
 from .event import Event
 
+from .export import Export
+
 from .instalment_schedule import InstalmentSchedule
 
 from .institution import Institution

diff --git a/gocardless_pro/resources/billing_request.py b/gocardless_pro/resources/billing_request.py
@@ -215,6 +215,10 @@ def links(self):
         def metadata(self):
             return self.attributes.get('metadata')
 
+        @property
+        def reference(self):
+            return self.attributes.get('reference')
+
         @property
         def scheme(self):
             return self.attributes.get('scheme')

diff --git a/gocardless_pro/resources/export.py b/gocardless_pro/resources/export.py
@@ -0,0 +1,54 @@
+# WARNING: Do not edit by hand, this file was generated by Crank:
+#
+#   https://github.com/gocardless/crank
+#
+
+class Export(object):
+    """A thin wrapper around a export, providing easy access to its
+    attributes.
+
+    Example:
+      export = client.exports.get()
+      export.id
+    """
+
+    def __init__(self, attributes, api_response):
+        self.attributes = attributes
+        self.api_response = api_response
+
+    @property
+    def created_at(self):
+        return self.attributes.get('created_at')
+
+
+    @property
+    def currency(self):
+        return self.attributes.get('currency')
+
+
+    @property
+    def download_url(self):
+        return self.attributes.get('download_url')
+
+
+    @property
+    def export_type(self):
+        return self.attributes.get('export_type')
+
+
+    @property
+    def id(self):
+        return self.attributes.get('id')
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/gocardless_pro/resources/subscription.py b/gocardless_pro/resources/subscription.py
@@ -91,6 +91,11 @@ def name(self):
         return self.attributes.get('name')
 
 
+    @property
+    def parent_plan_paused(self):
+        return self.attributes.get('parent_plan_paused')
+
+
     @property
     def payment_reference(self):
         return self.attributes.get('payment_reference')
@@ -167,4 +172,6 @@ def mandate(self):
 
 
 
+
+
 
diff --git a/gocardless_pro/services/__init__.py b/gocardless_pro/services/__init__.py
@@ -16,6 +16,7 @@
 from .customer_bank_accounts_service import CustomerBankAccountsService
 from .customer_notifications_service import CustomerNotificationsService
 from .events_service import EventsService
+from .exports_service import ExportsService
 from .instalment_schedules_service import InstalmentSchedulesService
 from .institutions_service import InstitutionsService
 from .logos_service import LogosService

diff --git a/gocardless_pro/services/exports_service.py b/gocardless_pro/services/exports_service.py
@@ -0,0 +1,66 @@
+# WARNING: Do not edit by hand, this file was generated by Crank:
+#
+#   https://github.com/gocardless/crank
+#
+
+from . import base_service
+from .. import resources
+from ..paginator import Paginator
+from .. import errors
+
+class ExportsService(base_service.BaseService):
+    """Service class that provides access to the exports
+    endpoints of the GoCardless Pro API.
+    """
+
+    RESOURCE_CLASS = resources.Export
+    RESOURCE_NAME = 'exports'
+
+
+    def get(self,identity,params=None, headers=None):
+        """Get a single export.
+
+        Returns a single export.
+
+        Args:
+              identity (string): Unique identifier, beginning with "EX".
+              params (dict, optional): Query string parameters.
+
+        Returns:
+              Export
+        """
+        path = self._sub_url_params('/exports/:identity', {
+
+            'identity': identity,
+          })
+
+
+        response = self._perform_request('GET', path, params, headers,
+                                         retry_failures=True)
+        return self._resource_for(response)
+
+
+    def list(self,params=None, headers=None):
+        """List exports.
+
+        Returns a list of exports which are available for download.
+
+        Args:
+              params (dict, optional): Query string parameters.
+
+        Returns:
+              ListResponse of Export instances
+        """
+        path = '/exports'
+
+
+        response = self._perform_request('GET', path, params, headers,
+                                         retry_failures=True)
+        return self._resource_for(response)
+
+    def all(self, params=None):
+        if params is None:
+            params = {}
+        return Paginator(self, params)
+
+
diff --git a/gocardless_pro/services/logos_service.py b/gocardless_pro/services/logos_service.py
@@ -22,6 +22,12 @@ def create_for_creditor(self,params=None, headers=None):
 
         Creates a new logo associated with a creditor. If a creditor already
         has a logo, this will update the existing logo linked to the creditor.
+        
+        We support JPG and PNG formats. Your logo will be scaled to a maximum
+        of 300px by 40px. For more guidance on how to upload logos that will
+        look
+        great across your customer payment page and notification emails see
+        [here](https://developer.gocardless.com/gc-embed/setting-up-branding#tips_for_uploading_your_logo).
 
         Args:
               params (dict, optional): Request body.

diff --git a/setup.py b/setup.py
@@ -6,7 +6,7 @@
 
 setup(
     name = 'gocardless_pro',
-    version = '1.52.0',
+    version = '1.53.0',
     packages = find_packages(exclude=['tests']),
     install_requires = ['requests>=2.6', 'six'],
     author = 'GoCardless',

diff --git a/tests/client_test.py b/tests/client_test.py
@@ -56,6 +56,9 @@ def test_customer_notifications_returns_service():
 def test_events_returns_service():
     assert isinstance(client.events, services.EventsService)
 
+def test_exports_returns_service():
+    assert isinstance(client.exports, services.ExportsService)
+
 def test_instalment_schedules_returns_service():
     assert isinstance(client.instalment_schedules, services.InstalmentSchedulesService)
 

diff --git a/tests/fixtures/bank_authorisations.json b/tests/fixtures/bank_authorisations.json
@@ -3,12 +3,12 @@
     "method": "POST",
     "path_template": "/bank_authorisations",
     "url_params": [],
-    "body": {"bank_authorisations":{"authorisation_type":"example authorisation_type 8081","authorised_at":"2020-01-01T12:00:00.000Z","created_at":"2024-05-30T12:57:42.874Z","expires_at":"2024-05-30T12:57:42.874Z","id":"BAU123","last_visited_at":"2020-01-01T12:00:00.000Z","links":{"billing_request":"BRQ123","institution":"monzo"},"qr_code_url":"https://pay.gocardless.com/obauth/BAU123/qr_code","redirect_uri":"https://my-website.com/abc/callback","url":"https://pay.gocardless.com/obauth/BAU123"}}
+    "body": {"bank_authorisations":{"authorisation_type":"example authorisation_type 8081","authorised_at":"2020-01-01T12:00:00.000Z","created_at":"2024-08-06T08:55:22.049Z","expires_at":"2024-08-06T08:55:22.049Z","id":"BAU123","last_visited_at":"2020-01-01T12:00:00.000Z","links":{"billing_request":"BRQ123","institution":"monzo"},"qr_code_url":"https://pay.gocardless.com/obauth/BAU123/qr_code","redirect_uri":"https://my-website.com/abc/callback","url":"https://pay.gocardless.com/obauth/BAU123"}}
   },
   "get": {
     "method": "GET",
     "path_template": "/bank_authorisations/:identity",
     "url_params": ["BAU123"],
-    "body": {"bank_authorisations":{"authorisation_type":"example authorisation_type 7887","authorised_at":"2020-01-01T12:00:00.000Z","created_at":"2024-05-30T12:57:42.874Z","expires_at":"2024-05-30T12:57:42.874Z","id":"BAU123","last_visited_at":"2020-01-01T12:00:00.000Z","links":{"billing_request":"BRQ123","institution":"monzo"},"qr_code_url":"https://pay.gocardless.com/obauth/BAU123/qr_code","redirect_uri":"https://my-website.com/abc/callback","url":"https://pay.gocardless.com/obauth/BAU123"}}
+    "body": {"bank_authorisations":{"authorisation_type":"example authorisation_type 7887","authorised_at":"2020-01-01T12:00:00.000Z","created_at":"2024-08-06T08:55:22.049Z","expires_at":"2024-08-06T08:55:22.049Z","id":"BAU123","last_visited_at":"2020-01-01T12:00:00.000Z","links":{"billing_request":"BRQ123","institution":"monzo"},"qr_code_url":"https://pay.gocardless.com/obauth/BAU123/qr_code","redirect_uri":"https://my-website.com/abc/callback","url":"https://pay.gocardless.com/obauth/BAU123"}}
   }
 }
diff --git a/tests/fixtures/billing_request_flows.json b/tests/fixtures/billing_request_flows.json
@@ -3,12 +3,12 @@
     "method": "POST",
     "path_template": "/billing_request_flows",
     "url_params": [],
-    "body": {"billing_request_flows":{"authorisation_url":"https://monzo.com/abc-123-things","auto_fulfil":true,"created_at":"2024-05-30T12:57:42.880Z","customer_details_captured":true,"exit_uri":"https://my-website.com/abc/callback","expires_at":"2024-05-30T12:57:42.880Z","id":"BRF123","language":"en","links":{"billing_request":"BRQ123"},"lock_bank_account":false,"lock_currency":false,"lock_customer_details":true,"prefilled_bank_account":{"account_type":"savings"},"prefilled_customer":{"address_line1":"221B Baker Street","address_line2":"Marylebone","address_line3":"City of Westminster","city":"London","company_name":"Hamilton Trading Ltd.","country_code":"GB","danish_identity_number":"220550-6218","email":"[email protected]","family_name":"Osborne","given_name":"Frank","postal_code":"NW1 6XE","region":"Greater London","swedish_identity_number":"556564-5404"},"redirect_uri":"https://my-website.com/abc/callback","session_token":"sesh_123","show_redirect_buttons":false,"show_success_redirect_button":true}}
+    "body": {"billing_request_flows":{"authorisation_url":"https://monzo.com/abc-123-things","auto_fulfil":true,"created_at":"2024-08-06T08:55:22.053Z","customer_details_captured":true,"exit_uri":"https://my-website.com/abc/callback","expires_at":"2024-08-06T08:55:22.053Z","id":"BRF123","language":"en","links":{"billing_request":"BRQ123"},"lock_bank_account":false,"lock_currency":true,"lock_customer_details":true,"prefilled_bank_account":{"account_type":"savings"},"prefilled_customer":{"address_line1":"221B Baker Street","address_line2":"Marylebone","address_line3":"City of Westminster","city":"London","company_name":"Hamilton Trading Ltd.","country_code":"GB","danish_identity_number":"220550-6218","email":"[email protected]","family_name":"Osborne","given_name":"Frank","postal_code":"NW1 6XE","region":"Greater London","swedish_identity_number":"556564-5404"},"redirect_uri":"https://my-website.com/abc/callback","session_token":"sesh_123","show_redirect_buttons":false,"show_success_redirect_button":false}}
   },
   "initialise": {
     "method": "POST",
     "path_template": "/billing_request_flows/:identity/actions/initialise",
     "url_params": ["BRF123"],
-    "body": {"billing_request_flows":{"authorisation_url":"https://monzo.com/abc-123-things","auto_fulfil":true,"created_at":"2024-05-30T12:57:42.880Z","customer_details_captured":true,"exit_uri":"https://my-website.com/abc/callback","expires_at":"2024-05-30T12:57:42.880Z","id":"BRF123","language":"en","links":{"billing_request":"BRQ123"},"lock_bank_account":true,"lock_currency":true,"lock_customer_details":true,"prefilled_bank_account":{"account_type":"savings"},"prefilled_customer":{"address_line1":"221B Baker Street","address_line2":"Marylebone","address_line3":"City of Westminster","city":"London","company_name":"Hamilton Trading Ltd.","country_code":"GB","danish_identity_number":"220550-6218","email":"[email protected]","family_name":"Osborne","given_name":"Frank","postal_code":"NW1 6XE","region":"Greater London","swedish_identity_number":"556564-5404"},"redirect_uri":"https://my-website.com/abc/callback","session_token":"sesh_123","show_redirect_buttons":true,"show_success_redirect_button":false}}
+    "body": {"billing_request_flows":{"authorisation_url":"https://monzo.com/abc-123-things","auto_fulfil":true,"created_at":"2024-08-06T08:55:22.053Z","customer_details_captured":true,"exit_uri":"https://my-website.com/abc/callback","expires_at":"2024-08-06T08:55:22.053Z","id":"BRF123","language":"en","links":{"billing_request":"BRQ123"},"lock_bank_account":true,"lock_currency":true,"lock_customer_details":false,"prefilled_bank_account":{"account_type":"savings"},"prefilled_customer":{"address_line1":"221B Baker Street","address_line2":"Marylebone","address_line3":"City of Westminster","city":"London","company_name":"Hamilton Trading Ltd.","country_code":"GB","danish_identity_number":"220550-6218","email":"[email protected]","family_name":"Osborne","given_name":"Frank","postal_code":"NW1 6XE","region":"Greater London","swedish_identity_number":"556564-5404"},"redirect_uri":"https://my-website.com/abc/callback","session_token":"sesh_123","show_redirect_buttons":true,"show_success_redirect_button":true}}
   }
 }