Skip to content

Validation concessions options for top-level domains #86

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
northpowered wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Validation concessions options for top-level domains #86

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
90fcc31
Added 3 soft args to validate method
Aug 16, 2022
2d6e7c3
README updated
Aug 16, 2022
dace4e7
Linter fixes
Aug 16, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
README updated
  • Loading branch information
northpowered
northpowered committed Aug 16, 2022
commit 2d6e7c3238e1fa6f86d0f3aeaad35a9b4cd5a6b0
5 changes: 5 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -148,6 +148,11 @@ The `validate_email` function also accepts the following keyword arguments

`test_environment=False`: DNS-based deliverability checks are disabled and `test` and `subdomain.test` domain names are permitted (see below).

`allow_special_domains=False`: Turning off EmailUndeliverableError exception for special top-level domains, such as "arpa", "local" and others. Default is False (restricted).

`allow_any_top_level_domain=False`: Turn off EmailUndeliverableError exception for top-level domains, which are not matching with regex **[A-Za-z]\Z**, such as "org123". May be useful for local services in isolated environments with special local TLD. Default is False (restricted).

`allowed_top_level_domains=[]`: Similar with `allow_any_top_level_domain` but working like whitelist. Will be ignored, if `allow_any_top_level_domain=True` or if list is empty. Default is [] (no allowed *bad* domains).
### DNS timeout and cache

When validating many email addresses or to control the timeout (the default is 15 seconds), create a caching [dns.resolver.Resolver](https://dnspython.readthedocs.io/en/latest/resolver-class.html) to reuse in each call. The `caching_resolver` function returns one easily for you:
Expand Down
9 changes: 0 additions & 9 deletions main.py
View file
Open in desktop

This file was deleted.

1 change: 1 addition & 0 deletions tests/__init__.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
#Just for a right import from email_validator to the test_main.py on modern Python versions