temp-mails

library2.2.0pypypiunverified

A basic wrapper around various temp mail sites (mail.tm, guerrillamail, etc.) providing a unified API. Current version 2.2.0, requires Python >=3.8. Active development with regular releases.

http-networking communication

pip install temp-mails

github ↗package ↗

INSTALL

IMPORT

SIG · TEMP-MAILS

temp-mails

http-networkingpythonv2.2.0

Install

1.7s avg

Import

—

Disk

17MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.2.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 19MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.7s · import 0.000s · 20MB

17MB installed

● package 17MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Mail

✓ from temp_mails import Mail

✗ from tempmail import Mail

Create a temporary email, display address, and wait for an incoming email.

from tempmail import Mail mail = Mail() print(mail.address) # Wait for email email = mail.wait_for_email(timeout=30) if email: print(email.subject)

temp-mail --version

Debug

Known issues

gotchaThe package name on PyPI is 'temp-mails' but the import uses 'tempmail'. Many users mistakenly import 'temp_mails' or 'temp-mails'.

fix

Use 'from tempmail import ...'.

affects: all

breakingIn version 2.x, the API changed significantly from 1.x. The main class is now 'Mail' instead of 'TempMail', and methods like 'wait_for_email' replaced 'get_inbox'.

fix

Update code to use new API: from tempmail import Mail; mail = Mail(); mail.wait_for_email()

affects: 2.0+

gotchaThe 'wait_for_email' method can hang indefinitely if timeout not set. Always provide a timeout parameter.

fix

Use mail.wait_for_email(timeout=30) instead of no timeout.

affects: all

Upgrade

Version history

2.2.0latest on PyPI · released May 19, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

31 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/bertigert/temp-mails ↗

packagehttps://pypi.org/project/temp-mails/ ↗