Merge pull request #27 from guilyx/async

AsyncClient

Author: guilyx

README.md

@@ -59,6 +59,12 @@ Checkout the [Changelog](https://github.com/guilyx/python-nexo/blob/master/docs/
 - Register a Nexo Account. [here](https://nexo.io/ref/vaqo55u5py?src=web-link)
 - Generate an API Key in Nexo Pro with the permissions you want.
 
+## Advice
+
+Priviledge Async Client. The advantage of async processing is that we don’t need to block on I/O which is every action that we make when we interact with the Nexo Pro servers.
+
+By not blocking execution we can continue processing data while we wait for responses or new data from websockets.
+
 ## Set it up 💾
 
 ### PIP
@@ -67,11 +73,37 @@ Checkout the [Changelog](https://github.com/guilyx/python-nexo/blob/master/docs/
 2. Explore the API:
 
 ```python3
+#### Sync
+
 import nexo
 import os
-c = nexo.Client("your_api_key", "your_api_secret")
+from dotenv import load_dotenv
+
+# Loads your API keys from the .env file you created
+load_dotenv()
+key = os.getenv("NEXO_PUBLIC_KEY")
+secret = os.getenv("NEXO_SECRET_KEY")
+
+# Instantiate Client and grab account balances
+c = nexo.Client(key, secret)
 balances = c.get_account_balances()
 print(balances)
+
+#### Async
+
+import nexo
+import os
+import asyncio
+from dotenv import load_dotenv
+
+
+load_dotenv()
+
+key = os.getenv("NEXO_PUBLIC_KEY")
+secret = os.getenv("NEXO_SECRET_KEY")
+
+client = nexo.AsyncClient.create(key, secret)
+print(await client.get_account_balances())
 ```
 
 ### Docker (source)

codecov.yml

@@ -17,8 +17,10 @@ parsers:
 ignore:
   - "setup.py"
   - "examples/*"
+  - "nexo/async_client.py"
+  - "nexo/client.py"
 
 comment:
   layout: "reach,diff,flags,files,footer"
   behavior: default
-  require_changes: no
+  require_changes: no

examples/async_get_balances.py

@@ -0,0 +1,24 @@
+import sys
+from os import path
+
+sys.path.append(path.dirname(path.dirname(path.abspath(__file__))))
+
+import nexo
+import os
+import asyncio
+from dotenv import load_dotenv
+
+load_dotenv()
+
+key = os.getenv("NEXO_PUBLIC_KEY")
+secret = os.getenv("NEXO_SECRET_KEY")
+
+async def main():
+    client = await nexo.AsyncClient.create(key, secret)
+    print(await client.get_account_balances())
+
+    await client.close_connection()
+
+if __name__ == "__main__":
+    loop = asyncio.get_event_loop()
+    loop.run_until_complete(main())

nexo/__init__.py

@@ -4,6 +4,7 @@
 
 __version__ = "1.0.1"
 
+from nexo.async_client import AsyncClient
 from nexo.client import Client
 from nexo.response_serializers import (
     AdvancedOrderResponse,