chupo 0.1.0

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

Get detailed output for an upload:

chupo img.jpg -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: json (default), txt, or redirect (matches Chevereto’s format parameter).
• -v / --verbose: With json, prints the full image object returned by the server.
• --raw: Print only API data to stdout (no banner or Rich UI). With -f json, each response body is written as-is (multiple files separated by a blank line). With -f txt, one URL per line. Errors go to stderr; exit code is non-zero if any upload fails.

Pipe-friendly example:

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

---

📋 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.