pytolino 1.0__tar.gz → 1.2__tar.gz

{pytolino-1.0/src/pytolino.egg-info → pytolino-1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pytolino
-Version: 1.0
+Version: 1.2
 Summary: client for tolino cloud
 Author: Imam Usmani
 Project-URL: Source Code, https://github.com/ImamAzim/pytolino
@@ -62,6 +62,8 @@ You can then upload, add to a collection or delete ebook on your cloud:
     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.upload_metadata(epub_id, title='my title', author='someone') # you can upload various kind of metadata
     client.logout()
 
 
@@ -85,6 +87,8 @@ Features
 * upload ebook
 * delete ebook from the cloud
 * add a book to a collection
+* download inventory
+* upload metadata
 * more to come...
 
 

{pytolino-1.0 → pytolino-1.2}/README.rst

@@ -36,6 +36,8 @@ You can then upload, add to a collection or delete ebook on your cloud:
     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.upload_metadata(epub_id, title='my title', author='someone') # you can upload various kind of metadata
     client.logout()
 
 
@@ -59,6 +61,8 @@ Features
 * upload ebook
 * delete ebook from the cloud
 * add a book to a collection
+* download inventory
+* upload metadata
 * more to come...
 
 

{pytolino-1.0 → pytolino-1.2}/pyproject.toml

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

{pytolino-1.0 → pytolino-1.2}/src/pytolino/tolino_cloud.py

@@ -288,6 +288,46 @@ 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
 
@@ -324,6 +364,51 @@ class Client(object):
         if host_response.status_code != 200:
             raise PytolinoException('add to collection failed')
 
+    def upload_metadata(self, book_id, **new_metadata):
+        """upload some metadata to a specific book on the cloud
+
+        :book_id: ref on the cloud of the book
+        :**meta_data: dict of metadata than can be changed
+
+        """
+
+        url = self.server_settings['meta_url'] + f'/?deliverableId={book_id}'
+        host_response = self.session.get(
+                url,
+                headers={
+                    't_auth_token': self.access_token,
+                    'hardware_id': self.hardware_id,
+                    'reseller_id': self.server_settings['partner_id'],
+                  }
+                )
+
+        book = host_response.json()
+        self._log_requests(host_response)
+        if host_response.status_code != 200:
+            raise PytolinoException('metadata upload failed')
+
+        for key, value in new_metadata.items():
+            book['metadata'][key] = value
+
+        payload = {
+                'uploadMetaData': book['metadata']
+                }
+
+        host_response = self.session.put(
+                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'],
+                    }
+                )
+
+        self._log_requests(host_response)
+        if host_response.status_code != 200:
+            raise PytolinoException('metadata upload failed')
+
     def upload(self, file_path, name=None, extension=None):
         """upload an ebook to your cloud
 

{pytolino-1.0 → pytolino-1.2/src/pytolino.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pytolino
-Version: 1.0
+Version: 1.2
 Summary: client for tolino cloud
 Author: Imam Usmani
 Project-URL: Source Code, https://github.com/ImamAzim/pytolino
@@ -62,6 +62,8 @@ You can then upload, add to a collection or delete ebook on your cloud:
     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.upload_metadata(epub_id, title='my title', author='someone') # you can upload various kind of metadata
     client.logout()
 
 
@@ -85,6 +87,8 @@ Features
 * upload ebook
 * delete ebook from the cloud
 * add a book to a collection
+* download inventory
+* upload metadata
 * more to come...
 
 

{pytolino-1.0 → pytolino-1.2}/tests/test_tolino_cloud.py

@@ -160,5 +160,50 @@ 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())
+    for item in inventory:
+        metadata = item['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()
+
+
+def metadata_test():
+    new_metadata = dict(publisher='someone')
+    with open(EPUB_ID_PATH, 'r') as myfile:
+        epub_id = myfile.read()
+
+    username, password = get_credentials()
+    client = Client()
+    client.login(username, password)
+    client.upload_metadata(epub_id, **new_metadata)
+    inventory = client.get_inventory()
+    for item in inventory:
+        item_metadata = item['epubMetaData']
+        if item_metadata['identifier'] == epub_id:
+            for key, value in new_metadata.items():
+                print(item_metadata[key])
+    client.logout()
+
+
 if __name__ == '__main__':
-    collection_test()
+    # upload_test()
+    metadata_test()
+    # inventory_test()