# PyTempBox - Python Temporary Email Service
[](https://pypi.org/project/pytempbox/)
[](https://pypi.org/project/pytempbox/)
[](https://opensource.org/licenses/MIT)
PyTempBox is a lightweight Python library for generating and managing temporary email addresses. Perfect for testing, automation, and protecting your privacy when interacting with online services.
## ✨ Features
With this service, you can instantly create temporary email addresses 🚀. Once the email address is generated, you can fetch incoming messages in real-time 📩. The service is designed to be lightweight ⚡, requiring minimal dependencies. Additionally, the API follows best practices in Python programming, making it user-friendly 🐍. Security is a top priority, as all connections are made through secure HTTPS 🔒. You can also retrieve the full content of each message received 📝.
## 📦 Installation
To install the package, simply run the following command in your terminal:
```bash
pip install pytempbox
```
Please note that this package requires Python version 3.9 or higher to work properly.
## 🚀 Quick Start
```python
from pytempbox import PyTempBox
client = PyTempBox()
email = client.generate_email()
print(f"Temporary email: {email}")
messages = client.get_messages(email)
if messages:
print(f"Received {len(messages)} message(s)")
print(f"Latest: {messages[0]['subject']}")
else:
print("No messages yet")
```
## 📚 Documentation
### Core Methods
The package offers several useful functions to manage temporary emails. First, you can use `generate_email(min_length=10, max_length=15)` to create a new temporary email address with a specified minimum and maximum length 🆕✉️. To retrieve messages sent to that email, you can call `get_messages(email, timeout=300, interval=10)`, which checks for incoming messages within a set timeout and interval ⏳📥. If you want to see the full content of a specific message, you can use `get_message_content(email, message_id)` to get all the details of that message 📜. Lastly, the function `get_available_domains()` will list all the email domains you can use for generating temporary addresses 🌐.
### Advanced Usage
```python
email = client.generate_email(min_length=8, max_length=12)
message = client.get_message_content(
email="your_temp@example.com",
message_id="12345"
)
```
## 📜 License
This package is distributed under the MIT License, which means you can use, modify, and distribute it freely. For more details about the license, please refer to the [LICENSE](LICENSE) file. 📄✨
Raw data
{
"_id": null,
"home_page": "https://github.com/RozhakXD/PyTempBox",
"name": "pytempbox",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "temporary email, disposable email, testing, privacy",
"author": "Rozhak",
"author_email": "rozhak9@proton.me",
"download_url": "https://files.pythonhosted.org/packages/75/f7/818d43928f0fa20f93ef6c8ec61d0c44cd5107b0a7b2cd06b9f8bdc36ca6/pytempbox-0.1.3.tar.gz",
"platform": null,
"description": "# PyTempBox - Python Temporary Email Service\r\n\r\n[](https://pypi.org/project/pytempbox/)\r\n[](https://pypi.org/project/pytempbox/)\r\n[](https://opensource.org/licenses/MIT)\r\n\r\nPyTempBox is a lightweight Python library for generating and managing temporary email addresses. Perfect for testing, automation, and protecting your privacy when interacting with online services.\r\n\r\n## \u2728 Features\r\n\r\nWith this service, you can instantly create temporary email addresses \ud83d\ude80. Once the email address is generated, you can fetch incoming messages in real-time \ud83d\udce9. The service is designed to be lightweight \u26a1, requiring minimal dependencies. Additionally, the API follows best practices in Python programming, making it user-friendly \ud83d\udc0d. Security is a top priority, as all connections are made through secure HTTPS \ud83d\udd12. You can also retrieve the full content of each message received \ud83d\udcdd.\r\n\r\n## \ud83d\udce6 Installation\r\n\r\nTo install the package, simply run the following command in your terminal:\r\n\r\n```bash\r\npip install pytempbox\r\n```\r\n\r\nPlease note that this package requires Python version 3.9 or higher to work properly.\r\n\r\n## \ud83d\ude80 Quick Start\r\n\r\n```python\r\nfrom pytempbox import PyTempBox\r\n\r\nclient = PyTempBox()\r\nemail = client.generate_email()\r\nprint(f\"Temporary email: {email}\")\r\n\r\nmessages = client.get_messages(email)\r\nif messages:\r\n print(f\"Received {len(messages)} message(s)\")\r\n print(f\"Latest: {messages[0]['subject']}\")\r\nelse:\r\n print(\"No messages yet\")\r\n```\r\n\r\n## \ud83d\udcda Documentation\r\n\r\n### Core Methods\r\n\r\nThe package offers several useful functions to manage temporary emails. First, you can use `generate_email(min_length=10, max_length=15)` to create a new temporary email address with a specified minimum and maximum length \ud83c\udd95\u2709\ufe0f. To retrieve messages sent to that email, you can call `get_messages(email, timeout=300, interval=10)`, which checks for incoming messages within a set timeout and interval \u23f3\ud83d\udce5. If you want to see the full content of a specific message, you can use `get_message_content(email, message_id)` to get all the details of that message \ud83d\udcdc. Lastly, the function `get_available_domains()` will list all the email domains you can use for generating temporary addresses \ud83c\udf10.\r\n\r\n### Advanced Usage\r\n\r\n```python\r\nemail = client.generate_email(min_length=8, max_length=12)\r\n\r\nmessage = client.get_message_content(\r\n email=\"your_temp@example.com\",\r\n message_id=\"12345\"\r\n)\r\n```\r\n\r\n## \ud83d\udcdc License\r\n\r\nThis package is distributed under the MIT License, which means you can use, modify, and distribute it freely. For more details about the license, please refer to the [LICENSE](LICENSE) file. \ud83d\udcc4\u2728\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Python library for temporary email addresses",
"version": "0.1.3",
"project_urls": {
"Bug Reports": "https://github.com/RozhakXD/PyTempBox/issues",
"Homepage": "https://github.com/RozhakXD/PyTempBox",
"Source": "https://github.com/RozhakXD/PyTempBox"
},
"split_keywords": [
"temporary email",
" disposable email",
" testing",
" privacy"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "470c91061e85a01ebad64f4d03fc78970e29ea69c7111b00fc8e6a71e9e1f698",
"md5": "45c41809b726dc927d1743e02f8c6fb4",
"sha256": "0e2f5c7ce05df79280cab27c637a56e7249a6540c101dd1e673a97444865c498"
},
"downloads": -1,
"filename": "pytempbox-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "45c41809b726dc927d1743e02f8c6fb4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 4842,
"upload_time": "2025-07-10T22:26:55",
"upload_time_iso_8601": "2025-07-10T22:26:55.529794Z",
"url": "https://files.pythonhosted.org/packages/47/0c/91061e85a01ebad64f4d03fc78970e29ea69c7111b00fc8e6a71e9e1f698/pytempbox-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "75f7818d43928f0fa20f93ef6c8ec61d0c44cd5107b0a7b2cd06b9f8bdc36ca6",
"md5": "11b6f7194013eb48aa35a368e6d08ee1",
"sha256": "fb38a1b4c7fb66442162020f97c9f05c4969d7a07eb0ee75e2a31ea4bc944442"
},
"downloads": -1,
"filename": "pytempbox-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "11b6f7194013eb48aa35a368e6d08ee1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 4246,
"upload_time": "2025-07-10T22:26:56",
"upload_time_iso_8601": "2025-07-10T22:26:56.838125Z",
"url": "https://files.pythonhosted.org/packages/75/f7/818d43928f0fa20f93ef6c8ec61d0c44cd5107b0a7b2cd06b9f8bdc36ca6/pytempbox-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-10 22:26:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "RozhakXD",
"github_project": "PyTempBox",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "requests",
"specs": [
[
"==",
"2.32.3"
]
]
}
],
"lcname": "pytempbox"
}
JSON
