{"id":22443,"library":"temp-mails","title":"temp-mails","description":"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.","status":"active","version":"2.2.0","language":"python","source_language":"en","source_url":"https://github.com/bertigert/temp-mails","tags":["temp-mail","email","disposable","wrapper"],"install":[{"cmd":"pip install temp-mails","lang":"bash","label":"Install via pip"}],"dependencies":[],"imports":[{"wrong":"from tempmail import Mail","symbol":"Mail","correct":"from temp_mails import Mail"}],"quickstart":{"code":"from tempmail import Mail\n\nmail = Mail()\nprint(mail.address)\n\n# Wait for email\nemail = mail.wait_for_email(timeout=30)\nif email:\n    print(email.subject)","lang":"python","description":"Create a temporary email, display address, and wait for an incoming email."},"warnings":[{"fix":"Use 'from tempmail import ...'.","message":"The package name on PyPI is 'temp-mails' but the import uses 'tempmail'. Many users mistakenly import 'temp_mails' or 'temp-mails'.","severity":"gotcha","affected_versions":"all"},{"fix":"Update code to use new API: from tempmail import Mail; mail = Mail(); mail.wait_for_email()","message":"In 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'.","severity":"breaking","affected_versions":"2.0+"},{"fix":"Use mail.wait_for_email(timeout=30) instead of no timeout.","message":"The 'wait_for_email' method can hang indefinitely if timeout not set. Always provide a timeout parameter.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'2.2.0':21 '3.8':24 'activ':25 'api':18 'around':7 'basic':5 'current':19 'develop':26 'dispos':34 'email':33 'etc':14 'guerrillamail':13 'mail':3,10,32 'mail.tm':12 'provid':15 'python':23 'regular':28 'releas':29 'requir':22 'site':11 'temp':2,9,31 'temp-mail':1,30 'unifi':17 'various':8 'version':20 'wrapper':6,35","created_at":"2026-04-27T17:05:12.059987+00:00","updated_at":"2026-04-27T17:05:12.059987+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'Mail' from 'temp_mails' (/tmp/tmp_k5etpzr/venv/lib/python3.12/site-packages/temp_mails/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"2.2.0","cli_name":"temp-mail","cli_version":"sh: 1: temp-mail: not found","type":"library","homepage":null,"github":"https://github.com/bertigert/temp-mails","docs":null,"changelog":null,"pypi":"https://pypi.org/project/temp-mails/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["http-networking","communication"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}