yt-dlp-host-api 0.1.0__tar.gz

yt_dlp_host_api-0.1.0/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.1.0/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.1
+Name: yt_dlp_host_api
+Version: 0.1.0
+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](https://github.com/Vasysik/yt-dlp-host) API Client
+
+This is a Python library for interacting with the [yt-dlp-host](https://github.com/Vasysik/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.create_key("user_key", ["get_video", "get_audio", "get_info"])
+keys = client.get_keys()
+key = client.get_key("user_key")
+client.delete_key("user_key")
+```
+
+## Features
+
+- Download YouTube videos
+- Retrieve video information
+- Checking client permissions
+- Admin operations:
+  - Create new API keys
+  - List existing API keys
+  - Get API key by key name
+  - 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_live_video(url, duration, start=0, quality='best')`: Simple way to get the result of get_live_video
+- `client.get_live_audio(url, duration, start=0)`: Simple way to get the result of get_live_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)`: Initiates a get_audio task
+- `client.send_task.get_live_video(url, duration, start=0, quality='best')`: Initiates a get_video task
+- `client.send_task.get_live_audio(url, duration, start=0)`: Initiates a get_audio task
+- `client.send_task.get_info(url)`: Initiates a get_info task
+- `client.check_permissions(permissions)`: Checks for all permissions in the list
+
+### 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.create_key(name, permissions)`: Create a new API key
+- `client.get_keys()`: List all existing API keys
+- `client.get_key(name)`: Get API key by key name
+- `client.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.1.0/README.md

@@ -0,0 +1,95 @@
+# [yt-dlp-host](https://github.com/Vasysik/yt-dlp-host) API Client
+
+This is a Python library for interacting with the [yt-dlp-host](https://github.com/Vasysik/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.create_key("user_key", ["get_video", "get_audio", "get_info"])
+keys = client.get_keys()
+key = client.get_key("user_key")
+client.delete_key("user_key")
+```
+
+## Features
+
+- Download YouTube videos
+- Retrieve video information
+- Checking client permissions
+- Admin operations:
+  - Create new API keys
+  - List existing API keys
+  - Get API key by key name
+  - 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_live_video(url, duration, start=0, quality='best')`: Simple way to get the result of get_live_video
+- `client.get_live_audio(url, duration, start=0)`: Simple way to get the result of get_live_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)`: Initiates a get_audio task
+- `client.send_task.get_live_video(url, duration, start=0, quality='best')`: Initiates a get_video task
+- `client.send_task.get_live_audio(url, duration, start=0)`: Initiates a get_audio task
+- `client.send_task.get_info(url)`: Initiates a get_info task
+- `client.check_permissions(permissions)`: Checks for all permissions in the list
+
+### 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.create_key(name, permissions)`: Create a new API key
+- `client.get_keys()`: List all existing API keys
+- `client.get_key(name)`: Get API key by key name
+- `client.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.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "yt_dlp_host_api"
+version = "0.1.0"
+authors = [
+  { name="Amadeus (Wasys)", email="tubik.corp@gmail.com" },
+]
+description = "A Python library for interacting with the yt-dlp-host API"
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "requests>=2.25.1"
+]
+
+[project.urls]
+Homepage = "https://github.com/Vasysik/yt-dlp-host-api"
+Issues = "https://github.com/Vasysik/yt-dlp-host-api/issues"

yt_dlp_host_api-0.1.0/setup.cfg

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

yt_dlp_host_api-0.1.0/src/yt_dlp_host_api/__init__.py

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

yt_dlp_host_api-0.1.0/src/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-0.1.0/src/yt_dlp_host_api/client.py

@@ -0,0 +1,98 @@
+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)
+
+    def get_video(self, url, video_quality="best", audio_quality="best"):
+        return self.send_task.get_video(url=url, video_quality=video_quality, audio_quality=audio_quality).get_result()
+    
+    def get_audio(self, url, audio_quality="best"):
+        return self.send_task.get_audio(url=url, audio_quality=audio_quality).get_result()
+    
+    def get_live_video(self, url, duration, start=0, video_quality="best", audio_quality="best"):
+        return self.send_task.get_live_video(url=url, start=start, duration=duration, video_quality=video_quality, audio_quality=audio_quality).get_result()
+    
+    def get_live_audio(self, url, duration, start=0, audio_quality="best"):
+        return self.send_task.get_live_audio(url=url, start=start, duration=duration, audio_quality=audio_quality).get_result()
+    
+    def get_info(self, url):
+        return self.send_task.get_info(url=url).get_result()
+    
+    def check_permissions(self, permissions):
+        data = {"permissions": permissions}
+        response = requests.post(f"{self.host_url}/check_permissions", json=data, headers=self.headers)
+        if response.status_code != 200:
+            return False
+        return True
+    
+    def create_key(self, name, permissions, response_json=False):
+        data = {"name": name, "permissions": permissions}
+        response = requests.post(f"{self.host_url}/create_key", json=data, headers=self.headers)
+        if response.status_code != 201:
+            raise APIError(response.json().get('error', 'Unknown error'))
+        if response_json: return response.json()
+        return response.json()['key']
+
+    def delete_key(self, name):
+        response = requests.delete(f"{self.host_url}/delete_key/{name}", headers=self.headers)
+        if response.status_code != 200:
+            raise APIError(response.json().get('error', 'Unknown error'))
+        return response.json()
+    
+    def get_key(self, name, response_json=False):
+        response = requests.get(f"{self.host_url}/get_key/{name}", headers=self.headers)
+        if response.status_code != 200:
+            raise APIError(response.json().get('error', 'Unknown error'))
+        if response_json: return response.json()
+        return response.json()['key']
+
+    def get_keys(self):
+        response = requests.get(f"{self.host_url}/get_keys", headers=self.headers)
+        if response.status_code != 200:
+            raise APIError(response.json().get('error', 'Unknown error'))
+        return response.json()
+        
+    class SendTask:
+        def __init__(self, client):
+            self.client = client
+
+        def get_video(self, url, video_quality="best", audio_quality="best"):
+            data = {"url": url, "video_quality": video_quality, "audio_quality": audio_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, audio_quality="best"):
+            data = {"url": url, "audio_quality": audio_quality}
+            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_live_video(self, url, duration, start=0, video_quality="best", audio_quality="best"):
+            data = {"url": url, "start": start, "duration": duration, "video_quality": video_quality, "audio_quality": audio_quality}
+            response = requests.post(f"{self.client.host_url}/get_live_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_live_audio(self, url, duration, start=0, audio_quality="best"):
+            data = {"url": url, "start": start, "duration": duration, "audio_quality": audio_quality}
+            response = requests.post(f"{self.client.host_url}/get_live_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')

yt_dlp_host_api-0.1.0/src/yt_dlp_host_api/exceptions.py

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

yt_dlp_host_api-0.1.0/src/yt_dlp_host_api/task.py

@@ -0,0 +1,68 @@
+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, raw_response=False):
+        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'))
+        if raw_response: return response
+        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.1.0/src/yt_dlp_host_api.egg-info/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.1
+Name: yt_dlp_host_api
+Version: 0.1.0
+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](https://github.com/Vasysik/yt-dlp-host) API Client
+
+This is a Python library for interacting with the [yt-dlp-host](https://github.com/Vasysik/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.create_key("user_key", ["get_video", "get_audio", "get_info"])
+keys = client.get_keys()
+key = client.get_key("user_key")
+client.delete_key("user_key")
+```
+
+## Features
+
+- Download YouTube videos
+- Retrieve video information
+- Checking client permissions
+- Admin operations:
+  - Create new API keys
+  - List existing API keys
+  - Get API key by key name
+  - 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_live_video(url, duration, start=0, quality='best')`: Simple way to get the result of get_live_video
+- `client.get_live_audio(url, duration, start=0)`: Simple way to get the result of get_live_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)`: Initiates a get_audio task
+- `client.send_task.get_live_video(url, duration, start=0, quality='best')`: Initiates a get_video task
+- `client.send_task.get_live_audio(url, duration, start=0)`: Initiates a get_audio task
+- `client.send_task.get_info(url)`: Initiates a get_info task
+- `client.check_permissions(permissions)`: Checks for all permissions in the list
+
+### 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.create_key(name, permissions)`: Create a new API key
+- `client.get_keys()`: List all existing API keys
+- `client.get_key(name)`: Get API key by key name
+- `client.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.1.0/src/yt_dlp_host_api.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/yt_dlp_host_api/__init__.py
+src/yt_dlp_host_api/api.py
+src/yt_dlp_host_api/client.py
+src/yt_dlp_host_api/exceptions.py
+src/yt_dlp_host_api/task.py
+src/yt_dlp_host_api.egg-info/PKG-INFO
+src/yt_dlp_host_api.egg-info/SOURCES.txt
+src/yt_dlp_host_api.egg-info/dependency_links.txt
+src/yt_dlp_host_api.egg-info/requires.txt
+src/yt_dlp_host_api.egg-info/top_level.txt

yt_dlp_host_api-0.1.0/src/yt_dlp_host_api.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

yt_dlp_host_api-0.1.0/src/yt_dlp_host_api.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.1

yt_dlp_host_api-0.1.0/src/yt_dlp_host_api.egg-info/top_level.txt

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