yt-dlp-host-api 0.0.1__py3-none-any.whl

yt_dlp_host_api/__init__.py

@@ -0,0 +1,2 @@
+from .api import api
+__all__ = ['api']

yt_dlp_host_api/api.py

@@ -0,0 +1,8 @@
+from .client import Client
+
+class api:
+    def __init__(self, host_url):
+        self.host_url = host_url
+
+    def get_client(self, api_key):
+        return Client(self.host_url, api_key)

yt_dlp_host_api/client.py

@@ -0,0 +1,68 @@
+import requests
+from .task import Task
+from .exceptions import APIError
+
+class Client:
+    def __init__(self, host_url, api_key):
+        self.host_url = host_url
+        self.api_key = api_key
+        self.headers = {"X-API-Key": api_key, "Content-Type": "application/json"}
+        self.send_task = self.SendTask(self)
+        self.admin = self.Admin(self)
+
+    def get_video(self, url, quality="best"):
+        return self.send_task.get_video(url=url, quality=quality).get_result()
+    
+    def get_audio(self, url):
+        return self.send_task.get_audio(url=url).get_result()
+    
+    def get_info(self, url):
+        return self.send_task.get_info(url=url).get_result()
+
+    class SendTask:
+        def __init__(self, client):
+            self.client = client
+
+        def get_video(self, url, quality="best"):
+            data = {"url": url, "quality": quality}
+            response = requests.post(f"{self.client.host_url}/get_video", json=data, headers=self.client.headers)
+            if response.status_code != 200:
+                raise APIError(response.json().get('error', 'Unknown error'))
+            return Task(self.client, response.json()['task_id'], 'get_video')
+        
+        def get_audio(self, url):
+            data = {"url": url}
+            response = requests.post(f"{self.client.host_url}/get_audio", json=data, headers=self.client.headers)
+            if response.status_code != 200:
+                raise APIError(response.json().get('error', 'Unknown error'))
+            return Task(self.client, response.json()['task_id'], 'get_audio')
+
+        def get_info(self, url):
+            data = {"url": url}
+            response = requests.post(f"{self.client.host_url}/get_info", json=data, headers=self.client.headers)
+            if response.status_code != 200:
+                raise APIError(response.json().get('error', 'Unknown error'))
+            return Task(self.client, response.json()['task_id'], 'get_info')
+        
+    class Admin:
+        def __init__(self, client):
+            self.client = client
+
+        def create_key(self, name, permissions):
+            data = {"name": name, "permissions": permissions}
+            response = requests.post(f"{self.client.host_url}/create_key", json=data, headers=self.client.headers)
+            if response.status_code != 201:
+                raise APIError(response.json().get('error', 'Unknown error'))
+            return response.json()
+
+        def delete_key(self, name):
+            response = requests.delete(f"{self.client.host_url}/delete_key/{name}", headers=self.client.headers)
+            if response.status_code != 200:
+                raise APIError(response.json().get('error', 'Unknown error'))
+            return response.json()
+
+        def list_keys(self):
+            response = requests.get(f"{self.client.host_url}/list_keys", headers=self.client.headers)
+            if response.status_code != 200:
+                raise APIError(response.json().get('error', 'Unknown error'))
+            return response.json()

yt_dlp_host_api/exceptions.py

@@ -0,0 +1,2 @@
+class APIError(Exception):
+    pass

yt_dlp_host_api/task.py

@@ -0,0 +1,67 @@
+import requests
+import json
+import time
+from .exceptions import APIError
+
+class Task:
+    def __init__(self, client, task_id, task_type):
+        self.client = client
+        self.task_id = task_id
+        self.task_type = task_type
+
+    def get_status(self):
+        response = requests.get(f"{self.client.host_url}/status/{self.task_id}", headers=self.client.headers)
+        if response.status_code != 200:
+            raise APIError(response.json().get('error', 'Unknown error'))
+        return response.json()
+
+    def get_result(self, max_retries=360, delay=1):
+        for _ in range(max_retries):
+            status = self.get_status()
+            if status['status'] == 'completed':
+                return TaskResult(self.client, status)
+            elif status['status'] == 'error':
+                raise APIError(f"Task failed: {status.get('error', 'Unknown error')}")
+            elif status['status'] in ['waiting', 'processing']:
+                time.sleep(delay)
+            else:
+                raise APIError(f"Unknown task status: {status['status']}")
+        
+        raise APIError(f"Task did not complete within the expected time (waited {max_retries * delay} seconds)")
+
+class TaskResult:
+    def __init__(self, client, status):
+        self.client = client
+        self.status = status
+
+    def get_file(self):
+        url = self.get_file_url()
+        response = requests.get(url, headers=self.client.headers)
+        if response.status_code != 200:
+            raise APIError(response.json().get('error', 'Unknown error'))
+        return response.content
+
+    def get_file_url(self):
+        return f"{self.client.host_url}{self.status['file']}"
+
+    def save_file(self, path):
+        url = self.get_file_url()
+        response = requests.get(url, headers=self.client.headers)
+        if response.status_code != 200:
+            raise APIError(response.json().get('error', 'Unknown error'))
+        with open(path, 'wb') as f:
+            f.write(response.content)
+
+    def get_json(self, fields=None):
+        if self.status['task_type'] != 'get_info':
+            raise APIError("This method is only available for get_info tasks")
+        url = self.get_file_url()
+        if fields:
+            url += "?"
+            for field in fields:
+                url += f'{field}&'
+        response = requests.get(url, headers=self.client.headers)
+        if response.status_code != 200:
+            raise APIError(response.json().get('error', 'Unknown error'))
+        data = json.loads(response.text)
+        return data

yt_dlp_host_api-0.0.1.dist-info/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2024 yt-dlp-host-api
+
+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.

yt_dlp_host_api-0.0.1.dist-info/METADATA

@@ -0,0 +1,101 @@
+Metadata-Version: 2.1
+Name: yt_dlp_host_api
+Version: 0.0.1
+Summary: A Python library for interacting with the yt-dlp-host API
+Author-email: "Amadeus (Wasys)" <tubik.corp@gmail.com>
+Project-URL: Homepage, https://github.com/Vasysik/yt-dlp-host-api
+Project-URL: Issues, https://github.com/Vasysik/yt-dlp-host-api/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests >=2.25.1
+
+# yt-dlp-host API Client
+
+This is a Python library for interacting with the yt-dlp-host API.
+
+## Installation
+
+You can install the library using pip:
+
+```
+pip install yt-dlp-host-api
+```
+
+## Usage
+
+Here's a basic example of how to use the library:
+
+```python
+import yt_dlp_host_api
+
+# Initialize the API client
+api = yt_dlp_host_api.api('http://your-api-url.com')
+client = api.get_client('YOUR_API_KEY')
+
+# Download a video
+client.get_video(url='https://youtu.be/1FPdtR_5KFo').save_file("test_video.mp4")
+print("Video saved to test_video.mp4")
+
+# Download a audio
+client.get_audio(url='https://youtu.be/1FPdtR_5KFo').save_file("test_audio.mp3")
+print("Audio saved to test_audio.mp3")
+
+# Get info
+info_json = client.get_info(url='https://youtu.be/1FPdtR_5KFo').get_json(['qualities', 'title'])
+print("Video info:", info_json)
+
+# Admin operations (requires admin API key)
+new_key = client.admin.create_key("user_key", ["get_video", "get_info"])
+keys = client.admin.list_keys()
+client.admin.delete_key("user_key")
+```
+
+## Features
+
+- Download YouTube videos
+- Retrieve video information
+- Admin operations:
+  - Create new API keys
+  - List existing API keys
+  - Delete API keys
+
+## API Reference
+
+### Client
+
+- `client.get_video(url, quality='best')`: Simple way to get the result of get_video
+- `client.get_audio(url)`: Simple way to get the result of get_audio
+- `client.get_info(url)`: Simple way to get the result of get_info
+- `client.send_task.get_video(url, quality='best')`: Initiates a get_video task
+- `client.send_task.get_audio(url, quality='best')`: Initiates a get_audio task
+- `client.send_task.get_info(url)`: Initiates a get_info task
+
+### Task
+
+- `task.get_status()`: Get the current status of a task
+- `task.get_result()`: Wait for and return the result of a task
+
+### TaskResult
+
+- `result.get_file()`: Get the file
+- `result.get_file_url()`: Get the URL of the downloaded file
+- `result.save_file(path)`: Save the downloaded file to the specified path
+- `result.get_json(fields=None)`: Get the JSON data for info tasks (optionally filtered by fields)
+
+### Admin
+
+- `client.admin.create_key(name, permissions)`: Create a new API key
+- `client.admin.list_keys()`: List all existing API keys
+- `client.admin.delete_key(name)`: Delete an API key
+
+## Error Handling
+
+The library uses exceptions to handle errors. Catch `yt_dlp_host_api.exceptions.APIError` to handle API-related errors.
+
+## Contributing
+
+Contributions to yt-dlp-host-api are welcome! If you have any suggestions, bug reports, or feature requests, please open an issue on the GitHub repository. Pull requests are also encouraged.

yt_dlp_host_api-0.0.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+yt_dlp_host_api/__init__.py,sha256=RHx1BvH2Cy_dweEKo5sA-hdBOfBdY_2ds7srPuKGzWQ,41
+yt_dlp_host_api/api.py,sha256=iLzWKoyiXeu0Y1Uky8PzpxxHTSMcTGzxlCRT121AKcM,196
+yt_dlp_host_api/client.py,sha256=WhwA4kg7mTelvqW9pB4Xpzif4LMM3lWNjiTvBfmh74M,3094
+yt_dlp_host_api/exceptions.py,sha256=U_70W1R_ZcUfKptUShGB5VPWQXwc5M29_sNC8pwwq8g,38
+yt_dlp_host_api/task.py,sha256=aS96ZZik0rRiLwLx1mXm9GeF9lgEOOkCW-Qp-gHmgCo,2612
+yt_dlp_host_api-0.0.1.dist-info/LICENSE,sha256=-_Ad_xue4UymJ8jO-ZsSg0vmZ6SUm8WYdoEwHLyBUlc,1078
+yt_dlp_host_api-0.0.1.dist-info/METADATA,sha256=DmsLsNzCkfvRvnvJlxB1soZl2qFis-g4YfNmmkNKAsQ,3293
+yt_dlp_host_api-0.0.1.dist-info/WHEEL,sha256=UvcQYKBHoFqaQd6LKyqHw9fxEolWLQnlzP0h_LgJAfI,91
+yt_dlp_host_api-0.0.1.dist-info/top_level.txt,sha256=Mn3FZuqLCHr47sRjhtEOz7lDl4lpsHkymWANORYp72s,16
+yt_dlp_host_api-0.0.1.dist-info/RECORD,,

yt_dlp_host_api-0.0.1.dist-info/WHEEL

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

yt_dlp_host_api-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+yt_dlp_host_api