semvec/pypi-packages huggingface dataset:
image2url 0.1.0
Tiny Python client for uploading images to image2url and getting a permanent URL.
License: MIT
Requires Python: >=3.8

# image2url (PyPI)

轻量级 Python SDK + CLI，用来把本地图片上传到 image2url API，返回一个可长期访问的公开 URL。默认指向 `https://www.image2url.com/api/upload`，也可通过环境变量切换到你自己的部署。

## 功能
- 上传本地图片并返回永久 URL
- 内置 2MB 体积校验（与默认 API 对齐，可自定义）
- 自定义上传地址、超时时间与文件名
- CLI 一键上传，或在 Python 代码中调用

## 安装
```bash
# 发布后
pip install image2url

# 本地开发/调试
pip install -e .[dev]
```

## Python 快速开始
```python
from image2url import Image2URLClient, upload_image

# 方式 1：直接用便捷函数
result = upload_image("avatar.png")
print(result.url)

# 方式 2：自定义客户端
client = Image2URLClient(
    endpoint="https://www.image2url.com/api/upload",
    timeout=15,
    max_size_mb=2,
)
result = client.upload_image("avatar.png", filename="profile.png")
print(result.url)
```

## CLI 用法
```bash
# 最简单用法
image2url ./avatar.png

# 自定义地址、超时并输出完整 JSON
IMAGE2URL_ENDPOINT=https://your-domain.com/api/upload \
image2url ./avatar.png --timeout 30 --json
```

## 配置
- `IMAGE2URL_ENDPOINT`：自定义上传地址（默认 `https://www.image2url.com/api/upload`）
- `IMAGE2URL_TIMEOUT`：请求超时秒数（默认 15）
- `max_size_mb`：初始化客户端时自定义体积限制（默认 2MB）

## 本地开发
```bash
pip install -e .[dev]
python -m pytest
```

## 返回示例
```json
{
  "success": true,
  "url": "https://www.image2url.com/images/1733090000-uuid.png",
  "filename": "images/1733090000-uuid.png",
  "originalName": "avatar.png",
  "size": 102400,
  "type": "image/png",
  "uploadedAt": "2024-12-02T00:00:00.000Z"
}
```
rainbow-clock 0.1.0
Amazing terminal analog clock with rainbow gradients and dynamic effects
License: MIT
Requires Python: >=3.10
Keywords: analog-clock, cli, clock, effects, rainbow, terminal

# 🌈 Rainbow Analog Clock

An amazing terminal-based analog clock with dynamic visual effects, rainbow gradients, and smooth animations.

[![Python Version](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![PyPI](https://img.shields.io/badge/PyPI-coming%20soon-orange.svg)](https://pypi.org/project/rainbow-clock/)

## ✨ Features

✨ **Beautiful Analog Clock**
- Perfect circular design with aspect ratio compensation
- Rainbow gradient border with continuous color rotation
- Numbered hour markers (1-12) with special markers at 3, 6, 9, 12
- Three distinct hands: hour (red), minute (green), second (cyan)
- Glowing effects on hands and markers
- Pulsing current hour indicator

🎆 **7 Dynamic Visual Effects**
1. **Classic** - Clean clock without particle effects
2. **Fireworks** - Random colorful firework bursts
3. **Rain** - Continuous rainbow raindrops
4. **Stars** - Twinkling stars across the screen
5. **Matrix** - Matrix-style falling characters
6. **Sparkle** - Sparkles orbiting the clock face
7. **Snow** - Gentle falling snowflakes

🎮 **Interactive Controls**
- **SPACE** - Cycle through effects
- **R** - Toggle random mode (auto-switches every 10 seconds)
- **Ctrl+C** - Exit gracefully

⚡ **Performance**
- Smooth 20 FPS animation
- No flickering with proper double-buffering
- Efficient particle system with automatic cleanup

## Requirements

- Python 3.10+
- A terminal with true color (RGB) support
- Unix-like system (Linux, macOS)

## 🚀 Quick Start

### Run with uvx (recommended):
No installation needed! Run directly:
```bash
uvx rainbow-clock
```

### Install with uv:
```bash
uv tool install rainbow-clock
rainbow-clock
```

### Install with pip:
```bash
pip install rainbow-clock
rainbow-clock
```

### Run from source:
```bash
git clone https://github.com/derluke/rainbow-clock.git
cd rainbow-clock
python3 -m rainbow_clock
```

## 📦 Project Structure

- `rainbow_clock/` - Main package directory
  - `__init__.py` - Clock application with particle effects
- `analog_clock.py` - Basic clock version without effects
- `pyproject.toml` - Project configuration
- `README.md` - This file
- `LICENSE` - MIT License

## How It Works

The clock uses:
- **Bresenham's line algorithm** for smooth clock hands
- **Midpoint circle/ellipse algorithm** for the clock face
- **Custom particle system** with physics simulation
- **ANSI escape codes** for RGB colors and cursor positioning
- **Aspect ratio compensation** for perfect circles in terminal
- **Non-blocking input** for interactive controls

Enjoy your colorful time! ⏰✨