# posta

> *[Read this in English](README.md)*

**posta** es un cliente de correo IMAP/SMTP chiquito y genérico para tu
terminal. Un solo binario, salida JSON por defecto y cuentas con nombre en un
archivo TOML — tu casilla queda tan scripteable como cualquier otra API.

El nombre viene de las *postas*: las estaciones de relevo del correo colonial
sudamericano. Y en Argentina, *la posta* es también lo genuino, la verdad.

```console
$ posta list --unread --max 3 --format table
   UID      DATE                    FROM                              SUBJECT
  7121  ●   Fri, 17 Jul 2026 17:0…  "Proveedor" <facturas@isp.ex…     Tu factura está lista
  7120  ●   Fri, 17 Jul 2026 15:0…  Meetup <eventos@meetup.exam…      🚀 Inscripción abierta
  7119  ●   Fri, 17 Jul 2026 10:1…  "banco@example.com"               Aviso de tarjeta

$ posta search 'FROM banco UNSEEN' | jq .uids
[7119, 7118, 7117]
```

## Características

- **Funciona con cualquier proveedor** — IMAP/SMTP con STARTTLS (`imap://`,
  `smtp://`) o TLS implícito (`imaps://`, `smtps://`). Tu propio servidor,
  Gmail, Fastmail, lo que sea.
- **Múltiples cuentas** — cuentas con nombre en un solo archivo, cambiadas
  con `--account`, `$POSTA_ACCOUNT` o un `default_account`.
- **Amigable para scripts** — todos los comandos imprimen JSON (canalizalo a
  `jq`), con `--format table` para humanos.
- **Secretos a tu manera** — contraseñas literales (posta revisa los permisos
  del archivo y te avisa si están flojos) o `password_cmd` para sacarlas de
  `pass`, un keyring o cualquier comando.
- **Seguro por defecto** — leer nunca marca mensajes como leídos
  (`BODY.PEEK` en todos lados); optás con `--mark-read` o `posta mark read`.
- **Sin archivo de config si no querés** — todo puede venir de variables de
  entorno `POSTA_*`, útil para CI y scripts sueltos.

## Instalación

```sh
git clone https://git.all.ar/pub/posta.git
cd posta
cargo install --path .
```

## Configuración

`~/.config/posta/config.toml` (o `$POSTA_CONFIG`, o `--config ARCHIVO`):

```toml
default_account = "personal"

[accounts.personal]
email = "alice@example.com"
display_name = "Alice Example"
imap_url = "imap://alice@example.com@mail.example.com:143"
smtp_url = "smtp://alice@example.com@mail.example.com:587"
password_cmd = "pass show mail/personal"   # o: password = "..." (¡chmod 600!)

[accounts.trabajo]
email = "alice@work.example"
imap_url = "imaps://alice@imap.work.example"    # TLS implícito, puerto 993
smtp_url = "smtps://alice@smtp.work.example"    # TLS implícito, puerto 465
password_cmd = "secret-tool lookup mail trabajo"
sent_folder = "Sent Items"
trash_folder = "Deleted"
```

El usuario de la URL puede contener `@`
(`imap://alice@example.com@mail.example.com`); el host empieza después del
*último*. `imap_password[_cmd]` / `smtp_password[_cmd]` pisan la contraseña
compartida por protocolo cuando difieren.

Las variables de entorno pisan cualquier campo de la cuenta elegida:
`POSTA_IMAP_URL`, `POSTA_SMTP_URL`, `POSTA_PASSWORD`, `POSTA_PASSWORD_CMD`,
`POSTA_IMAP_PASSWORD`, `POSTA_SMTP_PASSWORD`, `POSTA_EMAIL`,
`POSTA_DISPLAY_NAME`, `POSTA_SENT_FOLDER`, `POSTA_TRASH_FOLDER`,
más `POSTA_ACCOUNT` y `POSTA_CONFIG`.

## Uso

```sh
posta accounts                       # cuentas configuradas
posta status                         # totales y sin leer
posta folders                        # listar carpetas
posta list --unread                  # más recientes primero
posta list --query 'FROM banco SINCE 1-Jul-2026'
posta get 7119                       # headers + cuerpo de texto, en JSON
posta get 7119 --html                # preferir la parte HTML
posta get 7119 --raw > msg.eml       # fuente RFC 822 crudo
posta send --to bob@example.com --subject 'Hola' --body '¡Hola!'
git log | posta send --to bob@example.com --subject 'Changelog'
posta mark read 7119 7120            # también: unread, flagged, unflagged
posta move 7119 --to Archives
posta delete 7119                    # mueve a la papelera
posta search 'FROM banco UNSEEN'     # IMAP SEARCH crudo, imprime UIDs
```

Flags globales: `--account/-a NOMBRE`, `--config ARCHIVO`,
`--format json|table`, y `--folder` en los comandos que operan sobre una
carpeta.

Cada comando abre una sesión nueva y cierra al terminar; no hay demonio,
caché ni estado local.

## Notas

- `send` guarda una copia en la carpeta de enviados vía IMAP (se omite con
  `--no-record`).
- `move`/`delete` usan `UID MOVE` si el servidor lo soporta, con fallback a
  `COPY` + `\Deleted` + `EXPUNGE`.
- TLS es siempre obligatorio; no hay conexiones en texto plano.

## Desarrollo

```sh
cargo test          # tests unitarios + integración del CLI, sin servidor
cargo clippy --all-targets -- -D warnings
cargo fmt --check
```

## Licencia

[MIT](LICENSE)