Added README.md

Author: CardsApp

README.md

@@ -0,0 +1 @@
+**For detailed information on the SDK visit the [overview](https://cards.app/Developers/CardReader/Overview), [requirements](https://cards.app/Developers/CardReader/Requirements) and [getting started](https://cards.app/Developers/CardReader/GettingStarted) pages in our website.**

cards/CardDetails.py

@@ -0,0 +1,4 @@
+class CardDetails:
+    """Card Details Class"""
+    def __init__(self, user_id):
+        self.user_id = user_id

cards/CardReader.py

@@ -0,0 +1,40 @@
+from cards.ReaderSettings import ReaderSettings
+from cards.ReaderCredentials import ReaderCredentials
+from cards.NativeBaseDriver import *
+from cards.CardDetails import CardDetails
+from cards.CardTapResponse import CardTapResponse
+
+
+class ReaderStatus:
+    """Card Tap Error Enum"""
+    Disconnected = 1
+    Connected = 2
+    AlreadyInUse = 3
+
+
+class CardReader:
+    def __init__(self, reader_settings, reader_credentials):
+        self.reader_credentials = reader_credentials
+        self.on_card_tap = None
+        self.on_status_change = None
+
+        if reader_settings is None:
+            self.reader_settings = ReaderSettings(get_devices_list()[0])
+        else:
+            self.reader_settings = reader_settings
+
+        self.__instance = create_instance_by_name(self.reader_settings.device_name, self.reader_credentials.api_key)
+
+    def __del__(self):
+        destroy_instance(self.__instance)
+
+    def listen(self):
+        run_on_card_present(self.__instance, self.__get_internal_card_tap_handler(), self.on_status_change)
+
+    def __get_internal_card_tap_handler(self):
+        def internal_card_tap_handler(card_tap_response):
+            response = CardTapResponse(card_tap_response.isSuccess, card_tap_response.errorCode, CardDetails(card_tap_response.uid[:24].decode()))
+
+            self.on_card_tap(response)
+
+        return internal_card_tap_handler

cards/CardTapResponse.py

@@ -0,0 +1,19 @@
+class CardTapError:
+    """Card Tap Error Enum"""
+    InternetError = 1
+    ApiKeyInvalid = 2
+    TransactionTokenInvalid = 3
+    UserNotAssociatedWithCardReader = 4
+    NoSuchTPID = 5
+    TransactionTokenMissing = 6
+    TransactionTokenDoesntExist = 7
+    TransactionTokenAlreadyUsed = 8
+    TransactionTokenAlreadyValidated = 9
+
+
+class CardTapResponse:
+    """Card Tap Response Class"""
+    def __init__(self, is_success, error, card_details):
+        self.is_success = is_success
+        self.error = error
+        self.card_details = card_details

cards/NativeBaseDriver.py

@@ -0,0 +1,54 @@
+from ctypes import *
+
+
+class DevicesList(Structure):
+    _fields_ = [("names", POINTER(c_char_p)),
+                ("count", c_int)]
+
+
+class CardTapResponse(Structure):
+    _fields_ = [("isSuccess", c_int),
+                ("errorCode", c_int),
+                ("uid", c_char*32)]
+
+
+CardsBase = windll.LoadLibrary('CardsBase.dll')
+
+createInstanceByName = CardsBase.createInstanceByName
+destroyInstance = CardsBase.destroyInstance
+runOnCardPresent = CardsBase.runOnCardPresent
+getDevicesList = CardsBase.getDevicesList
+freeDevicesList = CardsBase.freeDevicesList
+
+getDevicesList.restype = DevicesList
+createInstanceByName.restype = c_void_p
+destroyInstance.restype = c_int
+runOnCardPresent.restype = None
+freeDevicesList.restype = None
+
+CARD_TAP_FUNC = WINFUNCTYPE(None, CardTapResponse)
+STATUS_CHANGE_FUNC = WINFUNCTYPE(None, c_int)
+
+
+def get_devices_list():
+    devices_list_struct = getDevicesList()
+    devices_list = []
+
+    for i in range(devices_list_struct.count):
+        devices_list.append(devices_list_struct.names[i].decode())
+
+    freeDevicesList(devices_list_struct)
+
+    return devices_list
+
+
+def create_instance_by_name(device_name, api_key):
+    return createInstanceByName(c_char_p(device_name.encode()), c_char_p(api_key.encode()))
+
+
+def destroy_instance(instance):
+    return destroyInstance(instance)
+
+
+def run_on_card_present(instance, card_tap_handler, status_change_handler):
+    runOnCardPresent(instance, CARD_TAP_FUNC(card_tap_handler), STATUS_CHANGE_FUNC(status_change_handler))

cards/ReaderCredentials.py

@@ -0,0 +1,4 @@
+class ReaderCredentials:
+    """Reader Credentials Class"""
+    def __init__(self, api_key):
+        self.api_key = api_key

cards/ReaderSettings.py

@@ -0,0 +1,4 @@
+class ReaderSettings:
+    """Reader Settings Class"""
+    def __init__(self, device_name):
+        self.device_name = device_name

cards/__init__.py

@@ -0,0 +1,7 @@
+from cards.CardReader import ReaderStatus, CardReader
+from cards.ReaderCredentials import ReaderCredentials
+from cards.ReaderSettings import ReaderSettings
+from cards.CardTapResponse import CardTapResponse, CardTapError
+
+
+__all__ = ['ReaderStatus', 'CardReader', 'ReaderCredentials', 'ReaderSettings', 'CardTapResponse']