v0.2.2 - fix missing timeout and README

Author: AbstractUmbra

README.md

@@ -4,12 +4,11 @@ A small simple wrapper around the [Mystb.in](https://mystb.in/) API.
 
 ### Features
 
-[x] - `POST`ing to the API, which will return the provided url. \
-[x] - `GET`ting from the API, provided you know the URL or paste ID. \
-[x] - Ability to pass in a sync or async session / parameter so it is flexible.
-
-[x] - Write a real underlying Client for this, it will be required for... \
-[ ] - Authorization. Awaiting the API making this public as it is still WIP. \
+- [x] - `POST`ing to the API, which will return the provided url.
+- [x] - `GET`ting from the API, provided you know the URL or paste ID.
+- [x] - Ability to pass in a sync or async session / parameter so it is flexible.
+- [x] - Write a real underlying Client for this, it will be required for...
+- [ ] - ... Authorization. Awaiting the API making this public as it is still WIP.
 
 ### Installation
 This project will be on [PyPI](https://pypi.org/project/mystbin.py/) as a stable release, you can always find that there.
@@ -35,8 +34,19 @@ import mystbin
 
 mystbin_client = mystbin.MystbinClient() ## api_key kwarg for authentication also
 
-await mystbin_client.post("Hello from Mystb.in!", suffix="python")
+paste = await mystbin_client.post("Hello from Mystb.in!", syntax="python")
+str(paste)
+>>> 'https://mystb.in/<your generated ID>.python'
+
+paste.url
 >>> 'https://mystb.in/<your generated ID>.python'
+
+get_paste = await mystbin_client.get("https://mystb.in/<your generated ID>")
+str(paste)
+>>> "Hello from Mystb.in!"
+
+paste.created_at
+>>> datetime.datetime(2020, 10, 6, 10, 53, 57, 556741)
 ```
 
 ```py
@@ -47,7 +57,7 @@ import requests
 sync_session = requests.Session()
 mystbin_client = mystbin.MystbinClient(session=sync_session) ## optional api_key kwarg also
 
-mystbin_client.post("Hello from sync Mystb.in!", suffix="text")
+mystbin_client.post("Hello from sync Mystb.in!", syntax="text")
 >>> 'https://mystb.in/<your generated ID>.text'
 ```
 

mystbin/client.py

@@ -73,11 +73,11 @@ def _generate_sync_session(self, session: requests.Session) -> requests.Session:
     async def _generate_async_session(self, session: Optional[aiohttp.ClientSession] = None) -> aiohttp.ClientSession:
         """ We will update (or create) a :class:`aiohttp.ClientSession` instance with the auth we require. """
         if not session:
-            session = aiohttp.ClientSession(raise_for_status=False,
-                                            timeout=aiohttp.ClientTimeout(CLIENT_TIMEOUT))
+            session = aiohttp.ClientSession(raise_for_status=False)
         if self.api_key:
             session._default_headers.update(
                 {"Authorization": self.api_key})
+        session._timeout = aiohttp.ClientTimeout(CLIENT_TIMEOUT)
         return session
 
     def post(self, content: str, syntax: str = None) -> Union[Paste, Awaitable]:
@@ -100,7 +100,7 @@ def _perform_sync_post(self, content: str, syntax: str = None) -> Paste:
         """ Sync post request. """
         payload = {'meta': [{'index': 0, 'syntax': syntax}]}
         response: requests.Response = self.session.post(API_BASE_URL, files={
-                                                        'data': content, 'meta': (None, json.dumps(payload), 'application/json')})
+                                                        'data': content, 'meta': (None, json.dumps(payload), 'application/json')}, timeout=CLIENT_TIMEOUT)
         if response.status_code not in [200, 201]:
             raise APIError(response.status_code, response.text)
 
@@ -163,4 +163,4 @@ async def _perform_async_get(self, paste_id: str, syntax: str = None) -> PasteDa
     async def close(self):
         """ Async only - close the session. """
         if self.session and isinstance(self.session, aiohttp.ClientSession):
-            await self.session.close()
+            await self.session.close()