barid 0.2.0

A deeply abstract, fully asynchronous Python client for the Barid temporary email API with complex architecture and type-heavy design.

Barid Client

Barid is a fully asynchronous, highly modular, and type-driven Python client for interacting with the 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

import asyncio
from barid.client import BaridClient
from barid.types import EmailAddress, EmailId

async def main():
    email = EmailAddress("[e-mail]")

    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