adtr-client 0.0.1__tar.gz

adtr_client-0.0.1/LICENSE

@@ -0,0 +1,14 @@
+DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                    Version 2, December 2004
+
+ Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+
+ Everyone is permitted to copy and distribute verbatim or modified
+ copies of this license document, and changing it is allowed as long
+ as the name is changed.
+
+            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. You just DO WHAT THE FUCK YOU WANT TO.
+

adtr_client-0.0.1/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: adtr_client
+Version: 0.0.1
+Summary: A simple Python client for the [Adtr Translation API]
+Author-email: pi11 <webii@pm.me>
+License: DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                            Version 2, December 2004
+        
+         Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+        
+         Everyone is permitted to copy and distribute verbatim or modified
+         copies of this license document, and changing it is allowed as long
+         as the name is changed.
+        
+                    DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+           TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+        
+          0. You just DO WHAT THE FUCK YOU WANT TO.
+        
+        
+Project-URL: Homepage, https://github.com/pi11/adtr_client
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Adtr Translation Client
+
+A simple Python client for the [Adtr Translation API](https://adtr.webnova.one/docs).
+
+## Installation
+
+Install the client using pip:
+
+```bash
+pip install adtr_client
+```
+
+## Usage
+
+Use the client to translate text via the Adtr Translation API.
+
+Example:
+
+```python
+from adtr_client.translate import translate
+
+result = translate(
+    user_id="your_user_id",
+    api_key="your_api_key",
+    text="text to translate",
+    target_language="target_language"
+)
+
+print(result)
+```
+
+## Configuration
+
+1. Obtain your `user_id` and `api_key` from the rkn.name service
+2. Replace `"your_user_id"`, `"your_api_key"`, and other parameters in the example above with your credentials and desired values.
+
+```
+

adtr_client-0.0.1/README.md

@@ -0,0 +1,38 @@
+# Adtr Translation Client
+
+A simple Python client for the [Adtr Translation API](https://adtr.webnova.one/docs).
+
+## Installation
+
+Install the client using pip:
+
+```bash
+pip install adtr_client
+```
+
+## Usage
+
+Use the client to translate text via the Adtr Translation API.
+
+Example:
+
+```python
+from adtr_client.translate import translate
+
+result = translate(
+    user_id="your_user_id",
+    api_key="your_api_key",
+    text="text to translate",
+    target_language="target_language"
+)
+
+print(result)
+```
+
+## Configuration
+
+1. Obtain your `user_id` and `api_key` from the rkn.name service
+2. Replace `"your_user_id"`, `"your_api_key"`, and other parameters in the example above with your credentials and desired values.
+
+```
+

adtr_client-0.0.1/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "adtr_client"
+version = "0.0.1"
+authors = [
+  { name="pi11", email="webii@pm.me" },
+]
+description = "A simple Python client for the [Adtr Translation API]"
+readme = "README.md"
+requires-python = ">=3.9"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = { file = "LICENSE" }
+
+[project.urls]
+Homepage = "https://github.com/pi11/adtr_client"

adtr_client-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

adtr_client-0.0.1/src/adtr_client.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: adtr_client
+Version: 0.0.1
+Summary: A simple Python client for the [Adtr Translation API]
+Author-email: pi11 <webii@pm.me>
+License: DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                            Version 2, December 2004
+        
+         Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+        
+         Everyone is permitted to copy and distribute verbatim or modified
+         copies of this license document, and changing it is allowed as long
+         as the name is changed.
+        
+                    DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+           TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+        
+          0. You just DO WHAT THE FUCK YOU WANT TO.
+        
+        
+Project-URL: Homepage, https://github.com/pi11/adtr_client
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Adtr Translation Client
+
+A simple Python client for the [Adtr Translation API](https://adtr.webnova.one/docs).
+
+## Installation
+
+Install the client using pip:
+
+```bash
+pip install adtr_client
+```
+
+## Usage
+
+Use the client to translate text via the Adtr Translation API.
+
+Example:
+
+```python
+from adtr_client.translate import translate
+
+result = translate(
+    user_id="your_user_id",
+    api_key="your_api_key",
+    text="text to translate",
+    target_language="target_language"
+)
+
+print(result)
+```
+
+## Configuration
+
+1. Obtain your `user_id` and `api_key` from the rkn.name service
+2. Replace `"your_user_id"`, `"your_api_key"`, and other parameters in the example above with your credentials and desired values.
+
+```
+

adtr_client-0.0.1/src/adtr_client.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+src/translate.py
+src/adtr_client.egg-info/PKG-INFO
+src/adtr_client.egg-info/SOURCES.txt
+src/adtr_client.egg-info/dependency_links.txt
+src/adtr_client.egg-info/top_level.txt

adtr_client-0.0.1/src/adtr_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

adtr_client-0.0.1/src/adtr_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+translate

adtr_client-0.0.1/src/translate.py

@@ -0,0 +1,44 @@
+from requests import Session
+
+def translate(
+    user_id: int, api_key: str, text: str, target_language: str = "russian"
+) -> str:
+    """
+    Translate text to the specified target language.
+
+    Args:
+        user_id: User ID from rkn.name service
+        api_key: Api key from rkn.name service
+        text (str): Text to translate (max 300 characters)
+        target_language (str, optional): Target language for translation. Defaults to "russian".
+
+    Returns:
+        str: translated text
+
+    Raises:
+        requests.exceptions.HTTPError: If the API returns an error
+        ValueError: If input validation fails
+    """
+    if not text.strip():
+        raise ValueError("Text cannot be empty")
+
+    if len(text) > 300:
+        raise ValueError("Text must be 300 characters or less")
+
+    base_url = "https://adtr.webnova.one"
+    endpoint = f"{base_url}/translate"
+
+    payload = {
+        "user_id": user_id,
+        "api_key": api_key,
+        "text": text,
+        "target_language": target_language,
+    }
+
+    session = Session()
+    response = session.post(endpoint, json=payload)
+
+    response.raise_for_status()
+
+    data = response.json()
+    return data["result"]