Bindings for Terminal endpoints (#478)

* Bindings for Terminal endpoints

* Handle lint and initial test failures

* Bump StripeMock version

.travis.yml

@@ -22,7 +22,7 @@ cache:
 env:
   global:
     # If changing this number, please also change it in `tests/conftest.py`.
-    - STRIPE_MOCK_VERSION=0.32.0
+    - STRIPE_MOCK_VERSION=0.33.0
 
 before_install:
   # Unpack and start stripe-mock so that the test suite can talk to it

stripe/__init__.py

@@ -29,6 +29,7 @@
 from stripe.api_resources import issuing  # noqa
 from stripe.api_resources import reporting  # noqa
 from stripe.api_resources import sigma  # noqa
+from stripe.api_resources import terminal # noqa
 
 # OAuth
 from stripe.oauth import OAuth  # noqa

stripe/api_resources/terminal/__init__.py

@@ -0,0 +1,7 @@
+from __future__ import absolute_import, division, print_function
+
+# flake8: noqa
+
+from stripe.api_resources.terminal.connection_token import ConnectionToken
+from stripe.api_resources.terminal.location import Location
+from stripe.api_resources.terminal.reader import Reader

stripe/api_resources/terminal/connection_token.py

@@ -0,0 +1,7 @@
+from __future__ import absolute_import, division, print_function
+
+from stripe.api_resources.abstract import CreateableAPIResource
+
+
+class ConnectionToken(CreateableAPIResource):
+    OBJECT_NAME = 'terminal.connection_token'

stripe/api_resources/terminal/location.py

@@ -0,0 +1,10 @@
+from __future__ import absolute_import, division, print_function
+
+from stripe.api_resources.abstract import CreateableAPIResource
+from stripe.api_resources.abstract import UpdateableAPIResource
+from stripe.api_resources.abstract import ListableAPIResource
+
+
+class Location(CreateableAPIResource, ListableAPIResource,
+               UpdateableAPIResource):
+    OBJECT_NAME = 'terminal.location'

stripe/api_resources/terminal/reader.py

@@ -0,0 +1,10 @@
+from __future__ import absolute_import, division, print_function
+
+from stripe.api_resources.abstract import CreateableAPIResource
+from stripe.api_resources.abstract import UpdateableAPIResource
+from stripe.api_resources.abstract import ListableAPIResource
+
+
+class Reader(CreateableAPIResource, ListableAPIResource,
+             UpdateableAPIResource):
+    OBJECT_NAME = 'terminal.reader'

stripe/util.py

@@ -214,6 +214,12 @@ def load_object_classes():
         api_resources.UsageRecord.OBJECT_NAME: api_resources.UsageRecord,
         api_resources.UsageRecordSummary.OBJECT_NAME:
             api_resources.UsageRecordSummary,
+        api_resources.terminal.Location.OBJECT_NAME:
+            api_resources.terminal.Location,
+        api_resources.terminal.ConnectionToken.OBJECT_NAME:
+            api_resources.terminal.ConnectionToken,
+        api_resources.terminal.Reader.OBJECT_NAME:
+            api_resources.terminal.Reader,
     }
 
 

tests/api_resources/terminal/test_connection_token.py

@@ -0,0 +1,16 @@
+from __future__ import absolute_import, division, print_function
+
+import stripe
+
+
+TEST_RESOURCE_ID = 'rdr_123'
+
+
+class TestConnectionToken(object):
+    def test_is_creatable(self, request_mock):
+        resource = stripe.terminal.ConnectionToken.create()
+        request_mock.assert_requested(
+            'post',
+            '/v1/terminal/connection_tokens'
+        )
+        assert isinstance(resource, stripe.terminal.ConnectionToken)

tests/api_resources/terminal/test_location.py

@@ -0,0 +1,64 @@
+from __future__ import absolute_import, division, print_function
+
+import stripe
+
+
+TEST_RESOURCE_ID = 'loc_123'
+
+
+class TestLocation(object):
+    def test_is_creatable(self, request_mock):
+        resource = stripe.terminal.Location.create(
+            display_name='name',
+            address={
+                'line1': 'line1',
+                'country': 'US',
+                'state': 'CA',
+                'postal_code': '12345',
+                'city': 'San Francisco',
+            }
+        )
+        request_mock.assert_requested(
+            'post',
+            '/v1/terminal/locations'
+        )
+        assert isinstance(resource, stripe.terminal.Location)
+
+    def test_is_listable(self, request_mock):
+        resources = stripe.terminal.Location.list()
+        request_mock.assert_requested(
+            'get',
+            '/v1/terminal/locations'
+        )
+        assert isinstance(resources.data, list)
+        assert isinstance(resources.data[0], stripe.terminal.Location)
+
+    def test_is_modifiable(self, request_mock):
+        resource = stripe.terminal.Location.modify(
+            TEST_RESOURCE_ID,
+            display_name='new-name'
+        )
+        request_mock.assert_requested(
+            'post',
+            '/v1/terminal/locations/%s' % TEST_RESOURCE_ID
+        )
+        assert isinstance(resource, stripe.terminal.Location)
+
+    def test_is_retrievable(self, request_mock):
+        resource = stripe.terminal.Location.retrieve(TEST_RESOURCE_ID)
+        request_mock.assert_requested(
+            'get',
+            '/v1/terminal/locations/%s' % TEST_RESOURCE_ID
+        )
+        assert isinstance(resource, stripe.terminal.Location)
+
+    def test_is_saveable(self, request_mock):
+        resource = stripe.terminal.Location.retrieve(TEST_RESOURCE_ID)
+        resource.display_name = 'new-name'
+        location = resource.save()
+        request_mock.assert_requested(
+            'post',
+            '/v1/terminal/locations/%s' % TEST_RESOURCE_ID
+        )
+        assert isinstance(resource, stripe.terminal.Location)
+        assert resource is location

tests/api_resources/terminal/test_reader.py

@@ -0,0 +1,58 @@
+from __future__ import absolute_import, division, print_function
+
+import stripe
+
+
+TEST_RESOURCE_ID = 'rdr_123'
+
+
+class TestReader(object):
+    def test_is_creatable(self, request_mock):
+        resource = stripe.terminal.Reader.create(
+            registration_code='a-b-c',
+            label='name'
+        )
+        request_mock.assert_requested(
+            'post',
+            '/v1/terminal/readers'
+        )
+        assert isinstance(resource, stripe.terminal.Reader)
+
+    def test_is_listable(self, request_mock):
+        resources = stripe.terminal.Reader.list()
+        request_mock.assert_requested(
+            'get',
+            '/v1/terminal/readers'
+        )
+        assert isinstance(resources.data, list)
+        assert isinstance(resources.data[0], stripe.terminal.Reader)
+
+    def test_is_modifiable(self, request_mock):
+        resource = stripe.terminal.Reader.modify(
+            TEST_RESOURCE_ID,
+            label='new-name'
+        )
+        request_mock.assert_requested(
+            'post',
+            '/v1/terminal/readers/%s' % TEST_RESOURCE_ID
+        )
+        assert isinstance(resource, stripe.terminal.Reader)
+
+    def test_is_retrievable(self, request_mock):
+        resource = stripe.terminal.Reader.retrieve(TEST_RESOURCE_ID)
+        request_mock.assert_requested(
+            'get',
+            '/v1/terminal/readers/%s' % TEST_RESOURCE_ID
+        )
+        assert isinstance(resource, stripe.terminal.Reader)
+
+    def test_is_saveable(self, request_mock):
+        resource = stripe.terminal.Reader.retrieve(TEST_RESOURCE_ID)
+        resource.label = 'new-name'
+        reader = resource.save()
+        request_mock.assert_requested(
+            'post',
+            '/v1/terminal/readers/%s' % TEST_RESOURCE_ID
+        )
+        assert isinstance(resource, stripe.terminal.Reader)
+        assert resource is reader

tests/conftest.py

@@ -13,7 +13,7 @@
 from tests.request_mock import RequestMock
 
 
-MOCK_MINIMUM_VERSION = '0.32.0'
+MOCK_MINIMUM_VERSION = '0.33.0'
 MOCK_PORT = os.environ.get('STRIPE_MOCK_PORT', 12111)