dubidoc 0.1.0__py3-none-any.whl

dubidoc/__init__.py

@@ -0,0 +1,7 @@
+"""Top-level package for Dubidoc API wrapper."""
+
+__author__ = 'Dmytro Litvinov'
+__email__ = 'me@dmytrolitvinov.com'
+__version__ = '0.1.0'
+
+from .client import DubidocAPIClient

dubidoc/_modules/__init__.py

@@ -0,0 +1,7 @@
+from .access_token import *
+from .authentication import *
+from .device import *
+from .document import *
+from .document_link import *
+from .download import *
+from .participant import *

dubidoc/_modules/access_token.py

@@ -0,0 +1,33 @@
+from dubidoc.enum import HttpMethod
+
+__all__ = ('AccessTokenAPI',)
+
+
+class AccessTokenAPI:
+    PATH = 'access-tokens'
+
+    def __init__(self, client):
+        self.client = client
+
+    def get_tokens(self):
+        """
+        Отримати список всіх згенерованих Вами API-ключів (токенів)
+        """
+        path = self.PATH
+        return self.client.make_request(HttpMethod.GET, path)
+
+    def generate_token(self, title):
+        """
+        Генерування статичного API-ключа (токену) для доступу до API
+        :param title:
+        """
+        path = self.PATH
+        return self.client.make_request(HttpMethod.POST, path, body={'title': title})
+
+    def revoke_token(self, token_id):
+        """
+        Зробити обраний API-ключ (токен) недійсним
+        :param token_id:
+        """
+        path = f'{self.PATH}/{token_id}'
+        return self.client.make_request(HttpMethod.DELETE, path)

dubidoc/_modules/authentication.py

@@ -0,0 +1,38 @@
+from dubidoc.enum import HttpMethod
+
+
+__all__ = ('AuthenticationAPI',)
+
+
+class AuthenticationAPI:
+    def __init__(self, client):
+        self.client = client
+
+    def get_code(self, login):
+        """
+        Title: Отримати код авторизації
+        Description: Метод відправки тимчасового коду для авторизації через email
+        """
+        path = self.PATH
+        body = {'login': login}
+        return self.client.make_request(HttpMethod.POST, path, body)
+
+    def get_token(self, login, code):
+        """
+        Title: Отримати авторизаційний токен
+        Description: Метод для отримання токену користувача на основі email та тимчасового коду авторизації
+        """
+        path = 'auth/get-token'
+        body = {'login': login, 'code': code}
+        return self.client.make_request(HttpMethod.POST, path, body)
+
+    def refresh(self, refresh_token):
+        """
+        Title: Оновити авторизаційний токен
+        Description: Продовжити дію авторизаційного токену користувача на основі refresh токену
+        :param token_id:
+        :return:
+        """
+        path = 'token/refresh'
+        body = {'refresh_token': refresh_token}
+        return self.client.delete(HttpMethod.POST, path, body)

dubidoc/_modules/device.py

@@ -0,0 +1,25 @@
+from dubidoc.enum import HttpMethod
+
+__all__ = ('DeviceAPI',)
+
+
+class DeviceAPI:
+    def __init__(self, client):
+        self.client = client
+
+    def register(self, token):
+        """
+        Title: Зареєструвати пристрій для відправки сповіщень
+        Description: Зареєструвати device token який отриманий через Firebase Cloud Messaging для відправки нотифікацій користувачу
+        """
+        path = 'devices'
+        body = {'token': token}
+        return self.client.make_request(HttpMethod.POST, path, body)
+
+    def unregister(self, token):
+        """
+        Title: Відписати пристрій від отримання сповіщень
+        Description: Скасувати відправку сповіщень для device token
+        """
+        path = f'devices/{token}'
+        return self.client.make_request(HttpMethod.DELETE, path)

dubidoc/_modules/document.py

@@ -0,0 +1,54 @@
+from dubidoc.enum import HttpMethod
+
+
+__all__ = ('DocumentAPI',)
+
+
+class DocumentAPI:
+    PATH = 'documents'
+
+    def __init__(self, client):
+        self.client = client
+
+    def list(self):
+        return self.client.make_request(HttpMethod.GET, self.PATH)
+
+    def create(self, body, organization_id=None):
+        return self.client.make_request(HttpMethod.POST, self.PATH, body)
+
+    def get(self, document_id):
+        path = f'{self.PATH}/{document_id}'
+        return self.client.make_request(HttpMethod.GET, path)
+
+    def edit(self, document_id, title):
+        path = f'{self.PATH}/{document_id}'
+        body = {
+            'title': title,
+        }
+        return self.client.make_request(HttpMethod.PUT, path, body)
+
+    def delete(self, document_id):
+        """
+        Title: Видалення документа
+        Description: Увага, видалити документ можливо лише за умови, що він не був підписаний або надісланий отримувачу
+        """
+        path = f'{self.PATH}/{document_id}'
+        return self.client.make_request(HttpMethod.DELETE, path)
+
+    def download(self):
+        raise NotImplementedError
+
+    def unarchive(self):
+        raise NotImplementedError
+
+    def participants(self):
+        raise NotImplementedError
+
+    def sign(self):
+        raise NotImplementedError
+
+    def signatures(self):
+        raise NotImplementedError
+
+    def archive(self):
+        raise NotImplementedError

dubidoc/_modules/document_link.py

@@ -0,0 +1,18 @@
+from dubidoc.enum import HttpMethod
+
+__all__ = ('DocumentLinkAPI',)
+
+
+class DocumentLinkAPI:
+    PATH = 'documents/{}/links'
+
+    def __init__(self, client):
+        self.client = client
+
+    def generate_public_link(self, document_id):
+        path = self.PATH.format(document_id)
+        return self.client.make_request(HttpMethod.POST, path)
+
+    def revoke_public_link(self, document_id):
+        path = self.PATH.format(document_id)
+        return self.client.make_request(HttpMethod.DELETE, path)

dubidoc/_modules/download.py

@@ -0,0 +1,23 @@
+from dubidoc.enum import HttpMethod
+
+
+__all__ = ('DownloadAPI',)
+
+
+class DownloadAPI:
+    PATH = 'downloads'
+
+    def __init__(self, client):
+        self.client = client
+
+    def bulk_uploads(self, body):
+        path = self.PATH
+        return self.client.make_request(HttpMethod.POST, path, body)
+
+    def download(self, download_id):
+        path = f'{self.PATH}/{download_id}/download'
+        return self.client.make_request(HttpMethod.GET, path)
+
+    def check_status(self, download_id):
+        path = f'{self.PATH}/{download_id}/status'
+        return self.client.make_request(HttpMethod.GET, path)

dubidoc/_modules/organization.py

@@ -0,0 +1 @@
+# TODO

dubidoc/_modules/organization_user.py

@@ -0,0 +1 @@
+# TODO

dubidoc/_modules/participant.py

@@ -0,0 +1,24 @@
+from dubidoc.enum import HttpMethod
+
+__all__ = ('ParticipantAPI',)
+
+
+class ParticipantAPI:
+    def __init__(self, client):
+        self.client = client
+
+    def add_participant(self, document_id, body):
+        path = 'documents/{}/participants'.format(document_id)
+        return self.client.make_request(HttpMethod.POST, path, body)
+
+    def remove_participant(self, participant_id):
+        """
+        It sounds like it should be DELETE 'documents/{}/participants/{}', but
+        each participant has own unique id, so it should be 'participants/{}'.
+        You can retrieve participant_id from the response of 'add_participant' method.
+        """
+        path = 'participants/{}'.format(participant_id)
+        return self.client.make_request(
+            HttpMethod.DELETE,
+            path,
+        )

dubidoc/_modules/storecode.py

@@ -0,0 +1 @@
+# TODO

dubidoc/client.py

@@ -0,0 +1,82 @@
+import logging
+from urllib.parse import urljoin
+
+import requests
+
+from dubidoc import __version__
+from dubidoc._modules import (
+    AccessTokenAPI,
+    AuthenticationAPI,
+    DeviceAPI,
+    DocumentAPI,
+    DocumentLinkAPI,
+    ParticipantAPI,
+    DownloadAPI,
+)
+from dubidoc.enum import HttpMethod
+
+
+logger = logging.getLogger('dubidoc')
+
+
+class DubidocAPIClient:
+    """
+    - https://my.dubidoc.com.ua/auth - production URL
+    - https://docs-stage.navkolo.one/auth - staging URL
+    """
+
+    API_VERSION = 'v1'
+    DEFAULT_HEADERS = {
+        'accept': 'application/json',
+        'content-type': 'application/json',
+        'user-agent': f'python-dubidoc/{__version__} | (https://github.com/DmytroLitvinov/python-dubidoc)',
+    }
+
+    def __init__(self, api_token: str, environment: str = 'stage'):
+        self.api_token = api_token
+        if environment == 'stage':
+            self.base_url = 'https://docs-stage.navkolo.one'
+        else:
+            self.base_url = 'https://my.dubidoc.com.ua'
+        # FIXME: The prefix should be "api/v1" instead of "api/api/v1"
+        #  Dubidoc will notify when it will be fixed
+        self.prefix = f'api/api/{self.API_VERSION}/'
+        self.endpoint = urljoin(self.base_url, self.prefix)
+
+        # Modules
+        self.document_api = DocumentAPI(self)
+        self.document_link_api = DocumentLinkAPI(self)
+        self.participant_api = ParticipantAPI(self)
+        self.download_api = DownloadAPI(self)
+
+        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.organization_user_api = OrganizationUserAPI(self)
+            # self.organization_api = OrganizationAPI(self)
+            # self.shortcode_api = ShortcodeAPI(self)
+
+    def _get_headers(self):
+        headers = self.DEFAULT_HEADERS.copy()
+        headers.update({'X-Access-Token': f'{self.api_token}'})
+        return headers
+
+    def make_request(self, method: HttpMethod, path: str, body: dict = {}):
+        """
+        Fetches the given path in the Dubidoc API.
+        :param method: HTTP method
+        :param path: Api path
+        :param body: body of request
+        :return: Serialized server response or error
+        """
+        url = urljoin(self.endpoint, path)
+        headers = self._get_headers()
+
+        logger.debug(f'Making {method.value} request to {url} with headers {headers} and body {body}')
+        # https://github.com/psf/requests/issues/3070
+        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()

dubidoc/enum.py

@@ -0,0 +1,8 @@
+from enum import Enum
+
+
+class HttpMethod(Enum):
+    GET = 'GET'
+    POST = 'POST'
+    PUT = 'PUT'
+    DELETE = 'DELETE'

dubidoc-0.1.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dmytro Litvinov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dubidoc-0.1.0.dist-info/METADATA

@@ -0,0 +1,72 @@
+Metadata-Version: 2.1
+Name: dubidoc
+Version: 0.1.0
+Summary: Python SDK for dubidoc.com.ua API
+Maintainer-email: Dmytro Litvinov <me@dmytrolitvinov.com>
+License: MIT License
+Project-URL: Homepage, https://github.com/DmytroLitvinov/python-dubidoc
+Project-URL: Issues, https://github.com/DmytroLitvinov/python-dubidoc/issues
+Project-URL: Changelog, https://github.com/DmytroLitvinov/python-dubidoc/CHANGELOG.md
+Keywords: dubidoc,Ukraine,🇺🇦,api,dubidoc.com.ua
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+
+# Dubidoc API client ✍
+
+[![PyPI](https://img.shields.io/pypi/v/dubidoc?style=flat-square)](https://pypi.python.org/pypi/dubidoc/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/dubidoc?style=flat-square)](https://pypi.python.org/pypi/dubidoc/)
+[![PyPI - License](https://img.shields.io/pypi/l/dubidoc?style=flat-square)](https://pypi.python.org/pypi/dubidoc/)
+
+---
+**Documentation**: [https://my.dubidoc.com.ua/api/api/v1/docs](https://my.dubidoc.com.ua/api/api/v1/docs)
+
+**Source Code**: [https://github.com/DmytroLitvinov/python-dubidoc](https://github.com/DmytroLitvinov/python-dubidoc)
+
+**PyPI**: [https://pypi.org/project/dubidoc/](https://pypi.org/project/dubidoc/)
+
+---
+
+Python API wrapper around Dubidoc API. Feel free to contribute and make it better! 🚀
+
+## Installation
+
+```sh
+pip install dubidoc
+```
+
+## Usage
+
+1) Request your token at [Dubidoc team](https://t.me/dmytro_dubilet/814)
+
+2) Use that token to initialize client:
+
+```python
+from dubidoc import DubidocAPIClient
+
+api_token = 'xxxxxxxxxxxxxxx'
+
+dubidoc = DubidocAPIClient(api_token)
+
+documents = dubidoc.document_api.list()
+print(documents)
+```
+
+## License
+
+This project is licensed under the terms of the [MIT license](https://github.com/DmytroLitvinov/python-dubidoc/blob/master/LICENSE).

dubidoc-0.1.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+dubidoc/__init__.py,sha256=7Hi9v5lFaX9zZQUJVuiPqvyDV39PIzMoYlZ7ydcGtDg,177
+dubidoc/client.py,sha256=eHhPnlQIpCsxL4tN8GSPQQjoppQjRqCOPQlYwQphTGs,2847
+dubidoc/enum.py,sha256=RTIS0WplquZrFTqZGtzkc95i_9jqu2Xvl6j0SFXZ72I,120
+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=ltE_UFsiy8WODjiGbOLkJCP-GBWpzrLJ846dmuir_hY,1511
+dubidoc/_modules/document_link.py,sha256=jBb0oB5aFGMLMg-iB1SIcE7R77iMskwN1MZ2ShsN6E4,503
+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.0.dist-info/LICENSE,sha256=wYGgsJKkNcLDvJQfbrT5HabzSp3imJCmSpCOS8_pu9o,1072
+dubidoc-0.1.0.dist-info/METADATA,sha256=FDyva0F76MOODgQGOUTNFn85-b9r1kJFlMSCKwkP2O0,2533
+dubidoc-0.1.0.dist-info/WHEEL,sha256=Z4pYXqR_rTB7OWNDYFOm1qRk0RX6GFP2o8LgvP453Hk,91
+dubidoc-0.1.0.dist-info/top_level.txt,sha256=SQKT6uKBzQCmsVr8MCszUFz4WYCc5Oq7wvy5Y-ZReU0,8
+dubidoc-0.1.0.dist-info/RECORD,,

dubidoc-0.1.0.dist-info/WHEEL

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

dubidoc-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+dubidoc