JoshData/python-email-validator — reverse-engineered prompt

Build me a small but solid Python library for checking email addresses that I could use in signup and login forms.

I want it to tell me if an address is valid, give back a cleaned up normalized version I should store in a database, and raise friendly human readable errors when something is wrong. It should handle normal addresses plus international ones, and it should be opinionated about rejecting weird, unsafe, or outdated formats that would cause trouble in real apps. Please make the domain deliverability check optional, since I would want it on for account creation but off for login. If it makes sense, support parsing a display name too.

Please include sensible docs and tests so it feels like a real reusable package, not just a demo. I care about clear behavior around Unicode, special use domains like localhost, and domains that do not actually receive mail. Look up current docs online if you need to.