meowbox 1.0.0__tar.gz

meowbox-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 @BadmundaXd
+
+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.

meowbox-1.0.0/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: meowbox
+Version: 1.0.0
+Summary: MeowBox — Permanent file hosting uploader (sync & async)
+Author-email: BadmundaXd <munda.bad1322@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Badmunda05/MeowBox
+Project-URL: Source, https://github.com/Badmunda05/MeowBox
+Project-URL: Telegram, https://t.me/BadmundaXd
+Keywords: meowbox,upload,file hosting,async,httpx
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: httpx
+Provides-Extra: async
+Requires-Dist: httpx; extra == "async"
+Dynamic: license-file
+
+# MeowBox Python Library 📦
+
+> **Permanent file hosting — files never expire.**
+> By [@BadmundaXd](https://t.me/BadmundaXd) | [GitHub](https://github.com/Badmunda05/MeowBox)
+
+Python library for uploading files to [MeowBox](https://files.tgvibes.online) — supports both sync and async.
+
+---
+
+## Install
+
+```bash
+pip install meowbox
+```
+
+---
+
+## Quick Start
+
+### Sync upload
+```python
+from meowbox import upload
+
+urls = upload("photo.jpg")
+print(urls[0])
+# https://files.tgvibes.online/AbCdEfGh.jpg
+```
+
+### Async upload (httpx)
+```python
+from meowbox import upload_async
+
+urls = await upload_async("photo.jpg")
+print(urls[0])
+```
+
+### Class-based
+```python
+from meowbox import MeowBox
+
+mb = MeowBox()
+
+# Sync
+urls = mb.upload("photo.jpg")
+
+# Async
+urls = await mb.upload_async("photo.jpg")
+```
+
+### Upload multiple files
+```python
+from meowbox import upload
+
+urls = upload(["file1.jpg", "file2.mp4", "file3.pdf"])
+for url in urls:
+    print(url)
+```
+
+### Upload file object (e.g. Telegram Bot)
+```python
+from meowbox import upload_async
+
+path = await message.download()
+urls = await upload_async(path)
+await message.reply(urls[0])
+```
+
+---
+
+## Telegram Bot Example
+
+```python
+from meowbox import upload_async
+import os
+
+async def upload_handler(message):
+    if not message.reply_to_message or not message.reply_to_message.media:
+        await message.reply("Reply to a file!")
+        return
+
+    path = await message.reply_to_message.download()
+    try:
+        urls = await upload_async(path)
+        await message.reply(f"✅ {urls[0]}")
+    except Exception as e:
+        await message.reply(f"❌ Upload failed: {e}")
+    finally:
+        if os.path.exists(path):
+            os.remove(path)
+```
+
+---
+
+## Exceptions
+
+| Exception | When |
+|-----------|------|
+| `UploadError` | Upload failed (server error) |
+| `RateLimitError` | Too many uploads |
+| `MeowBoxException` | Base exception |
+
+```python
+from meowbox import upload
+from meowbox.exceptions import UploadError, RateLimitError
+
+try:
+    urls = upload("file.jpg")
+except RateLimitError as e:
+    print(f"Slow down! Retry after {e.retry_after}s")
+except UploadError as e:
+    print(f"Upload failed: {e}")
+```
+
+---
+
+## API Reference
+
+### `upload(f, base_url=...) -> list[str]`
+Sync upload. `f` = path, file object, or list of either.
+
+### `upload_async(f, base_url=...) -> list[str]`
+Async upload using httpx.
+
+### `MeowBox(base_url=...)`
+Class with `.upload()` and `.upload_async()` methods.
+
+---
+
+## Links
+
+- 🌐 Site: [files.tgvibes.online](https://files.tgvibes.online)
+- 💬 Telegram: [@BadmundaXd](https://t.me/BadmundaXd)
+- 📦 Repo: [github.com/Badmunda05/MeowBox](https://github.com/Badmunda05/MeowBox)

meowbox-1.0.0/README.md

@@ -0,0 +1,133 @@
+# MeowBox Python Library 📦
+
+> **Permanent file hosting — files never expire.**
+> By [@BadmundaXd](https://t.me/BadmundaXd) | [GitHub](https://github.com/Badmunda05/MeowBox)
+
+Python library for uploading files to [MeowBox](https://files.tgvibes.online) — supports both sync and async.
+
+---
+
+## Install
+
+```bash
+pip install meowbox
+```
+
+---
+
+## Quick Start
+
+### Sync upload
+```python
+from meowbox import upload
+
+urls = upload("photo.jpg")
+print(urls[0])
+# https://files.tgvibes.online/AbCdEfGh.jpg
+```
+
+### Async upload (httpx)
+```python
+from meowbox import upload_async
+
+urls = await upload_async("photo.jpg")
+print(urls[0])
+```
+
+### Class-based
+```python
+from meowbox import MeowBox
+
+mb = MeowBox()
+
+# Sync
+urls = mb.upload("photo.jpg")
+
+# Async
+urls = await mb.upload_async("photo.jpg")
+```
+
+### Upload multiple files
+```python
+from meowbox import upload
+
+urls = upload(["file1.jpg", "file2.mp4", "file3.pdf"])
+for url in urls:
+    print(url)
+```
+
+### Upload file object (e.g. Telegram Bot)
+```python
+from meowbox import upload_async
+
+path = await message.download()
+urls = await upload_async(path)
+await message.reply(urls[0])
+```
+
+---
+
+## Telegram Bot Example
+
+```python
+from meowbox import upload_async
+import os
+
+async def upload_handler(message):
+    if not message.reply_to_message or not message.reply_to_message.media:
+        await message.reply("Reply to a file!")
+        return
+
+    path = await message.reply_to_message.download()
+    try:
+        urls = await upload_async(path)
+        await message.reply(f"✅ {urls[0]}")
+    except Exception as e:
+        await message.reply(f"❌ Upload failed: {e}")
+    finally:
+        if os.path.exists(path):
+            os.remove(path)
+```
+
+---
+
+## Exceptions
+
+| Exception | When |
+|-----------|------|
+| `UploadError` | Upload failed (server error) |
+| `RateLimitError` | Too many uploads |
+| `MeowBoxException` | Base exception |
+
+```python
+from meowbox import upload
+from meowbox.exceptions import UploadError, RateLimitError
+
+try:
+    urls = upload("file.jpg")
+except RateLimitError as e:
+    print(f"Slow down! Retry after {e.retry_after}s")
+except UploadError as e:
+    print(f"Upload failed: {e}")
+```
+
+---
+
+## API Reference
+
+### `upload(f, base_url=...) -> list[str]`
+Sync upload. `f` = path, file object, or list of either.
+
+### `upload_async(f, base_url=...) -> list[str]`
+Async upload using httpx.
+
+### `MeowBox(base_url=...)`
+Class with `.upload()` and `.upload_async()` methods.
+
+---
+
+## Links
+
+- 🌐 Site: [files.tgvibes.online](https://files.tgvibes.online)
+- 💬 Telegram: [@BadmundaXd](https://t.me/BadmundaXd)
+- 📦 Repo: [github.com/Badmunda05/MeowBox](https://github.com/Badmunda05/MeowBox)

meowbox-1.0.0/meowbox/__init__.py

@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+"""
+MeowBox — Permanent File Hosting Python Library
+Repo   : https://github.com/Badmunda05/MeowBox
+Author : @BadmundaXd
+
+Quick start:
+    from meowbox import upload
+    urls = upload("photo.jpg")
+    print(urls[0])
+
+Async:
+    from meowbox import MeowBox
+    mb = MeowBox()
+    urls = await mb.upload_async("photo.jpg")
+"""
+
+__version__ = "1.0.0"
+__author__  = "@BadmundaXd"
+__repo__    = "https://github.com/Badmunda05/MeowBox"
+
+from .meowbox import MeowBox, upload
+from .meowbox_async import upload_async
+from .exceptions import MeowBoxException, UploadError, RateLimitError, DeleteError
+
+__all__ = [
+    "MeowBox",
+    "upload",
+    "upload_async",
+    "MeowBoxException",
+    "UploadError",
+    "RateLimitError",
+    "DeleteError",
+]

meowbox-1.0.0/meowbox/exceptions.py

@@ -0,0 +1,13 @@
+class MeowBoxException(Exception):
+    pass
+
+class RateLimitError(MeowBoxException):
+    def __init__(self, retry_after: int = 60):
+        self.retry_after = retry_after
+        super().__init__(f"Rate limit hit. Retry after {retry_after} seconds.")
+
+class UploadError(MeowBoxException):
+    pass
+
+class DeleteError(MeowBoxException):
+    pass

meowbox-1.0.0/meowbox/meowbox.py

@@ -0,0 +1,113 @@
+# -*- coding: utf-8 -*-
+"""
+MeowBox — Permanent File Hosting
+Repo   : https://github.com/Badmunda05/MeowBox
+Author : @BadmundaXd <munda.bad1322@gmail.com>
+"""
+
+import os
+import requests
+from .exceptions import MeowBoxException, UploadError, RateLimitError, DeleteError
+
+MEOWBOX_URL = "https://files.tgvibes.online/upload"
+
+
+# ─────────────────────────────────────────────
+#  MeowBox Class (sync)
+# ─────────────────────────────────────────────
+
+class MeowBox:
+    """
+    MeowBox uploader — sync + async support.
+
+    Usage (sync):
+        from meowbox import MeowBox
+        mb = MeowBox()
+        urls = mb.upload("photo.jpg")
+        print(urls[0])
+
+    Usage (async):
+        from meowbox import MeowBox
+        mb = MeowBox()
+        urls = await mb.upload_async("photo.jpg")
+        print(urls[0])
+    """
+
+    def __init__(self, base_url: str = MEOWBOX_URL):
+        self.base_url = base_url
+
+    def upload(self, f) -> list:
+        """Upload file(s) to MeowBox. Returns list of direct URLs."""
+        return upload(f, base_url=self.base_url)
+
+    async def upload_async(self, f) -> list:
+        """Async upload file(s) to MeowBox. Returns list of direct URLs."""
+        from .meowbox_async import upload_async
+        return await upload_async(f, base_url=self.base_url)
+
+    def __repr__(self):
+        return f"MeowBox(url={self.base_url!r})"
+
+
+# ─────────────────────────────────────────────
+#  Sync functions
+# ─────────────────────────────────────────────
+
+def upload(f, base_url: str = MEOWBOX_URL) -> list:
+    """
+    Upload file(s) to MeowBox (sync).
+
+    Args:
+        f: File path (str), file object, or list of either.
+        base_url: MeowBox upload endpoint.
+
+    Returns:
+        list of direct URLs (str).
+
+    Raises:
+        UploadError: If upload fails.
+        RateLimitError: If rate limited.
+
+    Example:
+        from meowbox import upload
+        urls = upload("photo.jpg")
+        print(urls[0])  # https://files.tgvibes.online/AbCdEfGh.jpg
+    """
+    files_input = [f] if not isinstance(f, (list, tuple)) else list(f)
+    urls = []
+
+    for item in files_input:
+        if isinstance(item, str):
+            filename = os.path.basename(item)
+            fobj = open(item, "rb")
+            opened = True
+        else:
+            filename = getattr(item, "name", "upload")
+            fobj = item
+            opened = False
+
+        try:
+            resp = requests.post(
+                base_url,
+                files={"files[]": (filename, fobj)},
+                timeout=120,
+            )
+        finally:
+            if opened:
+                fobj.close()
+
+        if resp.status_code == 429:
+            raise RateLimitError()
+
+        try:
+            data = resp.json()
+        except Exception:
+            raise UploadError(f"Invalid response (HTTP {resp.status_code}): {resp.text[:200]}")
+
+        if not data.get("success"):
+            raise UploadError(f"Upload failed: {data.get('description', 'Unknown error')}")
+
+        for file_info in data.get("files", []):
+            urls.append(file_info["url"])
+
+    return urls

meowbox-1.0.0/meowbox/meowbox_async.py

@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+"""
+MeowBox — Async uploader (httpx)
+Repo   : https://github.com/Badmunda05/MeowBox
+Author : @BadmundaXd <munda.bad1322@gmail.com>
+"""
+
+import os
+from .exceptions import UploadError, RateLimitError
+
+MEOWBOX_URL = "https://files.tgvibes.online/upload"
+
+
+async def upload_async(f, base_url: str = MEOWBOX_URL) -> list:
+    """
+    Async upload file(s) to MeowBox using httpx.
+
+    Args:
+        f: File path (str), file object, or list of either.
+        base_url: MeowBox upload endpoint.
+
+    Returns:
+        list of direct URLs (str).
+
+    Raises:
+        UploadError: If upload fails.
+        RateLimitError: If rate limited.
+
+    Example:
+        from meowbox.meowbox_async import upload_async
+        urls = await upload_async("photo.jpg")
+        print(urls[0])  # https://files.tgvibes.online/AbCdEfGh.jpg
+    """
+    try:
+        import httpx
+    except ImportError:
+        raise ImportError("httpx is required: pip install httpx")
+
+    files_input = [f] if not isinstance(f, (list, tuple)) else list(f)
+    urls = []
+
+    async with httpx.AsyncClient(timeout=120) as client:
+        for item in files_input:
+            if isinstance(item, str):
+                filename = os.path.basename(item)
+                fobj = open(item, "rb")
+                opened = True
+            else:
+                filename = getattr(item, "name", "upload")
+                fobj = item
+                opened = False
+
+            try:
+                resp = await client.post(
+                    base_url,
+                    files={"files[]": (filename, fobj)},
+                )
+            finally:
+                if opened:
+                    fobj.close()
+
+            if resp.status_code == 429:
+                raise RateLimitError()
+
+            try:
+                data = resp.json()
+            except Exception:
+                raise UploadError(f"Invalid response (HTTP {resp.status_code}): {resp.text[:200]}")
+
+            if not data.get("success"):
+                raise UploadError(f"Upload failed: {data.get('description', 'Unknown error')}")
+
+            for file_info in data.get("files", []):
+                urls.append(file_info["url"])
+
+    return urls

meowbox-1.0.0/meowbox.egg-info/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: meowbox
+Version: 1.0.0
+Summary: MeowBox — Permanent file hosting uploader (sync & async)
+Author-email: BadmundaXd <munda.bad1322@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Badmunda05/MeowBox
+Project-URL: Source, https://github.com/Badmunda05/MeowBox
+Project-URL: Telegram, https://t.me/BadmundaXd
+Keywords: meowbox,upload,file hosting,async,httpx
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: httpx
+Provides-Extra: async
+Requires-Dist: httpx; extra == "async"
+Dynamic: license-file
+
+# MeowBox Python Library 📦
+
+> **Permanent file hosting — files never expire.**
+> By [@BadmundaXd](https://t.me/BadmundaXd) | [GitHub](https://github.com/Badmunda05/MeowBox)
+
+Python library for uploading files to [MeowBox](https://files.tgvibes.online) — supports both sync and async.
+
+---
+
+## Install
+
+```bash
+pip install meowbox
+```
+
+---
+
+## Quick Start
+
+### Sync upload
+```python
+from meowbox import upload
+
+urls = upload("photo.jpg")
+print(urls[0])
+# https://files.tgvibes.online/AbCdEfGh.jpg
+```
+
+### Async upload (httpx)
+```python
+from meowbox import upload_async
+
+urls = await upload_async("photo.jpg")
+print(urls[0])
+```
+
+### Class-based
+```python
+from meowbox import MeowBox
+
+mb = MeowBox()
+
+# Sync
+urls = mb.upload("photo.jpg")
+
+# Async
+urls = await mb.upload_async("photo.jpg")
+```
+
+### Upload multiple files
+```python
+from meowbox import upload
+
+urls = upload(["file1.jpg", "file2.mp4", "file3.pdf"])
+for url in urls:
+    print(url)
+```
+
+### Upload file object (e.g. Telegram Bot)
+```python
+from meowbox import upload_async
+
+path = await message.download()
+urls = await upload_async(path)
+await message.reply(urls[0])
+```
+
+---
+
+## Telegram Bot Example
+
+```python
+from meowbox import upload_async
+import os
+
+async def upload_handler(message):
+    if not message.reply_to_message or not message.reply_to_message.media:
+        await message.reply("Reply to a file!")
+        return
+
+    path = await message.reply_to_message.download()
+    try:
+        urls = await upload_async(path)
+        await message.reply(f"✅ {urls[0]}")
+    except Exception as e:
+        await message.reply(f"❌ Upload failed: {e}")
+    finally:
+        if os.path.exists(path):
+            os.remove(path)
+```
+
+---
+
+## Exceptions
+
+| Exception | When |
+|-----------|------|
+| `UploadError` | Upload failed (server error) |
+| `RateLimitError` | Too many uploads |
+| `MeowBoxException` | Base exception |
+
+```python
+from meowbox import upload
+from meowbox.exceptions import UploadError, RateLimitError
+
+try:
+    urls = upload("file.jpg")
+except RateLimitError as e:
+    print(f"Slow down! Retry after {e.retry_after}s")
+except UploadError as e:
+    print(f"Upload failed: {e}")
+```
+
+---
+
+## API Reference
+
+### `upload(f, base_url=...) -> list[str]`
+Sync upload. `f` = path, file object, or list of either.
+
+### `upload_async(f, base_url=...) -> list[str]`
+Async upload using httpx.
+
+### `MeowBox(base_url=...)`
+Class with `.upload()` and `.upload_async()` methods.
+
+---
+
+## Links
+
+- 🌐 Site: [files.tgvibes.online](https://files.tgvibes.online)
+- 💬 Telegram: [@BadmundaXd](https://t.me/BadmundaXd)
+- 📦 Repo: [github.com/Badmunda05/MeowBox](https://github.com/Badmunda05/MeowBox)

meowbox-1.0.0/meowbox.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+meowbox/__init__.py
+meowbox/exceptions.py
+meowbox/meowbox.py
+meowbox/meowbox_async.py
+meowbox.egg-info/PKG-INFO
+meowbox.egg-info/SOURCES.txt
+meowbox.egg-info/dependency_links.txt
+meowbox.egg-info/requires.txt
+meowbox.egg-info/top_level.txt

meowbox-1.0.0/meowbox.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

meowbox-1.0.0/meowbox.egg-info/requires.txt

@@ -0,0 +1,5 @@
+requests
+httpx
+
+[async]
+httpx

meowbox-1.0.0/meowbox.egg-info/top_level.txt

@@ -0,0 +1 @@
+meowbox

meowbox-1.0.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "meowbox"
+dynamic = ["version", "readme"]
+description = "MeowBox — Permanent file hosting uploader (sync & async)"
+requires-python = ">=3.7"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "BadmundaXd", email = "munda.bad1322@gmail.com" }
+]
+keywords = ["meowbox", "upload", "file hosting", "async", "httpx"]
+classifiers = [
+  "Operating System :: OS Independent",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3",
+]
+dependencies = ["requests", "httpx"]
+
+[project.optional-dependencies]
+async = ["httpx"]
+
+[project.urls]
+Homepage = "https://github.com/Badmunda05/MeowBox"
+Source   = "https://github.com/Badmunda05/MeowBox"
+Telegram = "https://t.me/BadmundaXd"
+
+[tool.setuptools]
+packages = ["meowbox"]
+
+[tool.setuptools.dynamic]
+version = { attr = "meowbox.__version__" }
+readme  = { file = ["README.md"], content-type = "text/markdown" }

meowbox-1.0.0/setup.cfg

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