In the __main__ tool read options to validate_email from environment variables

Author: JoshData

CHANGELOG.md

@@ -13,6 +13,7 @@ There are no significant changes to which email addresses are considered valid/i
 * Some other error messages have changed to not repeat the email address in the error message.
 * The library has been reorganized internally into smaller modules.
 * The tests have been reorganized and expanded. Deliverability tests now mostly use captured DNS responses so they can be run off-line.
+* The __main__ tool now reads options to validate_email from environment variables.
 * Type annotations have been added to the exported methods and the ValidatedEmail class and some internal methods.
 
 Version 1.3.1 (January 21, 2023)

email_validator/__main__.py

@@ -10,8 +10,12 @@
 # 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 STDIN, no output will be given for valid email addresses.
+#
+# Keyword arguments to validate_email can be set in environment variables
+# of the same name but upprcase (see below).
 
 import json
+import os
 import sys
 
 from .validate_email import validate_email
@@ -22,20 +26,30 @@
 def main(dns_resolver=None):
     # The dns_resolver argument is for tests.
 
+    # Set options from environment variables.
+    options = {}
+    for varname in ('ALLOW_SMTPUTF8', 'ALLOW_QUOTED_LOCAL', 'GLOBALLY_DELIVERABLE',
+                    'CHECK_DELIVERABILITY', 'TEST_ENVIRONMENT'):
+        if varname in os.environ:
+            options[varname.lower()] = bool(os.environ[varname])
+    for varname in ('DEFAULT_TIMEOUT',):
+        if varname in os.environ:
+            options[varname.lower()] = float(os.environ[varname])
+
     if len(sys.argv) == 1:
         # Validate the email addresses pased line-by-line on STDIN.
         dns_resolver = dns_resolver or caching_resolver()
         for line in sys.stdin:
             email = line.strip()
             try:
-                validate_email(email, dns_resolver=dns_resolver)
+                validate_email(email, dns_resolver=dns_resolver, **options)
             except EmailNotValidError as e:
                 print(f"{email} {e}")
     else:
         # Validate the email address passed on the command line.
         email = sys.argv[1]
         try:
-            result = validate_email(email, dns_resolver=dns_resolver)
+            result = validate_email(email, dns_resolver=dns_resolver, **options)
             print(json.dumps(result.as_dict(), indent=2, sort_keys=True, ensure_ascii=False))
         except EmailNotValidError as e:
             print(e)