Metadata-Version: 2.4
Name: mail7
Version: 0.1.0
Summary: Official Mail7 email validation client - honest Valid / Not Valid / Unknown.
Author: Mail7
License: MIT
Project-URL: Homepage, https://mail7.net
Project-URL: Documentation, https://mail7.net/api-docs.html
Keywords: mail7,email,email-validation,email-verification,smtp,disposable
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Communications :: Email
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# mail7 (Python)

Official [Mail7](https://mail7.net) email validation client. Zero dependencies (stdlib only).

```bash
pip install mail7
```

```python
from mail7 import Mail7

client = Mail7(api_key="...")   # api_key optional (free anonymous tier without it)

result = client.validate("user@example.com")
print(result["status"])         # "Valid" | "Not Valid" | "Unknown"
print(result["valid"])          # True | False | None (None when Unknown)
print(result["is_disposable"])  # True for throwaway addresses
```

## Honest classification

`status` is `Valid`, `Not Valid`, or `Unknown`. `valid` is `None` when the address could not
be verified (catch-all, greylisting, disposable) - so you never wrongly reject a real person.
Branch on `status`; do not treat `Unknown` as invalid.

## API

- `Mail7(api_key=None, base_url="https://mail7.net/api", timeout=20)`
- `validate(email) -> dict`
- raises `Mail7Error` on API/transport errors.

## License

MIT
