pytolino 0.1.5__tar.gz → 1.1__tar.gz

{pytolino-0.1.5/src/pytolino.egg-info → pytolino-1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pytolino
-Version: 0.1.5
+Version: 1.1
 Summary: client for tolino cloud
 Author: Imam Usmani
 Project-URL: Source Code, https://github.com/ImamAzim/pytolino
@@ -52,7 +52,7 @@ Before being able to send requests, you need to register your computer on which
     client.register() # do this only once!
     client.logout()
 
-You can then upload or delete ebook on your cloud:
+You can then upload, add to a collection or delete ebook on your cloud:
 
 .. code-block:: python
 
@@ -60,7 +60,9 @@ You can then upload or delete ebook on your cloud:
     client = Client()
     client.login(USERNAME, PASSWORD)
     ebook_id = client.upload(EPUB_FILE_PATH) # return a unique id that can be used for reference
+    client.add_collection(epub_id, 'science fiction') # add the previous book to the collection science-fiction
     client.delete_ebook(epub_id) # delete the previousely uploaded ebook
+    inventory = client.get_inventory() # get a list of all the books on the cloud and their metadata
     client.logout()
 
 
@@ -83,6 +85,8 @@ Features
 * unregister device
 * upload ebook
 * delete ebook from the cloud
+* add a book to a collection
+* download inventory
 * more to come...
 
 

{pytolino-0.1.5 → pytolino-1.1}/README.rst

@@ -26,7 +26,7 @@ Before being able to send requests, you need to register your computer on which
     client.register() # do this only once!
     client.logout()
 
-You can then upload or delete ebook on your cloud:
+You can then upload, add to a collection or delete ebook on your cloud:
 
 .. code-block:: python
 
@@ -34,7 +34,9 @@ You can then upload or delete ebook on your cloud:
     client = Client()
     client.login(USERNAME, PASSWORD)
     ebook_id = client.upload(EPUB_FILE_PATH) # return a unique id that can be used for reference
+    client.add_collection(epub_id, 'science fiction') # add the previous book to the collection science-fiction
     client.delete_ebook(epub_id) # delete the previousely uploaded ebook
+    inventory = client.get_inventory() # get a list of all the books on the cloud and their metadata
     client.logout()
 
 
@@ -57,6 +59,8 @@ Features
 * unregister device
 * upload ebook
 * delete ebook from the cloud
+* add a book to a collection
+* download inventory
 * more to come...
 
 

{pytolino-0.1.5 → pytolino-1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pytolino"
-version = "0.1.5"
+version = "1.1"
 authors = [
     {name="Imam Usmani"},
 ]

{pytolino-0.1.5 → pytolino-1.1}/src/pytolino/tolino_cloud.py

@@ -7,6 +7,7 @@ import platform
 import logging
 from urllib.parse import urlparse, parse_qs
 import json
+import time
 
 
 import requests
@@ -287,6 +288,82 @@ class Client(object):
                 raise PytolinoException(
                         f'unregister {device_id} failed: reason unknown.')
 
+    def get_inventory(self):
+        """download a list of the books on the cloud and their information
+        :returns: list of dict describing the book, with a epubMetaData dict
+
+        """
+
+        host_response = self.session.get(
+                self.server_settings['inventory_url'],
+                params={'strip': 'true'},
+                headers={
+                    't_auth_token': self.access_token,
+                    'hardware_id': self.hardware_id,
+                    'reseller_id': self.server_settings['partner_id'],
+                    }
+                )
+
+        self._log_requests(host_response)
+        if host_response.status_code != 200:
+            raise PytolinoException('invetory request failed')
+
+        try:
+            j = host_response.json()
+        except requests.JSONDecodeError:
+            raise PytolinoException(
+                    'inventory list request failed because of json error.'
+                    )
+        else:
+            try:
+                publication_inventory = j['PublicationInventory']
+                uploaded_ebooks = publication_inventory['edata']
+                purchased_ebook = publication_inventory['ebook']
+            except KeyError:
+                raise PytolinoException(
+                        'inventory list request failed because',
+                        'of key error in json.',
+                        )
+            else:
+                inventory = uploaded_ebooks + purchased_ebook
+                return inventory
+
+    def add_to_collection(self, book_id, collection_name):
+        """add a book to a collection on the cloud
+
+        :book_id: identify the book on the cloud
+        :collection_name: str name
+
+        """
+
+        payload = {
+                "revision": None,
+                "patches": [{
+                    "op": "add",
+                    "value": {
+                        "modified": round(time.time() * 1000),
+                        "name": collection_name,
+                        "category": "collection",
+                    },
+                    "path": f"/publications/{book_id}/tags"
+                    }]
+                }
+
+        host_response = self.session.patch(
+                self.server_settings['sync_data_url'],
+                data=json.dumps(payload),
+                headers={
+                    'content-type': 'application/json',
+                    't_auth_token': self.access_token,
+                    'hardware_id': self.hardware_id,
+                    'reseller_id': self.server_settings['partner_id'],
+                    'client_type': 'TOLINO_WEBREADER',
+                    }
+                )
+        self._log_requests(host_response)
+        if host_response.status_code != 200:
+            raise PytolinoException('add to collection failed')
+
     def upload(self, file_path, name=None, extension=None):
         """upload an ebook to your cloud
 

{pytolino-0.1.5 → pytolino-1.1/src/pytolino.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pytolino
-Version: 0.1.5
+Version: 1.1
 Summary: client for tolino cloud
 Author: Imam Usmani
 Project-URL: Source Code, https://github.com/ImamAzim/pytolino
@@ -52,7 +52,7 @@ Before being able to send requests, you need to register your computer on which
     client.register() # do this only once!
     client.logout()
 
-You can then upload or delete ebook on your cloud:
+You can then upload, add to a collection or delete ebook on your cloud:
 
 .. code-block:: python
 
@@ -60,7 +60,9 @@ You can then upload or delete ebook on your cloud:
     client = Client()
     client.login(USERNAME, PASSWORD)
     ebook_id = client.upload(EPUB_FILE_PATH) # return a unique id that can be used for reference
+    client.add_collection(epub_id, 'science fiction') # add the previous book to the collection science-fiction
     client.delete_ebook(epub_id) # delete the previousely uploaded ebook
+    inventory = client.get_inventory() # get a list of all the books on the cloud and their metadata
     client.logout()
 
 
@@ -83,6 +85,8 @@ Features
 * unregister device
 * upload ebook
 * delete ebook from the cloud
+* add a book to a collection
+* download inventory
 * more to come...
 
 

{pytolino-0.1.5 → pytolino-1.1}/tests/test_tolino_cloud.py

@@ -137,6 +137,16 @@ def upload_test():
 
     client.logout()
 
+def collection_test():
+    with open(EPUB_ID_PATH, 'r') as myfile:
+        epub_id = myfile.read()
+
+    username, password = get_credentials()
+    client = Client()
+    client.login(username, password)
+    client.add_to_collection(epub_id, 'test_coll')
+    client.logout()
+
 
 def delete_test():
 
@@ -150,5 +160,26 @@ def delete_test():
     client.logout()
 
 
+def inventory_test():
+
+    username, password = get_credentials()
+    client = Client()
+    client.login(username, password)
+    inventory = client.get_inventory()
+    client.logout()
+    print(inventory[0].keys())
+    metadata = inventory[0]['epubMetaData']
+    print(metadata.keys())
+
+def delete_test():
+
+    with open(EPUB_ID_PATH, 'r') as myfile:
+        epub_id = myfile.read()
+
+    username, password = get_credentials()
+    client = Client()
+    client.login(username, password)
+    client.delete_ebook(epub_id)
+    client.logout()
 if __name__ == '__main__':
-    delete_test()
+    inventory_test()