is-burner-email 1.0.2

Fast, offline burner / disposable email detection with three-list (blacklist/whitelist/graylist) classification.

is-burner-email (Python)

Fast, offline detection of burner / disposable emails.

• Offline. Domain lists bundled inside the wheel. No network calls at runtime.
• Zero runtime dependencies.
• Three lists. blacklist (burners), whitelist (always allowed), graylist (email alias / forwarding services — blocked only in strict mode).
• Typed (ships py.typed). Python 3.9+.

Install

pip install is-burner-email

Usage

from is_burner_email import is_burner, check

is_burner("[e-mail]")                # True
is_burner("[e-mail]")                     # False
is_burner("[e-mail]")                      # False (normal mode)
is_burner("[e-mail]", mode="strict")       # True

check("[e-mail]", mode="strict")
# {
#   'burner': True,
#   'domain': 'duck.com',
#   'list': 'graylist',
#   'reason': 'graylisted-strict'
# }

Runtime overrides

from is_burner_email import add_to_blacklist, add_to_whitelist

add_to_blacklist("badactor.example")
add_to_whitelist("our-corporate-domain.example")

Whitelist always wins over blacklist.

CLI

burner [e-mail]
# BURNER (blacklist): mailinator.com [blacklisted]

burner [e-mail] --strict --json
# {"burner": true, "domain": "duck.com", "list": "graylist", "reason": "graylisted-strict", "mode": "strict"}

burner --stats

Exit codes: 0 clean, 1 burner, 2 invalid input.

License

MIT