convertintomp4 1.0.0__tar.gz

convertintomp4-1.0.0/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: convertintomp4
+Version: 1.0.0
+Summary: Official Python SDK for the ConvertIntoMP4 file conversion API
+Home-page: https://convertintomp4.com
+Author: ConvertIntoMP4
+Author-email: ConvertIntoMP4 <support@convertintomp4.com>
+License: MIT
+Project-URL: Homepage, https://convertintomp4.com
+Project-URL: Documentation, https://convertintomp4.com/api-docs
+Keywords: convertintomp4,file-conversion,video,audio,image,pdf,api,sdk
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video :: Conversion
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: types-requests>=2.28.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# ConvertIntoMP4 Python SDK
+
+Official Python SDK for the [ConvertIntoMP4](https://convertintomp4.com) file conversion API.
+
+## Installation
+
+```bash
+pip install convertintomp4
+```
+
+## Requirements
+
+- Python 3.8+
+- `requests` library
+
+## Quick Start
+
+```python
+from convertintomp4 import Client
+
+client = Client(api_key="your-api-key")
+
+# Quick convert a file
+with open("video.mp4", "rb") as f:
+    result = client.convert(f, "webm")
+    print(f"Job ID: {result['jobId']}")
+```
+
+## Configuration
+
+```python
+client = Client(
+    api_key="your-api-key",
+    base_url="https://api.convertintomp4.com/v1",  # default
+    sandbox=False,  # set to True for sandbox
+    timeout=30,     # request timeout in seconds
+)
+```
+
+## Usage
+
+### Job-Based Conversion
+
+```python
+job = client.create_job({
+    "tasks": {
+        "import-file": {
+            "operation": "import/url",
+            "url": "https://example.com/video.mp4",
+        },
+        "convert": {
+            "operation": "convert",
+            "input": "import-file",
+            "output_format": "webm",
+            "options": {"quality": "high"},
+        },
+        "export": {
+            "operation": "export/url",
+            "input": "convert",
+        },
+    }
+})
+
+# Wait for completion
+completed = client.wait_for_job(job.id, interval=2.0, timeout=120.0)
+print(f"Status: {completed.status}")
+```
+
+### Import from URL
+
+```python
+result = client.import_from_url(
+    "https://example.com/video.mp4",
+    target_format="webm",
+    quality="high",
+)
+```
+
+### Manage Jobs
+
+```python
+# List jobs
+result = client.list_jobs(status="completed", limit=10)
+for job in result["data"]:
+    print(f"{job.id}: {job.status}")
+
+# Get job details
+job = client.get_job("job_abc123")
+
+# Delete a job
+client.delete_job("job_abc123")
+
+# Cancel / retry
+client.cancel_job("job_abc123")
+client.retry_job("job_abc123")
+```
+
+### Download Converted File
+
+```python
+data = client.download_file("job_abc123")
+with open("output.webm", "wb") as f:
+    f.write(data)
+```
+
+### Formats
+
+```python
+formats = client.list_formats(category="video")
+options = client.get_format_options("mp4", "webm")
+```
+
+### Webhooks
+
+```python
+webhook = client.create_webhook(
+    url="https://your-app.com/webhook",
+    events=["job.completed", "job.failed"],
+    secret="your-secret",
+)
+
+webhooks = client.list_webhooks()
+client.delete_webhook(webhook.id)
+```
+
+### PDF Operations
+
+```python
+# OCR
+result = client.pdf_ocr("https://example.com/scan.pdf", language="eng")
+
+# Split
+parts = client.pdf_split("https://example.com/doc.pdf", ranges=["1-3", "4-6"])
+
+# Merge
+merged = client.pdf_merge(["https://example.com/a.pdf", "https://example.com/b.pdf"])
+
+# Encrypt / Decrypt
+client.pdf_encrypt("https://example.com/doc.pdf", password="secret")
+client.pdf_decrypt("https://example.com/doc.pdf", password="secret")
+
+# Compress
+client.pdf_compress("https://example.com/doc.pdf")
+
+# Watermark
+client.pdf_watermark("https://example.com/doc.pdf", text="DRAFT", opacity=0.3)
+
+# Extract pages
+client.pdf_extract_pages("https://example.com/doc.pdf", pages=[1, 3, 5])
+
+# Rotate
+client.pdf_rotate("https://example.com/doc.pdf", angle=90, pages=[2, 4])
+
+# Convert to PDF/A
+client.pdf_to_pdfa("https://example.com/doc.pdf")
+```
+
+## Error Handling
+
+```python
+from convertintomp4 import (
+    Client,
+    ApiError,
+    AuthenticationError,
+    RateLimitError,
+    TimeoutError,
+)
+
+try:
+    job = client.get_job("invalid-id")
+except AuthenticationError:
+    print("Invalid API key")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except TimeoutError:
+    print("Request timed out")
+except ApiError as e:
+    print(f"API error {e.status_code}: {e.code} - {e.message}")
+```
+
+## Context Manager
+
+The client can be used as a context manager to ensure the HTTP session is properly closed:
+
+```python
+with Client(api_key="your-api-key") as client:
+    job = client.create_job(...)
+```
+
+## License
+
+MIT

convertintomp4-1.0.0/README.md

@@ -0,0 +1,192 @@
+# ConvertIntoMP4 Python SDK
+
+Official Python SDK for the [ConvertIntoMP4](https://convertintomp4.com) file conversion API.
+
+## Installation
+
+```bash
+pip install convertintomp4
+```
+
+## Requirements
+
+- Python 3.8+
+- `requests` library
+
+## Quick Start
+
+```python
+from convertintomp4 import Client
+
+client = Client(api_key="your-api-key")
+
+# Quick convert a file
+with open("video.mp4", "rb") as f:
+    result = client.convert(f, "webm")
+    print(f"Job ID: {result['jobId']}")
+```
+
+## Configuration
+
+```python
+client = Client(
+    api_key="your-api-key",
+    base_url="https://api.convertintomp4.com/v1",  # default
+    sandbox=False,  # set to True for sandbox
+    timeout=30,     # request timeout in seconds
+)
+```
+
+## Usage
+
+### Job-Based Conversion
+
+```python
+job = client.create_job({
+    "tasks": {
+        "import-file": {
+            "operation": "import/url",
+            "url": "https://example.com/video.mp4",
+        },
+        "convert": {
+            "operation": "convert",
+            "input": "import-file",
+            "output_format": "webm",
+            "options": {"quality": "high"},
+        },
+        "export": {
+            "operation": "export/url",
+            "input": "convert",
+        },
+    }
+})
+
+# Wait for completion
+completed = client.wait_for_job(job.id, interval=2.0, timeout=120.0)
+print(f"Status: {completed.status}")
+```
+
+### Import from URL
+
+```python
+result = client.import_from_url(
+    "https://example.com/video.mp4",
+    target_format="webm",
+    quality="high",
+)
+```
+
+### Manage Jobs
+
+```python
+# List jobs
+result = client.list_jobs(status="completed", limit=10)
+for job in result["data"]:
+    print(f"{job.id}: {job.status}")
+
+# Get job details
+job = client.get_job("job_abc123")
+
+# Delete a job
+client.delete_job("job_abc123")
+
+# Cancel / retry
+client.cancel_job("job_abc123")
+client.retry_job("job_abc123")
+```
+
+### Download Converted File
+
+```python
+data = client.download_file("job_abc123")
+with open("output.webm", "wb") as f:
+    f.write(data)
+```
+
+### Formats
+
+```python
+formats = client.list_formats(category="video")
+options = client.get_format_options("mp4", "webm")
+```
+
+### Webhooks
+
+```python
+webhook = client.create_webhook(
+    url="https://your-app.com/webhook",
+    events=["job.completed", "job.failed"],
+    secret="your-secret",
+)
+
+webhooks = client.list_webhooks()
+client.delete_webhook(webhook.id)
+```
+
+### PDF Operations
+
+```python
+# OCR
+result = client.pdf_ocr("https://example.com/scan.pdf", language="eng")
+
+# Split
+parts = client.pdf_split("https://example.com/doc.pdf", ranges=["1-3", "4-6"])
+
+# Merge
+merged = client.pdf_merge(["https://example.com/a.pdf", "https://example.com/b.pdf"])
+
+# Encrypt / Decrypt
+client.pdf_encrypt("https://example.com/doc.pdf", password="secret")
+client.pdf_decrypt("https://example.com/doc.pdf", password="secret")
+
+# Compress
+client.pdf_compress("https://example.com/doc.pdf")
+
+# Watermark
+client.pdf_watermark("https://example.com/doc.pdf", text="DRAFT", opacity=0.3)
+
+# Extract pages
+client.pdf_extract_pages("https://example.com/doc.pdf", pages=[1, 3, 5])
+
+# Rotate
+client.pdf_rotate("https://example.com/doc.pdf", angle=90, pages=[2, 4])
+
+# Convert to PDF/A
+client.pdf_to_pdfa("https://example.com/doc.pdf")
+```
+
+## Error Handling
+
+```python
+from convertintomp4 import (
+    Client,
+    ApiError,
+    AuthenticationError,
+    RateLimitError,
+    TimeoutError,
+)
+
+try:
+    job = client.get_job("invalid-id")
+except AuthenticationError:
+    print("Invalid API key")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except TimeoutError:
+    print("Request timed out")
+except ApiError as e:
+    print(f"API error {e.status_code}: {e.code} - {e.message}")
+```
+
+## Context Manager
+
+The client can be used as a context manager to ensure the HTTP session is properly closed:
+
+```python
+with Client(api_key="your-api-key") as client:
+    job = client.create_job(...)
+```
+
+## License
+
+MIT

convertintomp4-1.0.0/convertintomp4/__init__.py

@@ -0,0 +1,49 @@
+"""ConvertIntoMP4 - Official Python SDK for the ConvertIntoMP4 file conversion API."""
+
+from .client import Client
+from .exceptions import (
+    ApiError,
+    AuthenticationError,
+    ConvertIntoMP4Error,
+    NotFoundError,
+    RateLimitError,
+    TimeoutError,
+    ValidationError,
+)
+from .types import (
+    ConversionOptions,
+    Format,
+    FormatOption,
+    Job,
+    PdfOperationResult,
+    PdfPermissions,
+    Task,
+    TaskResult,
+    TaskResultFile,
+    WaitOptions,
+    Webhook,
+)
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "Client",
+    "ApiError",
+    "AuthenticationError",
+    "ConvertIntoMP4Error",
+    "NotFoundError",
+    "RateLimitError",
+    "TimeoutError",
+    "ValidationError",
+    "ConversionOptions",
+    "Format",
+    "FormatOption",
+    "Job",
+    "PdfOperationResult",
+    "PdfPermissions",
+    "Task",
+    "TaskResult",
+    "TaskResultFile",
+    "WaitOptions",
+    "Webhook",
+]