# Tooling

A collection of useful command-line tools.

## OCR Screenshot Tool

A CLI tool that takes region screenshots on macOS, performs OCR using Tesseract, and copies the result to clipboard.

### Prerequisites

- macOS (uses built-in `screencapture` command)
- Tesseract OCR (install with `brew install tesseract`)

### Usage

Basic usage (takes screenshot, performs OCR, copies to clipboard):
```bash
uv run ocr-screenshot
```

With verbose output:
```bash
uv run ocr-screenshot --verbose
```

Save the screenshot image:
```bash
uv run ocr-screenshot --save-image
```

Specify OCR language (e.g., for Chinese):
```bash
uv run ocr-screenshot --lang chi_sim
```

### How it works

1. **Screenshot**: Click and drag to select a region, or press Space to capture an entire window
2. **OCR**: The selected region is processed with Tesseract OCR
3. **Clipboard**: The extracted text is automatically copied to your clipboard

## Development Guide

### How to Add New Packages

To add a new production dependency (e.g., 'requests'):
```bash
uv add requests
```

To add a new development dependency (e.g., 'ipdb'):
```bash
uv add --dev ipdb
```

After adding dependencies, always re-generate requirements.txt:
```bash
uv pip compile pyproject.toml -o requirements.txt
```

### How to Build Packages

To build your project's distributable packages (.whl, .tar.gz):
```bash
python -m build
```

Or using the virtual environment directly:
```bash
./venv/bin/python -m build
```

### Offline Build

To build offline packages for deployment:
```bash
./dev_scripts/build_offline.sh
```

This will create offline_packages/ with all dependencies and install.sh