chupo 0.1.3

CLI tool to upload images to Chevereto (V4 API V1 file upload) with a polished terminal UI.

chupo

chupo is a high-performance CLI utility designed to upload images directly to a Chevereto instance. It streamlines the image sharing workflow, utilizing the Chevereto API V1 file upload endpoint for fast and reliable uploads.

---

✨ Features

• ⚡ High Performance: Built with modern Python for fast execution.
• 🛠️ CLI-First: Designed for speed and terminal integration using Typer.
• 📊 Beautiful Output: Features rich, colored terminal output with progress bars via Rich.
• 🚀 Simple Setup: Supports configuration via environment variables or CLI flags.
• 📂 Batch Upload: Effortlessly upload multiple files at once.

---

🚀 Quick Start

1. Installation

Install chupo as a global tool using uv:

uv tool install .

Or, if you prefer using pip:

pip install .

2. Usage

Upload a single image:

chupo photo.png -u https://mysite.com -k YOUR_API_KEY

Upload multiple images:

chupo a.png b.png -u https://mysite.com -k YOUR_API_KEY

Interactive styled output (logo, progress, panels):

chupo img.jpg -u https://mysite.com -k YOUR_API_KEY -f pretty -v

---

🛠️ Configuration

You can pass flags directly or set environment variables (flags override environment variables).

Variable	Flag	Description
CHEVERETO_URL	-u / --base-url	Site base URL (e.g., https://img.example.com)
CHEVERETO_API_KEY	-k / --key	Your Chevereto API key

Options

• -f / --format: txt (default): one URL per line to stdout, no banner. json: raw JSON response body per file (blank line between files). redirect: Chevereto redirect mode; stdout is the resolved URL. pretty: logo, spinner, and Rich panels (uses API format=json).
• -v / --verbose: With -f pretty, prints the full image payload in a panel when the server returns JSON.
• --raw: Force plain stdout even with -f pretty (emits raw JSON bodies like -f json). Errors go to stderr; non-zero exit if any upload fails.

Pipe-friendly (default format is already plain URLs):

chupo photo.png -u https://mysite.com -k YOUR_API_KEY > url.txt

Raw JSON:

chupo photo.png -u https://mysite.com -k YOUR_API_KEY -f json > out.json

---

📋 API Scope

This client follows the Chevereto V4 — API V1 file upload specification (POST /api/1/upload, multipart source, X-API-Key header). It is optimized for modern Chevereto V4 instances.

---

📄 License

This project is licensed under the MIT License.