pytolino 1.0__py3-none-any.whl → 1.2__py3-none-any.whl

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.dist-info → pytolino-1.2.dist-info}/METADATA

@@ -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.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+pytolino/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pytolino/servers_settings.ini,sha256=F8wSIWwl4XhQJKrhhbHtLhpXtfaGI7ODoD-VReaseBQ,1496
+pytolino/tolino_cloud.py,sha256=qZA35bHpfMjaHd97dcsl3uRqoL64ts8o6DJ-hWUGkPQ,17402
+pytolino-1.2.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+pytolino-1.2.dist-info/METADATA,sha256=74bkCmM2y9gp6fWEINEB_3KHPB7cpAfwgyBLNBEsRR0,3061
+pytolino-1.2.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+pytolino-1.2.dist-info/top_level.txt,sha256=3stGCqihEMMqlWGkME45OTJ0Prg-FO_kl554rtYNeuU,9
+pytolino-1.2.dist-info/RECORD,,

pytolino-1.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-pytolino/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pytolino/servers_settings.ini,sha256=F8wSIWwl4XhQJKrhhbHtLhpXtfaGI7ODoD-VReaseBQ,1496
-pytolino/tolino_cloud.py,sha256=e1BMWHiF83scNm3pbByRSnCjVBZv4YNYuQBtkpmlpPY,14345
-pytolino-1.0.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-pytolino-1.0.dist-info/METADATA,sha256=RRsrHj5-YAEAKO-1DxBkFP1bA-x7Z7dJqzG3d1ShOO4,2807
-pytolino-1.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-pytolino-1.0.dist-info/top_level.txt,sha256=3stGCqihEMMqlWGkME45OTJ0Prg-FO_kl554rtYNeuU,9
-pytolino-1.0.dist-info/RECORD,,