✨ feat: add json option to base class, deprecate response classes

Author: Jon-Becker

README.md

@@ -35,6 +35,16 @@ You can find specific documentation on a per-product basis below.
 ## SDK Documentation
 You can learn more about the Transpose SDK and how it works below.
 
+### Response Classes
+If you wish to recieve responses in JSON format, you can set the `json` parameter to `True` when initializing the SDK. This will return all responses as JSON objects.
+
+**Response classes are considered deprecated as of v3.1.0 and will be removed in v4.0.0. JSON responses will become standard in v4.0.0**
+
+```python
+from transpose_sdk import Transpose
+api = Transpose(api_key="YOUR_API_KEY", json=True)
+```
+
 ### Updating Chain ID
 If you want to change the chain ID of your query, you can do so by setting the `chain_id` or `chain` properties of the `Transpose` object. For example, if you want to query the Ethereum mainnet, you can do so by running the following code:
 

demo/tornado_deposit_withdrawl_over_time.png

@@ -8,7 +8,7 @@
 
     # version compliant with PEP440
     # https://peps.python.org/pep-0440/
-    version='3.0.1',
+    version='3.1.0',
 
     # project meta
     long_description = long_description,

setup.py

@@ -15,4 +15,12 @@ def test_invalid_api_key():
     except TransposeInvalidAPIKey:
         assert True
     except Exception:
-        assert False
+        assert False
+
+def test_json_response():
+    api = Transpose(api_key, json=True)
+    assert api.json == True
+
+    block = api.Block.blocks_by_number(1)
+
+    assert isinstance(block, (dict,))

tests/test_base_connection.py

@@ -12,11 +12,21 @@
 
 # base class for the Transpose python SDK
 class Transpose:
-    def __init__(self, api_key: str, debug: bool=False, host: str=None, chain_id: int=0, chain: str="ethereum") -> None:
+    def __init__(
+        self,
+        api_key: str,
+        debug: bool=False,
+        host: str=None,
+        chain_id: int=0,
+        chain: str="ethereum",
+        json: bool=False,
+    ) -> None:
+
         self._next = None
         self._next_class_name = None
         self.host = host if host else 'https://api.transpose.io'
         self.verbose = debug
+        self.json = json
 
         if chain.lower() == "ethereum": 
             self.chain_id = 1
@@ -55,7 +65,6 @@ def set_chain(self, chain_id: int=0, chain: str="ethereum") -> None:
 
         if chain_id != 0:
             self.chain_id = chain_id
-        
 
     # this can be renamed later. Pagination helper function to get many 
     def bulk_request(self, endpoint_response: List, requests_per_second: int=None, results_to_fetch: int=999999999999) -> List:
@@ -103,6 +112,10 @@ def perform_authorized_request(self, model: type, endpoint: str, api_key: str=No
                 self._next = response['next']
                 self._next_class_name = model
 
+            # if we are in json mode, return the raw json
+            if self.json:
+                return response
+
             return list(model(dict(each)) for each in response['results'])
         else:
             raise_custom_error(request.status_code, request.json()['message'])