clipdroper 0.1.0__tar.gz

clipdroper-0.1.0/LICENSE

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

clipdroper-0.1.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: clipdroper
+Version: 0.1.0
+Summary: Paste text or drop a file from your phone straight into your PC clipboard and Downloads folder, via QR code.
+Author: clipdroper contributors
+License-Expression: MIT
+Keywords: clipboard,qr,phone,lan,transfer,file,http
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Communications
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: segno>=1.6
+Requires-Dist: pyperclip>=1.8
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Dynamic: license-file
+
+# clipdroper
+
+Paste text or drop a file from your phone straight into your **PC** — clipboard and
+Downloads folder — using a QR code printed in your terminal. No accounts, no apps on the
+phone, just a browser.
+
+## How it works
+
+```
+  phone camera                      your PC
+      │  scans QR ───────────────►  clipdroper prints QR when started
+      ▼                        ┌───► ┌──────────────────────────────┐
+  phone browser opens URL      │     │  clipdroper (HTTP server)    │
+      │  POST text / file      │     │   text      → your clipboard │
+      ▼  (token-protected)     │     │   files     → ~/Downloads/…  │
+      └────────────────────────┴────► └──────────────────────────────┘
+```
+
+Your PC runs one command, prints a QR that encodes a short random token; the phone
+connect via that URL only. The token guards the inbox, so a neighbor with the token
+is the only one who can drop stuff while it runs.
+
+## Install
+
+```
+pip install clipdroper
+```
+
+## Run
+
+```
+clipdroper
+```
+
+It prints the QR and the URL, and waits:
+
+```
+clipdroper: listening on http://192.168.0.5:8124/?k=2XfQk8...
+```
+
+* Scan the QR with the phone camera → the page opens.
+* Paste text → **Send to clipboard** → it lands in the PC clipboard instantly.
+* Pick a file → **Send file** → it is saved to `~/Downloads/clipdroper/`.
+
+Options: `--port`, `--dir` (folder for files), `--token`, `--no-qr`.
+
+## Notes / security
+
+* Toy for a trusted LAN. The token is short by design — do not expose the port to the
+  internet.
+* No TLS. Clipboard works on Windows/macOS/Linux-desktop (via `pyperclip`).
+
+## Tests
+
+```
+pip install -e ".[dev]"
+pytest            # QR rendering, HTTP server, token auth, file upload
+```

clipdroper-0.1.0/README.md

@@ -0,0 +1,58 @@
+# clipdroper
+
+Paste text or drop a file from your phone straight into your **PC** — clipboard and
+Downloads folder — using a QR code printed in your terminal. No accounts, no apps on the
+phone, just a browser.
+
+## How it works
+
+```
+  phone camera                      your PC
+      │  scans QR ───────────────►  clipdroper prints QR when started
+      ▼                        ┌───► ┌──────────────────────────────┐
+  phone browser opens URL      │     │  clipdroper (HTTP server)    │
+      │  POST text / file      │     │   text      → your clipboard │
+      ▼  (token-protected)     │     │   files     → ~/Downloads/…  │
+      └────────────────────────┴────► └──────────────────────────────┘
+```
+
+Your PC runs one command, prints a QR that encodes a short random token; the phone
+connect via that URL only. The token guards the inbox, so a neighbor with the token
+is the only one who can drop stuff while it runs.
+
+## Install
+
+```
+pip install clipdroper
+```
+
+## Run
+
+```
+clipdroper
+```
+
+It prints the QR and the URL, and waits:
+
+```
+clipdroper: listening on http://192.168.0.5:8124/?k=2XfQk8...
+```
+
+* Scan the QR with the phone camera → the page opens.
+* Paste text → **Send to clipboard** → it lands in the PC clipboard instantly.
+* Pick a file → **Send file** → it is saved to `~/Downloads/clipdroper/`.
+
+Options: `--port`, `--dir` (folder for files), `--token`, `--no-qr`.
+
+## Notes / security
+
+* Toy for a trusted LAN. The token is short by design — do not expose the port to the
+  internet.
+* No TLS. Clipboard works on Windows/macOS/Linux-desktop (via `pyperclip`).
+
+## Tests
+
+```
+pip install -e ".[dev]"
+pytest            # QR rendering, HTTP server, token auth, file upload
+```

clipdroper-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "clipdroper"
+version = "0.1.0"
+description = "Paste text or drop a file from your phone straight into your PC clipboard and Downloads folder, via QR code."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "clipdroper contributors" }]
+keywords = ["clipboard", "qr", "phone", "lan", "transfer", "file", "http"]
+classifiers = [
+    "Environment :: Console",
+    "Programming Language :: Python :: 3",
+    "Topic :: Communications",
+    "Topic :: Utilities",
+]
+dependencies = ["segno>=1.6", "pyperclip>=1.8"]
+
+[project.scripts]
+clipdroper = "clipdroper.main:main"
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "ruff>=0.5"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

clipdroper-0.1.0/setup.cfg

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

clipdroper-0.1.0/src/clipdroper/__init__.py

@@ -0,0 +1,3 @@
+"""clipdroper: paste text/files from your phone into your PC."""
+
+__version__ = "0.1.0"

clipdroper-0.1.0/src/clipdroper/__main__.py

@@ -0,0 +1,4 @@
+from clipdroper.main import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

clipdroper-0.1.0/src/clipdroper/main.py

@@ -0,0 +1,43 @@
+"""clipdroper command line entry point."""
+
+from __future__ import annotations
+
+import argparse
+import os
+import secrets
+
+from clipdroper.qrterm import render_qr
+from clipdroper.server import DEFAULT_PORT, ClipDropServer
+
+
+def main(argv: list[str] | None = None) -> int:
+    import sys
+
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")  # QR block chars on any console
+    parser = argparse.ArgumentParser(prog="clipdroper", description="Paste text/file from your phone into your PC.")
+    parser.add_argument("--port", type=int, default=DEFAULT_PORT, help=f"HTTP port (default: {DEFAULT_PORT})")
+    parser.add_argument(
+        "--dir",
+        default=os.path.join(os.path.expanduser("~"), "Downloads", "clipdroper"),
+        help="folder for dropped files",
+    )
+    parser.add_argument("--token", default=None, help="override auto-generated token")
+    parser.add_argument("--no-qr", action="store_true", help="skip printing the QR code")
+    args = parser.parse_args(argv)
+
+    import pyperclip
+
+    token = args.token or secrets.token_urlsafe(8)
+    server = ClipDropServer(args.port, token, pyperclip.copy, args.dir)
+    url = server.url()
+    print(f"clipdroper: listening on {url}", flush=True)
+    if not args.no_qr:
+        print(render_qr(url), flush=True)
+    print(f"   text drops -> clipboard    files -> {server.file_dir}", flush=True)
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        print("\nstop")
+    finally:
+        server.close()
+    return 0

clipdroper-0.1.0/src/clipdroper/qrterm.py

@@ -0,0 +1,43 @@
+"""Render a QR code as Unicode half-blocks in the terminal."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+import segno
+
+_BLOCKS = {
+    (False, False): " ",
+    (True, False): "▀",
+    (False, True): "▄",
+    (True, True): "█",
+}
+
+
+def qr_matrix(content: str) -> list[list[bool]]:
+    qr = segno.make_qr(content, error="m")
+    return list(qr.matrix)
+
+
+def _padded(matrix: list[list[bool]], quiet: int = 2) -> list[list[bool]]:
+    size = len(matrix) + quiet * 2
+    rows = [[False] * size for _ in range(size)]
+    for y, row in enumerate(matrix):
+        for x, bit in enumerate(row):
+            rows[y + quiet][x + quiet] = bit
+    return rows
+
+
+def render_qr(content: str, colors: Sequence[str] = ("\033[36m", "\033[0m")) -> str:
+    """Return an ANSI-colored QR string (two terminal rows per matrix row)."""
+    grid = _padded(qr_matrix(content))
+    even_rows = grid[::2]
+    odd_rows = grid[1::2]
+    lines = []
+    fg, reset = colors
+    for up, down in zip(even_rows, odd_rows):
+        line = "".join(_BLOCKS[(a, b)] for a, b in zip(up, down))
+        lines.append(f"{fg}{line}{reset}")
+    if len(grid) % 2:
+        lines.append(f"{fg}{''.join(_BLOCKS[(a, False)] for a in grid[-1])}{reset}")
+    return "\n".join(lines)

clipdroper-0.1.0/src/clipdroper/server.py

@@ -0,0 +1,258 @@
+"""HTTP server for clipdroper: text-to-clipboard and file drops."""
+
+from __future__ import annotations
+
+import hmac
+import os
+import re
+import socket
+import time
+import urllib.parse
+from collections.abc import Callable
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+
+DEFAULT_PORT = 8124
+
+PAGE = """<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>clipdroper</title>
+<style>
+ body{margin:0;font-family:system-ui,-apple-system,sans-serif;background:#111;color:#eee;
+      display:flex;flex-direction:column;min-height:100vh;align-items:center;padding:24px 16px;}
+ .card{width:100%;max-width:420px;background:#1c1c1e;border-radius:14px;padding:18px;box-sizing:border-box;}
+ h1{font-size:20px;margin:0 0 4px;} .sub{color:#9a9a9a;font-size:13px;margin-bottom:16px;}
+ textarea{width:100%;box-sizing:border-box;min-height:110px;background:#0d0d0f;color:#eee;border:1px solid #333;
+          border-radius:8px;padding:10px;font-size:15px;font-family:inherit;resize:vertical;}
+ input[type=file]{width:100%;margin:10px 0 6px;font-size:13px;color:#ddd;}
+ button{width:100%;background:#2f6feb;color:#fff;border:0;border-radius:8px;padding:12px;
+        font-size:16px;font-weight:600;margin-top:6px;} button:active{background:#1f52b8;}
+ .sep{height:1px;background:#333;margin:20px 0;}
+ .status{margin-top:10px;font-size:14px;color:#7ad68c;min-height:20px;text-align:center;}
+ .err{color:#e57373;}
+</style>
+</head>
+<body>
+<div class="card">
+  <h1>clipdroper</h1>
+  <div class="sub">sends to your PC clipboard / Downloads</div>
+  <textarea id="text" placeholder="Paste text, then press Send"></textarea>
+  <button onclick="sendText()">Send to clipboard</button>
+  <button onclick="sendFile()" style="margin-top:8px">Send file</button>
+  <input type="file" id="file">
+  <div class="sep"></div>
+  <div class="status" id="status"></div>
+</div>
+<script>
+const token = new URLSearchParams(location.search).get('k') || '';
+function set(msg, err){const el=document.getElementById('status');el.className=err?'status err':'status';el.textContent=msg;}
+async function sendText(){
+  const text=document.getElementById('text').value;
+  if(!text.trim()){set('empty',true);return;}
+  try{
+    const r=await fetch('/api/send',{method:'POST',headers:{'Content-Type':'application/json'},
+      body:JSON.stringify({k:token,text})});
+    const d=await r.json();
+    set(d.ok?'Copied to PC clipboard':(d.error||'error'),!d.ok);
+  }catch(e){set('network error',true);}
+}
+async function sendFile(){
+  const f=document.getElementById('file').files[0];
+  if(!f){set('choose a file',true);return;}
+  const fd=new FormData(); fd.append('k',token); fd.append('file',f);
+  try{
+    const r=await fetch('/api/upload',{method:'POST',body:fd});
+    const d=await r.json();
+    set(d.ok?('Saved '+d.name):(d.error||'error'),!d.ok);
+  }catch(e){set('network error',true);}
+}
+</script>
+</body>
+</html>
+"""
+
+
+class DropHandler(BaseHTTPRequestHandler):
+    drop: ClipDropServer
+    server_version = "clipdroper/0.1"
+
+    def log_message(self, fmt: str, *args) -> None:
+        pass
+
+    def _json(self, code: int, payload: dict) -> None:
+        import json
+
+        body = json.dumps(payload, ensure_ascii=False).encode("utf-8")
+        self.send_response(code)
+        self.send_header("Content-Type", "application/json; charset=utf-8")
+        self.send_header("Content-Length", str(len(body)))
+        self.end_headers()
+        self.wfile.write(body)
+
+    def _page(self, page: str, code: int = 200) -> None:
+        body = page.encode("utf-8")
+        self.send_response(code)
+        self.send_header("Content-Type", "text/html; charset=utf-8")
+        self.send_header("Content-Length", str(len(body)))
+        self.end_headers()
+        self.wfile.write(body)
+
+    def _ok(self, token: str | None) -> bool:
+        return bool(token) and hmac.compare_digest(token, self.drop.token)
+
+    def do_GET(self) -> None:
+        url = urllib.parse.urlparse(self.path)
+        if url.path == "/":
+            self._page(PAGE)
+            return
+        self._json(404, {"error": "not found"})
+
+    def do_POST(self) -> None:
+        import json
+
+        url = urllib.parse.urlparse(self.path)
+        length = int(self.headers.get("Content-Length") or 0)
+        body = self.rfile.read(length)
+        if url.path == "/api/send":
+            try:
+                data = json.loads(body.decode("utf-8"))
+            except (ValueError, UnicodeDecodeError):
+                self._json(400, {"error": "bad json"})
+                return
+            token = data.get("k")
+            if not self._ok(token):
+                self._json(403, {"error": "bad token"})
+                return
+            text = str(data.get("text") or "").strip()
+            if not text or len(text) > 100_000:
+                self._json(400, {"error": "empty or too long"})
+                return
+            try:
+                self.drop.sink(text)
+                self._json(200, {"ok": True})
+            except Exception:  # noqa: BLE001 - any clipboard backend failure
+                self._json(500, {"error": "clipboard unavailable"})
+            return
+        if url.path == "/api/upload":
+            return self._handle_upload(body)
+        self._json(404, {"error": "not found"})
+
+    def _handle_upload(self, body: bytes) -> None:
+        ctype = self.headers.get("Content-Type") or ""
+        token, name, data = _parse_multipart(body, ctype)
+        if not self._ok(token):
+            self._json(403, {"error": "bad token"})
+            return
+        if data is None or not name:
+            self._json(400, {"error": "no file"})
+            return
+        name = _safe_name(name)
+        if len(data) > 200 * 1024 * 1024:
+            self._json(400, {"error": "too large"})
+            return
+        path = os.path.join(self.drop.file_dir, name)
+        if os.path.exists(path):
+            stem, dot, ext = name.rpartition(".")
+            path = os.path.join(self.drop.file_dir, f"{stem}-{int(time.time())}{dot + ext if dot else ''}")
+        try:
+            with open(path, "wb") as fh:
+                fh.write(data)
+        except OSError:
+            self._json(500, {"error": "cannot write"})
+            return
+        self._json(200, {"ok": True, "name": os.path.basename(path)})
+
+
+class ClipDropServer:
+    def __init__(self, port: int, token: str, sink: Callable[[str], None], file_dir: str) -> None:
+        self.token = token
+        self.sink = sink
+        self.file_dir = file_dir
+        os.makedirs(file_dir, exist_ok=True)
+        self.httpd = ThreadingHTTPServer(("0.0.0.0", port), DropHandler)
+        DropHandler.drop = self
+
+    @property
+    def port(self) -> int:
+        return self.httpd.server_address[1]
+
+    def url(self) -> str:
+        return f"http://{_lan_ip()}:{self.port}/?k={self.token}"
+
+    def serve_forever(self) -> None:
+        self.httpd.serve_forever()
+
+    def close(self) -> None:
+        self.httpd.shutdown()
+        self.httpd.server_close()
+
+
+def _lan_ip() -> str:
+    ips: set[str] = set()
+    try:
+        hostname = socket.gethostname()
+        for info in socket.getaddrinfo(hostname, None, socket.AF_INET):
+            addr = info[4][0]
+            if not addr.startswith("127."):
+                ips.add(addr)
+    except OSError:
+        pass
+    try:
+        sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        sock.connect(("8.8.8.8", 80))
+        ips.add(sock.getsockname()[0])
+        sock.close()
+    except OSError:
+        pass
+    for ip in ips:
+        if _is_private(ip):
+            return ip
+    return min(ips) if ips else "127.0.0.1"
+
+
+def _is_private(ip: str) -> bool:
+    try:
+        first = int(ip.split(".")[0])
+        second = int(ip.split(".")[1])
+    except (ValueError, IndexError):
+        return False
+    return first == 10 or first == 192 and second == 168 or first == 172 and 16 <= second <= 31
+
+
+def _safe_name(name: str) -> str:
+    name = name.replace("\\", "/").split("/")[-1]
+    return re.sub(r"[^A-Za-z0-9._() -]", "_", name).strip() or "file.bin"
+
+
+_BOUNDARY_RE = re.compile(r"boundary=(?:\"([^\"]+)\"|([^;\s]+))", re.IGNORECASE)
+_DISPOSITION_RE = re.compile(r'name="([^"]*)"(?:;\s*filename="([^"]*)")?')
+
+
+def _parse_multipart(body: bytes, content_type: str):
+    match = _BOUNDARY_RE.search(content_type)
+    if not match:
+        return None, None, None
+    boundary = (match.group(1) or match.group(2)).encode("utf-8")
+    token = None
+    name = None
+    data = None
+    for part in body.split(b"--" + boundary):
+        if b"\r\n\r\n" not in part:
+            continue
+        head, _, payload = part.partition(b"\r\n\r\n")
+        if not head.lstrip(b"\r\n").startswith(b"Content-Disposition:"):
+            continue
+        disp = head.decode("utf-8", "replace")
+        m = _DISPOSITION_RE.search(disp)
+        if not m:
+            continue
+        pname = m.group(1)
+        payload = payload.rstrip(b"\r\n")
+        if pname == "k":
+            token = payload.decode("utf-8", "replace").strip()
+        elif pname == "file":
+            name = m.group(2)
+            data = payload
+    return token, name, data

clipdroper-0.1.0/src/clipdroper.egg-info/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: clipdroper
+Version: 0.1.0
+Summary: Paste text or drop a file from your phone straight into your PC clipboard and Downloads folder, via QR code.
+Author: clipdroper contributors
+License-Expression: MIT
+Keywords: clipboard,qr,phone,lan,transfer,file,http
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Communications
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: segno>=1.6
+Requires-Dist: pyperclip>=1.8
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Dynamic: license-file
+
+# clipdroper
+
+Paste text or drop a file from your phone straight into your **PC** — clipboard and
+Downloads folder — using a QR code printed in your terminal. No accounts, no apps on the
+phone, just a browser.
+
+## How it works
+
+```
+  phone camera                      your PC
+      │  scans QR ───────────────►  clipdroper prints QR when started
+      ▼                        ┌───► ┌──────────────────────────────┐
+  phone browser opens URL      │     │  clipdroper (HTTP server)    │
+      │  POST text / file      │     │   text      → your clipboard │
+      ▼  (token-protected)     │     │   files     → ~/Downloads/…  │
+      └────────────────────────┴────► └──────────────────────────────┘
+```
+
+Your PC runs one command, prints a QR that encodes a short random token; the phone
+connect via that URL only. The token guards the inbox, so a neighbor with the token
+is the only one who can drop stuff while it runs.
+
+## Install
+
+```
+pip install clipdroper
+```
+
+## Run
+
+```
+clipdroper
+```
+
+It prints the QR and the URL, and waits:
+
+```
+clipdroper: listening on http://192.168.0.5:8124/?k=2XfQk8...
+```
+
+* Scan the QR with the phone camera → the page opens.
+* Paste text → **Send to clipboard** → it lands in the PC clipboard instantly.
+* Pick a file → **Send file** → it is saved to `~/Downloads/clipdroper/`.
+
+Options: `--port`, `--dir` (folder for files), `--token`, `--no-qr`.
+
+## Notes / security
+
+* Toy for a trusted LAN. The token is short by design — do not expose the port to the
+  internet.
+* No TLS. Clipboard works on Windows/macOS/Linux-desktop (via `pyperclip`).
+
+## Tests
+
+```
+pip install -e ".[dev]"
+pytest            # QR rendering, HTTP server, token auth, file upload
+```

clipdroper-0.1.0/src/clipdroper.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+src/clipdroper/__init__.py
+src/clipdroper/__main__.py
+src/clipdroper/main.py
+src/clipdroper/qrterm.py
+src/clipdroper/server.py
+src/clipdroper.egg-info/PKG-INFO
+src/clipdroper.egg-info/SOURCES.txt
+src/clipdroper.egg-info/dependency_links.txt
+src/clipdroper.egg-info/entry_points.txt
+src/clipdroper.egg-info/requires.txt
+src/clipdroper.egg-info/top_level.txt
+tests/test_clipdroper.py

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

@@ -0,0 +1 @@
+

clipdroper-0.1.0/src/clipdroper.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+clipdroper = clipdroper.main:main

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

@@ -0,0 +1,6 @@
+segno>=1.6
+pyperclip>=1.8
+
+[dev]
+pytest>=8.0
+ruff>=0.5

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

@@ -0,0 +1 @@
+clipdroper

clipdroper-0.1.0/tests/test_clipdroper.py

@@ -0,0 +1,118 @@
+from __future__ import annotations
+
+import json
+import threading
+from http.client import HTTPConnection
+
+import pytest
+
+from clipdroper.qrterm import render_qr
+from clipdroper.server import ClipDropServer, _parse_multipart, _safe_name
+
+
+def _free_port() -> int:
+    import socket
+
+    with socket.socket() as s:
+        s.bind(("127.0.0.1", 0))
+        return s.getsockname()[1]
+
+
+@pytest.fixture
+def server():
+    sink = []
+    srv = ClipDropServer(_free_port(), "tok123", sink.append, ".")
+    thread = threading.Thread(target=srv.serve_forever, daemon=True)
+    thread.start()
+    yield srv, sink
+    srv.close()
+
+
+def _http(srv, method, path, body=None, headers=None) -> tuple[int, bytes]:
+    conn = HTTPConnection("127.0.0.1", srv.port, timeout=5)
+    conn.request(method, path, body=body, headers=headers or {})
+    resp = conn.getresponse()
+    data = resp.read()
+    conn.close()
+    return resp.status, data
+
+
+def test_qr_renders_blocks():
+    out = render_qr("http://127.0.0.1:9/?k=x", colors=("", ""))
+    assert "▀" in out or "█" in out or "▄" in out
+    assert len(out.splitlines()) > 5
+
+
+def test_page_served(server):
+    srv, _ = server
+    status, body = _http(srv, "GET", "/")
+    assert status == 200
+    assert b"clipdroper" in body
+
+
+def test_send_text_to_sink(server):
+    srv, sink = server
+    status, body = _http(
+        srv, "POST", "/api/send", body=json.dumps({"k": "tok123", "text": "hello clip"}).encode("utf-8")
+    )
+    assert status == 200
+    assert json.loads(body)["ok"] is True
+    assert sink == ["hello clip"]
+
+
+def test_send_bad_token(server):
+    srv, _ = server
+    status, _ = _http(srv, "POST", "/api/send", body=json.dumps({"k": "nope", "text": "x"}).encode("utf-8"))
+    assert status == 403
+
+
+def test_upload_file(server):
+    srv, _ = server
+    import os
+
+    boundary = "bnd123"
+    payload = (
+        f"--{boundary}\r\n"
+        'Content-Disposition: form-data; name="k"\r\n\r\n'
+        "tok123\r\n"
+        f"--{boundary}\r\n"
+        'Content-Disposition: form-data; name="file"; filename="hi.txt"\r\n'
+        "Content-Type: text/plain\r\n\r\n"
+        "file body\r\n"
+        f"--{boundary}--\r\n"
+    ).encode()
+    status, body = _http(
+        srv,
+        "POST",
+        "/api/upload",
+        body=payload,
+        headers={"Content-Type": f"multipart/form-data; boundary={boundary}"},
+    )
+    assert status == 200
+    saved = json.loads(body)["name"]
+    with open(saved, encoding="utf-8") as fh:
+        assert fh.read() == "file body"
+    os.remove(saved)
+
+
+def test_parse_multipart():
+    boundary = "abc"
+    body = (
+        f"--{boundary}\r\n"
+        'Content-Disposition: form-data; name="k"\r\n\r\n'
+        "t1\r\n"
+        f"--{boundary}\r\n"
+        'Content-Disposition: form-data; name="file"; filename="a b.txt"\r\n\r\n'
+        "data\r\n"
+        f"--{boundary}--\r\n"
+    ).encode()
+    token, name, data = _parse_multipart(body, f"multipart/form-data; boundary={boundary}")
+    assert token == "t1"
+    assert name == "a b.txt"
+    assert data == b"data"
+
+
+def test_safe_name():
+    assert _safe_name("..\\..\\evil.txt") == "evil.txt"
+    assert _safe_name("bad/name?.txt") == "name_.txt"
+    assert _safe_name("   ") == "file.bin"