disposable-email

# Disposable Email Create and read temporary Mail.tm inboxes for testing email flows. ## Use bundled scripts - Create inbox + token: - `python3 scripts/create_inbox.py` - Returns JSON with `address`, `password`, `token`, `accountId`, `domain`. - List messages: - `python3 scripts/read_inbox.py --token <TOKEN> --list` - Read latest message: - `python3 scripts/read_inbox.py --token <TOKEN> --latest` - Wait for OTP from incoming mail: - `python3 scripts/read_inbox.py --token <TOKEN> --wait-otp --timeout 120 --interval 3` - Default OTP regex: `\\b(\\d{4,8})\\b` - Override regex with `--otp-regex`. - End-to-end (create inbox + wait for first message/OTP): - `python3 scripts/e2e_otp.py --timeout 120 --interval 3` - First line emits `inbox_created` JSON (address/password/token). - Then emits one of: `otp_found`, `message_received_no_otp`, or `timeout`. - Add `--save ./otp-result.json` to persist the latest emitted result to disk. ## Workflow 1. Run `create_inbox.py` and share the generated email address. 2. Trigger email delivery to that address. 3. Poll with `read_inbox.py` (`--latest` or `--wait-otp`). 4. Return sender, subject, createdAt, and message text/OTP. ## Notes - Free temp domains can be blocked by some production services. - Keep token private; treat it like mailbox access credentials. - Prefer stable paid inbox providers for CI if reliability is critical.