commit
fb31b4b015
GPG Key ID:
1EC08A25C9DB2503
@ -0,0 +1 @@
|
||||
SOURCES/python-email-validator-2.2.0.tar.gz
|
||||
@ -0,0 +1 @@
|
||||
a47221108597438ed956f5626c9639ea7f990431 SOURCES/python-email-validator-2.2.0.tar.gz
|
||||
@ -0,0 +1,91 @@
|
||||
From 6d32d7a7bb3682891656ab91562c5df379cdf66f Mon Sep 17 00:00:00 2001
|
||||
From: "Benjamin A. Beasley" <code@musicinmybrain.net>
|
||||
Date: Fri, 21 Jun 2024 10:11:47 -0400
|
||||
Subject: [PATCH 1/3] Fix a minor typo in README.md (validing/validating)
|
||||
|
||||
---
|
||||
README.md | 2 +-
|
||||
1 file changed, 1 insertion(+), 1 deletion(-)
|
||||
|
||||
diff --git a/README.md b/README.md
|
||||
index 895dfa9..5c1af43 100644
|
||||
--- a/README.md
|
||||
+++ b/README.md
|
||||
@@ -12,7 +12,7 @@ users by their email address like on a registration form.
|
||||
Key features:
|
||||
|
||||
* Checks that an email address has the correct syntax --- great for
|
||||
- email-based registration/login forms or validing data.
|
||||
+ email-based registration/login forms or validating data.
|
||||
* Gives friendly English error messages when validation fails that you
|
||||
can display to end-users.
|
||||
* Checks deliverability (optional): Does the domain name resolve?
|
||||
|
||||
From 1b2be12df83498144b5d30b05d49ad9798a681e8 Mon Sep 17 00:00:00 2001
|
||||
From: "Benjamin A. Beasley" <code@musicinmybrain.net>
|
||||
Date: Fri, 21 Jun 2024 10:12:38 -0400
|
||||
Subject: [PATCH 2/3] Fix a minor typo in CHANGELOG.md (Verison/Version)
|
||||
|
||||
---
|
||||
CHANGELOG.md | 2 +-
|
||||
1 file changed, 1 insertion(+), 1 deletion(-)
|
||||
|
||||
diff --git a/CHANGELOG.md b/CHANGELOG.md
|
||||
index 2aea055..4bf9451 100644
|
||||
--- a/CHANGELOG.md
|
||||
+++ b/CHANGELOG.md
|
||||
@@ -77,7 +77,7 @@ Version 1.2.1 (May 1, 2022)
|
||||
* example.com/net/org are removed from the special-use reserved domain names list so that they do not raise exceptions if check_deliverability is off.
|
||||
* Improved README.
|
||||
|
||||
-Verison 1.2.0 (April 24, 2022)
|
||||
+Version 1.2.0 (April 24, 2022)
|
||||
------------------------------
|
||||
|
||||
* Reject domains with NULL MX records (when deliverability checks
|
||||
|
||||
From 8e1f67e47d789cd88ac6e016b187bbf9be805729 Mon Sep 17 00:00:00 2001
|
||||
From: "Benjamin A. Beasley" <code@musicinmybrain.net>
|
||||
Date: Fri, 21 Jun 2024 10:13:34 -0400
|
||||
Subject: [PATCH 3/3] Fix minor typos in code comments
|
||||
|
||||
---
|
||||
email_validator/__main__.py | 2 +-
|
||||
email_validator/syntax.py | 4 ++--
|
||||
2 files changed, 3 insertions(+), 3 deletions(-)
|
||||
|
||||
diff --git a/email_validator/__main__.py b/email_validator/__main__.py
|
||||
index 52791c7..caa111b 100644
|
||||
--- a/email_validator/__main__.py
|
||||
+++ b/email_validator/__main__.py
|
||||
@@ -38,7 +38,7 @@ def main(dns_resolver: Optional[_Resolver] = None) -> None:
|
||||
options[varname.lower()] = float(os.environ[varname])
|
||||
|
||||
if len(sys.argv) == 1:
|
||||
- # Validate the email addresses pased line-by-line on STDIN.
|
||||
+ # Validate the email addresses passed line-by-line on STDIN.
|
||||
dns_resolver = dns_resolver or caching_resolver()
|
||||
for line in sys.stdin:
|
||||
email = line.strip()
|
||||
diff --git a/email_validator/syntax.py b/email_validator/syntax.py
|
||||
index c655451..f53fd5b 100644
|
||||
--- a/email_validator/syntax.py
|
||||
+++ b/email_validator/syntax.py
|
||||
@@ -57,7 +57,7 @@ def split_string_at_unquoted_special(text: str, specials: Tuple[str, ...]) -> Tu
|
||||
for i, c in enumerate(text):
|
||||
# < plus U+0338 (Combining Long Solidus Overlay) normalizes to
|
||||
# ≮ U+226E (Not Less-Than), and it would be confusing to treat
|
||||
- # the < as the start of "<email>" syntax in that case. Liekwise,
|
||||
+ # the < as the start of "<email>" syntax in that case. Likewise,
|
||||
# if anything combines with an @ or ", we should probably not
|
||||
# treat it as a special character.
|
||||
if unicodedata.normalize("NFC", text[i:])[0] != c:
|
||||
@@ -642,7 +642,7 @@ def validate_email_length(addrinfo: ValidatedEmail) -> None:
|
||||
# form is checked first because it is the original input.
|
||||
# 2) The normalized email address. We perform Unicode NFC normalization of
|
||||
# the local part, we normalize the domain to internationalized characters
|
||||
- # (if originaly IDNA ASCII) which also includes Unicode normalization,
|
||||
+ # (if originally IDNA ASCII) which also includes Unicode normalization,
|
||||
# and we may remove quotes in quoted local parts. We recommend that
|
||||
# callers use this string, so it must be valid.
|
||||
# 3) The email address with the IDNA ASCII representation of the domain
|
||||
@ -0,0 +1,151 @@
|
||||
.TH EMAIL_VALIDATOR "1" "June 2024" "" "User Commands"
|
||||
.SH NAME
|
||||
.B email_validator
|
||||
\(en Validate email addresses
|
||||
.SH SYNOPSIS
|
||||
.B email_validator
|
||||
.I test@example.org
|
||||
.P
|
||||
.B email_validator <
|
||||
.I LIST_OF_ADDRESSES.TXT
|
||||
.SH DESCRIPTION
|
||||
Provide email addresses to validate
|
||||
either as a command-line argument or in
|
||||
.I STDIN
|
||||
separated by newlines.
|
||||
Validation errors will be printed for invalid email addresses.
|
||||
When passing an email address on the command line,
|
||||
if the email address is valid,
|
||||
information about it will be printed.
|
||||
When using
|
||||
.IR STDIN ,
|
||||
no output will be given for valid email addresses.
|
||||
.P
|
||||
Keyword arguments to the Python
|
||||
.B email_validator.validate_email
|
||||
function can be set in environment variables
|
||||
of the same name but uppercase (see
|
||||
.BR ENVIRONMENT ).
|
||||
.SH ENVIRONMENT
|
||||
.\" Supported environment variables can be read
|
||||
.\" from near the beginning of the main() function
|
||||
.\" in email_validator/__main__.py.
|
||||
.\"
|
||||
.\" Default values are in email_validator/__init__.py.
|
||||
.\"
|
||||
.\" Option descriptions are in README.md.
|
||||
.SS "BOOLEAN"
|
||||
For these environment variables,
|
||||
any non-empty string value is interpreted as
|
||||
.BR True ,
|
||||
the empty string is interpreted as
|
||||
.BR False ,
|
||||
and a default value is used if the variable is unset.
|
||||
.TP
|
||||
.B ALLOW_SMPTUTF8
|
||||
Set to false to prohibit internationalized addresses
|
||||
that would require the
|
||||
.UR https://tools.ietf.org/html/rfc6531
|
||||
SMTPUTF8
|
||||
.UE
|
||||
extension.
|
||||
.IP
|
||||
.IR default :
|
||||
true
|
||||
.\" Support ALLOW_DISPLAY_NAME and ALLOW_EMPTY_LOCAL in the CLI
|
||||
.\" https://github.com/JoshData/python-email-validator/pull/145
|
||||
.\" .TP
|
||||
.\" .B ALLOW_EMPTY_LOCAL
|
||||
.\" Set to true to allow an empty local part
|
||||
.\" (i.e. \fB@example.com\fR),
|
||||
.\" e.g. for validating Postfix aliases.
|
||||
.TP
|
||||
.B ALLOW_QUOTED_LOCAL
|
||||
Set to true to allow obscure and potentially problematic email addresses
|
||||
in which the part of the address before the
|
||||
.BR @ \-sign
|
||||
contains spaces,
|
||||
.BR @ \-signs,
|
||||
or other surprising characters
|
||||
when the local part is surrounded in quotes
|
||||
(so-called quoted-string local parts).
|
||||
In the object returned on successful validation,
|
||||
the normalized local part removes any unnecessary backslash-escaping
|
||||
and even removes the surrounding quotes
|
||||
if the address would be valid without them.
|
||||
.IP
|
||||
.IR default :
|
||||
false
|
||||
.TP
|
||||
.B ALLOW_DOMAIN_LITERAL
|
||||
Set to true to allow bracketed IPv4 and "IPv6:"-prefixed IPv6 addresses
|
||||
in the domain part of the email address.
|
||||
No deliverability checks are performed for these addresses.
|
||||
In the object returned on successful validation,
|
||||
the normalized domain will use the condensed IPv6 format, if applicable.
|
||||
The object\(cqs
|
||||
.B domain_address
|
||||
attribute will hold the parsed
|
||||
.B ipaddress.IPv4Address
|
||||
or
|
||||
.B ipaddress.IPv6Address
|
||||
object if applicable.
|
||||
.IP
|
||||
.IR default :
|
||||
false
|
||||
.\" Support ALLOW_DISPLAY_NAME and ALLOW_EMPTY_LOCAL in the CLI
|
||||
.\" https://github.com/JoshData/python-email-validator/pull/145
|
||||
.\" .TP
|
||||
.\" .B ALLOW_DISPLAY_NAME
|
||||
.\" Set to true to allow a display name and bracketed address
|
||||
.\" in the input string, like
|
||||
.\" .BR My\ Name\ <me@example.org> .
|
||||
.\" It\(cqs implemented in the spirit but not the letter of RFC 5322 3.4,
|
||||
.\" so it may be stricter or more relaxed than what you want.
|
||||
.\" The display name, if present, is provided in the returned object\(cqs
|
||||
.\" .Bdisplay_name
|
||||
.\" field after being unquoted and unescaped.
|
||||
.\" .IP
|
||||
.\" .IR default :
|
||||
.\" false
|
||||
.TP
|
||||
.B GLOBALLY_DELIVERABLE
|
||||
.IP
|
||||
.IR default :
|
||||
true
|
||||
.TP
|
||||
.B CHECK_DELIVERABILITY
|
||||
If true, DNS queries are made
|
||||
to check that the domain name in the email address
|
||||
(the part after the
|
||||
.BR @ \-sign)
|
||||
can receive mail\(embasically,
|
||||
that the domain name in the email address has
|
||||
a (non-Null) DNS MX record indicating that it can receive email.
|
||||
If false, skip this DNS-based check.
|
||||
It is recommended to set this to false
|
||||
when performing validation for login pages
|
||||
(but not account creation pages)
|
||||
since re-validation of a previously validated domain in your database
|
||||
by querying DNS at every login is probably undesirable.
|
||||
.IP
|
||||
.IR default :
|
||||
true
|
||||
.TP
|
||||
.B TEST_ENVIRONMENT
|
||||
If true, DNS-based deliverability checks are disabled and
|
||||
.B test
|
||||
and
|
||||
.B **.test
|
||||
domain names are permitted.
|
||||
.IP
|
||||
.IR default :
|
||||
false
|
||||
.SS "FLOATING-POINT"
|
||||
For these environment variables,
|
||||
any non-empty string is parsed as a floating-point value,
|
||||
and a default value is used if the variable is unset.
|
||||
.TP
|
||||
.B DEFAULT_TIMEOUT
|
||||
.IR default :
|
||||
15
|
||||
Loading…
Reference in new issue