dubidoc 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

dubidoc/__init__.py

@@ -2,6 +2,6 @@
 
 __author__ = 'Dmytro Litvinov'
 __email__ = 'me@dmytrolitvinov.com'
-__version__ = '0.1.1'
+__version__ = '0.1.3'
 
 from .client import DubidocAPIClient

dubidoc/_modules/document.py

@@ -14,6 +14,11 @@ class DocumentAPI:
         return self.client.make_request(HttpMethod.GET, self.PATH)
 
     def create(self, body, organization_id=None):
+        """
+        filename — назва файлу з розширенням (опціонально використовується для додаткової валідації)
+        file — base64
+        title — відображувана назва в кабінеті користувача, емейл листі тощо (рекомендується передавати назву файлу без розширення, хоча це не критично)
+        """
         return self.client.make_request(HttpMethod.POST, self.PATH, body)
 
     def get(self, document_id):

dubidoc/_modules/document_link.py

@@ -9,9 +9,9 @@ class DocumentLinkAPI:
     def __init__(self, client):
         self.client = client
 
-    def generate_public_link(self, document_id):
+    def generate_public_link(self, document_id, body):
         path = self.PATH.format(document_id)
-        return self.client.make_request(HttpMethod.POST, path)
+        return self.client.make_request(HttpMethod.POST, path, body)
 
     def revoke_public_link(self, document_id):
         path = self.PATH.format(document_id)

dubidoc/client.py

@@ -14,7 +14,7 @@ from dubidoc._modules import (
     DownloadAPI,
 )
 from dubidoc.enum import HttpMethod
-
+from dubidoc.response import DubidocAPIResponse
 
 logger = logging.getLogger('dubidoc')
 
@@ -43,17 +43,19 @@ class DubidocAPIClient:
         self.prefix = f'api/api/{self.API_VERSION}/'
         self.endpoint = urljoin(self.base_url, self.prefix)
 
+        self._modules = {}
+
         # Modules
-        self.document_api = DocumentAPI(self)
-        self.document_link_api = DocumentLinkAPI(self)
-        self.participant_api = ParticipantAPI(self)
-        self.download_api = DownloadAPI(self)
+        self.document_api = self._get_module(DocumentAPI)
+        self.document_link_api = self._get_module(DocumentLinkAPI)
+        self.participant_api = self._get_module(ParticipantAPI)
+        self.download_api = self._get_module(DownloadAPI)
 
         if environment == 'stage':
-            self.access_token_api = AccessTokenAPI(self)
-            self.authentication_api = AuthenticationAPI(self)
-            self.device_api = DeviceAPI(self)
-            # Not yet implemented anot probably not needed
+            self.access_token_api = self._get_module(AccessTokenAPI)
+            self.authentication_api = self._get_module(AuthenticationAPI)
+            self.device_api = self._get_module(DeviceAPI)
+            # Not yet implemented and probably not needed
             # self.organization_user_api = OrganizationUserAPI(self)
             # self.organization_api = OrganizationAPI(self)
             # self.shortcode_api = ShortcodeAPI(self)
@@ -63,7 +65,12 @@ class DubidocAPIClient:
         headers.update({'X-Access-Token': f'{self.api_token}'})
         return headers
 
-    def make_request(self, method: HttpMethod, path: str, body: dict = {}):
+    def _get_module(self, cls):
+        if cls not in self._modules:
+            self._modules[cls] = cls(self)
+        return self._modules[cls]
+
+    def make_request(self, method: HttpMethod, path: str, body: dict = {}) -> DubidocAPIResponse:
         """
         Fetches the given path in the Dubidoc API.
         :param method: HTTP method
@@ -79,4 +86,4 @@ class DubidocAPIClient:
         response = requests.request(method.value, url, headers=headers, json=body, timeout=10)
         logger.debug(f'Received response with status code {response.status_code} and body {response.text}')
 
-        return response.json()
+        return DubidocAPIResponse(response.json(), response.status_code)

dubidoc/response.py

@@ -0,0 +1,4 @@
+class DubidocAPIResponse:
+    def __init__(self, data, status_code):
+        self.data = data
+        self.status_code = status_code

{dubidoc-0.1.1.dist-info → dubidoc-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dubidoc
-Version: 0.1.1
+Version: 0.1.3
 Summary: Python SDK for dubidoc.com.ua API
 Maintainer-email: Dmytro Litvinov <me@dmytrolitvinov.com>
 License: MIT License
@@ -44,7 +44,7 @@ Requires-Dist: requests
 
 Python API wrapper around Dubidoc API. Feel free to contribute and make it better! 🚀
 
-**NOTE**: Since it is rearly release, some of the API endpoints may not be implemented yet. If you need some specific endpoint, feel free to create an issue or pull request.
+**NOTE**: Since it is early release, some of the API endpoints may not be implemented yet. If you need some specific endpoint, feel free to create an issue or pull request.
 Also, library can be changed in the future, so be careful with the updates as for now.
 
 ## Installation
@@ -73,3 +73,12 @@ print(documents)
 ## License
 
 This project is licensed under the terms of the [MIT license](https://github.com/DmytroLitvinov/python-dubidoc/blob/master/LICENSE).
+
+
+### HOW TO MAKE A RELEASE
+
+* Add changes to `CHANGELOG.md`
+* Change version in `dubidoc/__init__.py` and `pyproject.toml`
+* `source .env/bin/activate`
+* `python3 -m build --sdist --wheel`
+* `twine upload dist/*`

{dubidoc-0.1.1.dist-info → dubidoc-0.1.3.dist-info}/RECORD

@@ -1,19 +1,20 @@
-dubidoc/__init__.py,sha256=eyZiRe4vKR3cVZ-_dtX1gQSoKRljEaZ2dXFANyrZF24,177
-dubidoc/client.py,sha256=eHhPnlQIpCsxL4tN8GSPQQjoppQjRqCOPQlYwQphTGs,2847
+dubidoc/__init__.py,sha256=6l4n2dkEYCl6u_S0UaTouCrFrPSez64EBrHDeSNz3Ps,177
+dubidoc/client.py,sha256=UXRt6IykV-Pc9r9GCQv3xrAZP8VieIVcNz0CnbKG7yg,3216
 dubidoc/enum.py,sha256=RTIS0WplquZrFTqZGtzkc95i_9jqu2Xvl6j0SFXZ72I,120
+dubidoc/response.py,sha256=8k2GkMW2F5FX4U2TGJPfJD-_UE6DA4c1FGGQL_Vzr-E,133
 dubidoc/_modules/__init__.py,sha256=NUeLh3Onke4cs4BGkowtqbaBByLVh_tEqtXNtacKI2w,184
 dubidoc/_modules/access_token.py,sha256=nHyYWWg95SJkifvlgtr9I_h7jPTcdpcgxORukdjwwBU,1018
 dubidoc/_modules/authentication.py,sha256=AtIyTjtwdgT1nHBQkgqfvQsJvZ-T0qqK0epKi-TwGVE,1465
 dubidoc/_modules/device.py,sha256=ItrK-wzZVEAXPIWbTUkTsYl1JHZLSSAAAHFuKbgw2MU,976
-dubidoc/_modules/document.py,sha256=_DcQyn4EA346CZAr2BrZRZA0lhNtiLoGxt2e_HCt-qc,1455
-dubidoc/_modules/document_link.py,sha256=jBb0oB5aFGMLMg-iB1SIcE7R77iMskwN1MZ2ShsN6E4,503
+dubidoc/_modules/document.py,sha256=-SmWvQPN8r8jQGYFTm99bHhXmAOMF2kBJV96Ue8slV4,1947
+dubidoc/_modules/document_link.py,sha256=dHultZvqbPW3VxCspdUnzfBgmOPUzSgjeeuyAyA4H_I,515
 dubidoc/_modules/download.py,sha256=foTua0_sFpGrwObwgOr6HPen4ngFrJOhGdsCqPUCjnI,608
 dubidoc/_modules/organization.py,sha256=DkeLUlrb7rGx3nZ04aADU9HXXu5mZTf_DBwT0xhzIv4,7
 dubidoc/_modules/organization_user.py,sha256=DkeLUlrb7rGx3nZ04aADU9HXXu5mZTf_DBwT0xhzIv4,7
 dubidoc/_modules/participant.py,sha256=AJ60D7cokQNQFFeUWCngWvx-NQl6VuG-YarREAW9HtE,811
 dubidoc/_modules/storecode.py,sha256=DkeLUlrb7rGx3nZ04aADU9HXXu5mZTf_DBwT0xhzIv4,7
-dubidoc-0.1.1.dist-info/LICENSE,sha256=wYGgsJKkNcLDvJQfbrT5HabzSp3imJCmSpCOS8_pu9o,1072
-dubidoc-0.1.1.dist-info/METADATA,sha256=YBnlFdy-TiOIw1798_4zeXnvpZ0IkVg9TaE7ve61yaw,2805
-dubidoc-0.1.1.dist-info/WHEEL,sha256=Z4pYXqR_rTB7OWNDYFOm1qRk0RX6GFP2o8LgvP453Hk,91
-dubidoc-0.1.1.dist-info/top_level.txt,sha256=SQKT6uKBzQCmsVr8MCszUFz4WYCc5Oq7wvy5Y-ZReU0,8
-dubidoc-0.1.1.dist-info/RECORD,,
+dubidoc-0.1.3.dist-info/LICENSE,sha256=wYGgsJKkNcLDvJQfbrT5HabzSp3imJCmSpCOS8_pu9o,1072
+dubidoc-0.1.3.dist-info/METADATA,sha256=TnzKpuPPfjbpy8IiwTHGJrzcPuIvPXXa9mJbE8SkeyA,3018
+dubidoc-0.1.3.dist-info/WHEEL,sha256=cVxcB9AmuTcXqmwrtPhNK88dr7IR_b6qagTj0UvIEbY,91
+dubidoc-0.1.3.dist-info/top_level.txt,sha256=SQKT6uKBzQCmsVr8MCszUFz4WYCc5Oq7wvy5Y-ZReU0,8
+dubidoc-0.1.3.dist-info/RECORD,,

{dubidoc-0.1.1.dist-info → dubidoc-0.1.3.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (70.3.0)
+Generator: setuptools (74.1.2)
 Root-Is-Purelib: true
 Tag: py3-none-any