uvero 0.1.0__tar.gz

uvero-0.1.0/LICENSE

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

uvero-0.1.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: uvero
+Version: 0.1.0
+Summary: Uvero CLI – online clipboard from your terminal
+Author-email: Uvero <support@uvero.app>
+License-Expression: MIT
+Project-URL: Homepage, https://uvero.app
+Project-URL: Repository, https://github.com/sakethdevx/uvero-cli
+Project-URL: Bug Tracker, https://github.com/sakethdevx/uvero-cli/issues
+Keywords: clipboard,cli,terminal,online clipboard,paste,share
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+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 :: Utilities
+Classifier: Topic :: Internet
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: pyperclip>=1.8.0
+Requires-Dist: rich>=13.0.0
+Dynamic: license-file
+
+# uvero-cli
+
+**Uvero** is an online clipboard service. This CLI lets you interact with it directly from your terminal.
+
+## Installation
+
+```bash
+pip install uvero
+```
+
+## Usage
+
+### Send content
+
+```bash
+# Interactive paste mode (CTRL+D to finish)
+uvero send
+
+# Send a file
+uvero send notes.txt
+
+# Send system clipboard contents
+uvero send -
+
+# Pipe data
+cat log.txt | uvero send
+```
+
+### Retrieve content
+
+```bash
+# Save to uvero_4832.txt
+uvero get 4832
+
+# Save to a specific file
+uvero get 4832 notes.txt
+
+# Copy directly to system clipboard
+uvero get 4832 -c
+```
+
+### Boards (private shared clipboards)
+
+```bash
+# Create a board
+uvero board create
+
+# Send to a board
+uvero board send abcd-def notes.txt
+uvero board send abcd-def   # interactive paste mode
+
+# Get board content
+uvero board get abcd-def
+```
+
+## Help
+
+```bash
+uvero --help
+uvero send --help
+uvero get --help
+uvero board --help
+```

uvero-0.1.0/README.md

@@ -0,0 +1,63 @@
+# uvero-cli
+
+**Uvero** is an online clipboard service. This CLI lets you interact with it directly from your terminal.
+
+## Installation
+
+```bash
+pip install uvero
+```
+
+## Usage
+
+### Send content
+
+```bash
+# Interactive paste mode (CTRL+D to finish)
+uvero send
+
+# Send a file
+uvero send notes.txt
+
+# Send system clipboard contents
+uvero send -
+
+# Pipe data
+cat log.txt | uvero send
+```
+
+### Retrieve content
+
+```bash
+# Save to uvero_4832.txt
+uvero get 4832
+
+# Save to a specific file
+uvero get 4832 notes.txt
+
+# Copy directly to system clipboard
+uvero get 4832 -c
+```
+
+### Boards (private shared clipboards)
+
+```bash
+# Create a board
+uvero board create
+
+# Send to a board
+uvero board send abcd-def notes.txt
+uvero board send abcd-def   # interactive paste mode
+
+# Get board content
+uvero board get abcd-def
+```
+
+## Help
+
+```bash
+uvero --help
+uvero send --help
+uvero get --help
+uvero board --help
+```

uvero-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=77.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "uvero"
+version = "0.1.0"
+description = "Uvero CLI – online clipboard from your terminal"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Uvero", email = "support@uvero.app" },
+]
+keywords = ["clipboard", "cli", "terminal", "online clipboard", "paste", "share"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Utilities",
+    "Topic :: Internet",
+]
+dependencies = [
+    "typer>=0.9.0",
+    "requests>=2.28.0",
+    "pyperclip>=1.8.0",
+    "rich>=13.0.0",
+]
+
+[project.urls]
+Homepage = "https://uvero.app"
+Repository = "https://github.com/sakethdevx/uvero-cli"
+"Bug Tracker" = "https://github.com/sakethdevx/uvero-cli/issues"
+
+[project.scripts]
+uvero = "uvero.cli:app"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["uvero*"]

uvero-0.1.0/setup.cfg

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

uvero-0.1.0/uvero/__init__.py

@@ -0,0 +1,3 @@
+"""Uvero CLI package – online clipboard from your terminal."""
+
+__version__ = "0.1.0"

uvero-0.1.0/uvero/api.py

@@ -0,0 +1,84 @@
+"""API layer – all communication with the Uvero backend."""
+
+from __future__ import annotations
+
+import requests
+
+BASE_URL = "https://uvero.app"
+
+
+def _url(path: str) -> str:
+    return f"{BASE_URL}{path}"
+
+
+def send_clipboard(content: str) -> dict:
+    """Upload *content* to the clipboard service and return the JSON response."""
+    response = requests.post(
+        _url("/api/clipboard/send"),
+        json={"content": content},
+        timeout=15,
+    )
+    response.raise_for_status()
+    return response.json()
+
+
+def get_clipboard(code: str) -> dict:
+    """Fetch clipboard entry identified by *code* and return the JSON response."""
+    response = requests.get(
+        _url(f"/api/clipboard/get/{code}"),
+        timeout=15,
+    )
+    response.raise_for_status()
+    return response.json()
+
+
+def create_board(password: str | None = None) -> dict:
+    """Create a new private board and return the JSON response."""
+    payload: dict = {}
+    if password:
+        payload["password"] = password
+    response = requests.post(
+        _url("/api/clipboard/board/create"),
+        json=payload,
+        timeout=15,
+    )
+    response.raise_for_status()
+    return response.json()
+
+
+def send_board(board: str, content: str, password: str | None = None) -> dict:
+    """Send *content* to *board* and return the JSON response."""
+    payload: dict = {"board": board, "content": content}
+    if password:
+        payload["password"] = password
+    response = requests.post(
+        _url("/api/clipboard/board/send"),
+        json=payload,
+        timeout=15,
+    )
+    response.raise_for_status()
+    return response.json()
+
+
+def get_board(board: str, password: str | None = None) -> dict:
+    """Retrieve content from *board* and return the JSON response."""
+    params: dict = {}
+    if password:
+        params["password"] = password
+    response = requests.get(
+        _url(f"/api/clipboard/board/get/{board}"),
+        params=params,
+        timeout=15,
+    )
+    response.raise_for_status()
+    return response.json()
+
+
+def health_check() -> dict:
+    """Call the CLI health endpoint and return the JSON response."""
+    response = requests.get(
+        _url("/api/clipboard/cli-health"),
+        timeout=10,
+    )
+    response.raise_for_status()
+    return response.json()

uvero-0.1.0/uvero/boards.py

@@ -0,0 +1,84 @@
+"""Board-related CLI commands (create / send / get)."""
+
+from __future__ import annotations
+
+import getpass
+import sys
+from typing import Optional
+
+import typer
+
+from uvero import api
+from uvero.utils import console, handle_api_error, is_piped, read_file, read_stdin
+
+board_app = typer.Typer(help="Manage private boards.")
+
+
+@board_app.command("create")
+def board_create():
+    """Create a new private board."""
+    try:
+        result = api.create_board()
+    except Exception as exc:
+        console.print(f"[bold red]❌ Error:[/bold red] {exc}")
+        raise typer.Exit(1)
+
+    handle_api_error(result)
+    board_id = result.get("data", {}).get("board") or result.get("data", {}).get("id", "")
+    console.print(f"[bold green]Board created:[/bold green] {board_id}")
+
+
+@board_app.command("send")
+def board_send(
+    board: str = typer.Argument(..., help="Board identifier"),
+    file: Optional[str] = typer.Argument(None, help="File to upload (omit for paste mode)"),
+):
+    """Send content to a board."""
+    if file:
+        try:
+            content = read_file(file)
+        except OSError as exc:
+            console.print(f"[bold red]❌ Error:[/bold red] {exc}")
+            raise typer.Exit(1)
+    elif is_piped():
+        content = read_stdin()
+    else:
+        console.print("[dim]Paste your text below. Press CTRL+D when done.[/dim]")
+        try:
+            content = sys.stdin.read()
+        except EOFError:
+            content = ""
+
+    try:
+        result = api.send_board(board, content)
+    except Exception as exc:
+        console.print(f"[bold red]❌ Error:[/bold red] {exc}")
+        raise typer.Exit(1)
+
+    handle_api_error(result)
+    console.print(f"[bold green]✔ Sent to board:[/bold green] {board}")
+
+
+@board_app.command("get")
+def board_get(
+    board: str = typer.Argument(..., help="Board identifier"),
+):
+    """Retrieve content from a board."""
+    try:
+        result = api.get_board(board)
+    except Exception as exc:
+        console.print(f"[bold red]❌ Error:[/bold red] {exc}")
+        raise typer.Exit(1)
+
+    # Handle password-protected boards
+    if result.get("requiresPassword"):
+        password = getpass.getpass("Board password: ")
+        try:
+            result = api.get_board(board, password=password)
+        except Exception as exc:
+            console.print(f"[bold red]❌ Error:[/bold red] {exc}")
+            raise typer.Exit(1)
+
+    handle_api_error(result)
+    content = result.get("data", {}).get("content", "")
+    console.print(content)

uvero-0.1.0/uvero/cli.py

@@ -0,0 +1,147 @@
+"""Main CLI entry point – exposes the `uv` command."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+
+from uvero import api
+from uvero.boards import board_app
+from uvero.clipboard import read_clipboard, write_clipboard
+from uvero.utils import handle_api_error, is_piped, read_file, read_stdin, write_file
+
+console = Console()
+
+app = typer.Typer(
+    name="uvero",
+    help="Uvero – online clipboard from your terminal.",
+    no_args_is_help=True,
+)
+
+app.add_typer(board_app, name="board")
+
+
+def _check_health() -> None:
+    """Silently verify that the Uvero service is reachable."""
+    try:
+        api.health_check()
+    except Exception:
+        console.print("[bold yellow]⚠ Uvero service unavailable.[/bold yellow]")
+
+
+@app.command()
+def send(
+    file: Optional[str] = typer.Argument(
+        None,
+        help="File to send. Use '-' to send the system clipboard.",
+    ),
+):
+    """Send content to the Uvero clipboard.
+
+    \b
+    uv send            – interactive paste mode (or piped stdin)
+    uv send file.txt   – send a file
+    uv send -          – send system clipboard contents
+    """
+    _check_health()
+
+    if file == "-":
+        # Read from system clipboard
+        try:
+            content = read_clipboard()
+        except Exception as exc:
+            console.print(f"[bold red]❌ Error reading clipboard:[/bold red] {exc}")
+            raise typer.Exit(1)
+    elif file:
+        # Read from the given file path
+        try:
+            content = read_file(file)
+        except OSError as exc:
+            console.print(f"[bold red]❌ Error:[/bold red] {exc}")
+            raise typer.Exit(1)
+    elif is_piped():
+        # Data piped via stdin
+        content = read_stdin()
+    else:
+        # Interactive paste mode
+        console.print("[dim]Paste your text below. Press CTRL+D (Linux/Mac) or CTRL+Z (Windows) when done.[/dim]")
+        try:
+            content = sys.stdin.read()
+        except EOFError:
+            content = ""
+
+    if not content:
+        console.print("[bold red]❌ Error:[/bold red] Nothing to send.")
+        raise typer.Exit(1)
+
+    try:
+        result = api.send_clipboard(content)
+    except Exception as exc:
+        console.print(f"[bold red]❌ Error:[/bold red] {exc}")
+        raise typer.Exit(1)
+
+    handle_api_error(result)
+
+    code = result.get("data", {}).get("code", "")
+    console.print(f"\n📋 [bold]Clipboard Code:[/bold] {code}")
+    console.print(f"🔗 [link]https://uvero.app/{code}[/link]")
+
+
+@app.command()
+def get(
+    code: str = typer.Argument(..., help="Clipboard code to retrieve"),
+    output: Optional[str] = typer.Argument(
+        None,
+        help="File path to write content to. Omit to auto-generate (uvero_CODE.txt).",
+    ),
+    copy: bool = typer.Option(
+        False,
+        "-c",
+        help="Copy retrieved content to system clipboard.",
+    ),
+):
+    """Retrieve content from the Uvero clipboard.
+
+    \b
+    uv get 4832           – save to uvero_4832.txt
+    uv get 4832 notes.txt – save to notes.txt
+    uv get 4832 -c        – copy to system clipboard
+    """
+    _check_health()
+
+    try:
+        result = api.get_clipboard(code)
+    except Exception as exc:
+        console.print(f"[bold red]❌ Error:[/bold red] {exc}")
+        raise typer.Exit(1)
+
+    handle_api_error(result)
+
+    content = result.get("data", {}).get("content", "")
+
+    if copy:
+        try:
+            write_clipboard(content)
+        except Exception as exc:
+            console.print(f"[bold red]❌ Error copying to clipboard:[/bold red] {exc}")
+            raise typer.Exit(1)
+        console.print("[bold green]✔ Copied to clipboard[/bold green]")
+        return
+
+    # Determine output file path
+    dest = output if output else f"uvero_{code}.txt"
+    try:
+        write_file(dest, content)
+    except OSError as exc:
+        console.print(f"[bold red]❌ Error:[/bold red] {exc}")
+        raise typer.Exit(1)
+
+    console.print(f"[bold green]✔ Saved to:[/bold green] {dest}")
+
+
+if __name__ == "__main__":
+    app()

uvero-0.1.0/uvero/clipboard.py

@@ -0,0 +1,13 @@
+"""System clipboard helpers (read / write) using pyperclip."""
+
+import pyperclip
+
+
+def read_clipboard() -> str:
+    """Return the current system clipboard content."""
+    return pyperclip.paste()
+
+
+def write_clipboard(text: str) -> None:
+    """Write *text* to the system clipboard."""
+    pyperclip.copy(text)

uvero-0.1.0/uvero/utils.py

@@ -0,0 +1,36 @@
+"""Shared utilities used across CLI commands."""
+
+import sys
+from pathlib import Path
+
+from rich.console import Console
+
+console = Console()
+
+
+def read_stdin() -> str:
+    """Read all text from standard input (piped or interactive paste mode)."""
+    return sys.stdin.read()
+
+
+def is_piped() -> bool:
+    """Return True when data is being piped into the process via stdin."""
+    return not sys.stdin.isatty()
+
+
+def read_file(path: str) -> str:
+    """Read and return the contents of the file at *path*."""
+    return Path(path).read_text(encoding="utf-8")
+
+
+def write_file(path: str, content: str) -> None:
+    """Write *content* to the file at *path*."""
+    Path(path).write_text(content, encoding="utf-8")
+
+
+def handle_api_error(response: dict) -> None:
+    """Print a rich error message and raise SystemExit if the API returned an error."""
+    if not response.get("success", True):
+        error_msg = response.get("error", "Unknown error")
+        console.print(f"[bold red]❌ Error:[/bold red] {error_msg}")
+        raise SystemExit(1)

uvero-0.1.0/uvero.egg-info/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: uvero
+Version: 0.1.0
+Summary: Uvero CLI – online clipboard from your terminal
+Author-email: Uvero <support@uvero.app>
+License-Expression: MIT
+Project-URL: Homepage, https://uvero.app
+Project-URL: Repository, https://github.com/sakethdevx/uvero-cli
+Project-URL: Bug Tracker, https://github.com/sakethdevx/uvero-cli/issues
+Keywords: clipboard,cli,terminal,online clipboard,paste,share
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+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 :: Utilities
+Classifier: Topic :: Internet
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: pyperclip>=1.8.0
+Requires-Dist: rich>=13.0.0
+Dynamic: license-file
+
+# uvero-cli
+
+**Uvero** is an online clipboard service. This CLI lets you interact with it directly from your terminal.
+
+## Installation
+
+```bash
+pip install uvero
+```
+
+## Usage
+
+### Send content
+
+```bash
+# Interactive paste mode (CTRL+D to finish)
+uvero send
+
+# Send a file
+uvero send notes.txt
+
+# Send system clipboard contents
+uvero send -
+
+# Pipe data
+cat log.txt | uvero send
+```
+
+### Retrieve content
+
+```bash
+# Save to uvero_4832.txt
+uvero get 4832
+
+# Save to a specific file
+uvero get 4832 notes.txt
+
+# Copy directly to system clipboard
+uvero get 4832 -c
+```
+
+### Boards (private shared clipboards)
+
+```bash
+# Create a board
+uvero board create
+
+# Send to a board
+uvero board send abcd-def notes.txt
+uvero board send abcd-def   # interactive paste mode
+
+# Get board content
+uvero board get abcd-def
+```
+
+## Help
+
+```bash
+uvero --help
+uvero send --help
+uvero get --help
+uvero board --help
+```

uvero-0.1.0/uvero.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+uvero/__init__.py
+uvero/api.py
+uvero/boards.py
+uvero/cli.py
+uvero/clipboard.py
+uvero/utils.py
+uvero.egg-info/PKG-INFO
+uvero.egg-info/SOURCES.txt
+uvero.egg-info/dependency_links.txt
+uvero.egg-info/entry_points.txt
+uvero.egg-info/requires.txt
+uvero.egg-info/top_level.txt

uvero-0.1.0/uvero.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

uvero-0.1.0/uvero.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+uvero = uvero.cli:app

uvero-0.1.0/uvero.egg-info/requires.txt

@@ -0,0 +1,4 @@
+typer>=0.9.0
+requests>=2.28.0
+pyperclip>=1.8.0
+rich>=13.0.0

uvero-0.1.0/uvero.egg-info/top_level.txt

@@ -0,0 +1 @@
+uvero