| Name | barid JSON |
| Version |
0.2.0
JSON |
| download |
| home_page | None |
| Summary | A deeply abstract, fully asynchronous Python client for the Barid temporary email API with complex architecture and type-heavy design. |
| upload_time | 2025-07-26 19:58:52 |
| maintainer | None |
| docs_url | None |
| author | Hexa |
| requires_python | >=3.8 |
| license | MIT |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Barid Client
**Barid** is a fully asynchronous, highly modular, and type-driven Python client for interacting with the [barid.site](https://web.barid.site) temporary email API.
It is designed for developers who require a professional, extensible, and heavily abstracted interface to manage disposable email inboxes programmatically.
Barid is engineered with extreme complexity using deep Python patterns like strict type hints, decorators, layered abstraction, and dynamic data models—offering full control over every operation in a highly structured SDK.
---
## 🧪 Example Usage
```python
import asyncio
from barid.client import BaridClient
from barid.types import EmailAddress, EmailId
async def main():
email = EmailAddress("example@barid.site")
async with BaridClient() as client:
domains = await client.get_domains()
print("Available Domains:", domains)
total = await client.count_emails(email=email)
print("Total Emails:", total)
emails = await client.get_emails(email=email, limit=5)
print(f"\nFetched {len(emails)} email(s)\n")
for msg in emails:
print("Subject:", msg.subject)
details = await client.get_email(email_id=EmailId(msg.id))
print(details)
print("Content:", details.text_content or details.html_content)
print()
if emails:
await client.delete_email(email_id=EmailId(emails[0].id))
print("Deleted the latest email")
await client.delete_emails(email=email)
print("Deleted all emails")
asyncio.run(main())
````
---
## 🤝 Contributing
Contributions are highly welcome.
Feel free to open issues or submit pull requests for enhancements, bugs, or design improvements.
---
## 🪪 License
MIT © 2025 Hexa
Raw data
{
"_id": null,
"home_page": null,
"name": "barid",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Hexa",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/2b/b9/9b51e0a06c5f02603ed0ad0e02b262c809f9006ecf261facd4b7ec12f3a4/barid-0.2.0.tar.gz",
"platform": null,
"description": "# Barid Client\n\n**Barid** is a fully asynchronous, highly modular, and type-driven Python client for interacting with the [barid.site](https://web.barid.site) temporary email API. \nIt is designed for developers who require a professional, extensible, and heavily abstracted interface to manage disposable email inboxes programmatically.\n\nBarid is engineered with extreme complexity using deep Python patterns like strict type hints, decorators, layered abstraction, and dynamic data models\u2014offering full control over every operation in a highly structured SDK.\n\n---\n\n## \ud83e\uddea Example Usage\n\n```python\nimport asyncio\nfrom barid.client import BaridClient\nfrom barid.types import EmailAddress, EmailId\n\nasync def main():\n email = EmailAddress(\"example@barid.site\")\n\n async with BaridClient() as client:\n domains = await client.get_domains()\n print(\"Available Domains:\", domains)\n\n total = await client.count_emails(email=email)\n print(\"Total Emails:\", total)\n\n emails = await client.get_emails(email=email, limit=5)\n print(f\"\\nFetched {len(emails)} email(s)\\n\")\n\n for msg in emails:\n print(\"Subject:\", msg.subject)\n\n details = await client.get_email(email_id=EmailId(msg.id))\n print(details)\n print(\"Content:\", details.text_content or details.html_content)\n print()\n\n if emails:\n await client.delete_email(email_id=EmailId(emails[0].id))\n print(\"Deleted the latest email\")\n\n await client.delete_emails(email=email)\n print(\"Deleted all emails\")\n\nasyncio.run(main())\n````\n\n---\n\n## \ud83e\udd1d Contributing\n\nContributions are highly welcome.\nFeel free to open issues or submit pull requests for enhancements, bugs, or design improvements.\n\n---\n\n## \ud83e\udeaa License\n\nMIT \u00a9 2025 Hexa\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A deeply abstract, fully asynchronous Python client for the Barid temporary email API with complex architecture and type-heavy design.",
"version": "0.2.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "89bed7e652c825a7636016afb3583d3a2b7566b9a0a6f965f31b7be34bcdf67a",
"md5": "be4afd886184d60a66459c8cda9afc5b",
"sha256": "884e3f9409316555677cfbf548824cf6af382c8d92f887c74cfdc2f11a218c14"
},
"downloads": -1,
"filename": "barid-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "be4afd886184d60a66459c8cda9afc5b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 12055,
"upload_time": "2025-07-26T19:58:51",
"upload_time_iso_8601": "2025-07-26T19:58:51.379457Z",
"url": "https://files.pythonhosted.org/packages/89/be/d7e652c825a7636016afb3583d3a2b7566b9a0a6f965f31b7be34bcdf67a/barid-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2bb99b51e0a06c5f02603ed0ad0e02b262c809f9006ecf261facd4b7ec12f3a4",
"md5": "3cd1667c8c501f1934d128dc9b448bd8",
"sha256": "e9e83ec1cf5fbca70646c798ab7721b2e81b057fbf91e6a32e9ced2890d7f10a"
},
"downloads": -1,
"filename": "barid-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "3cd1667c8c501f1934d128dc9b448bd8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 6942,
"upload_time": "2025-07-26T19:58:52",
"upload_time_iso_8601": "2025-07-26T19:58:52.922634Z",
"url": "https://files.pythonhosted.org/packages/2b/b9/9b51e0a06c5f02603ed0ad0e02b262c809f9006ecf261facd4b7ec12f3a4/barid-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-26 19:58:52",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "barid"
}
