From: Brett Cannon <bcannon@gmail.com>
Date: Sun, 30 Aug 2009 08:39:57 +0000 (+0000)
Subject: Provide module docstrings for the two main test drivers in importlib that
X-Git-Tag: v3.2a1~2651
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=12c3fc934376d89168f5b072a833aa7bdd4ecd60;p=python

Provide module docstrings for the two main test drivers in importlib that
explain what they are for and how to use command-line arguments to tweak
semantics.
---

diff --git a/Lib/importlib/test/__main__.py b/Lib/importlib/test/__main__.py
index 89e139191a..b97e382195 100644
--- a/Lib/importlib/test/__main__.py
+++ b/Lib/importlib/test/__main__.py
@@ -1,3 +1,9 @@
+"""Run importlib's test suite.
+
+Specifying the ``--builtin`` flag will run tests, where applicable, with
+builtins.__import__ instead of importlib.__import__.
+
+"""
 import importlib
 from importlib.test.import_ import util
 import os.path
diff --git a/Lib/importlib/test/regrtest.py b/Lib/importlib/test/regrtest.py
index 7010165c20..17e7f4ef79 100644
--- a/Lib/importlib/test/regrtest.py
+++ b/Lib/importlib/test/regrtest.py
@@ -1,8 +1,11 @@
 """Run Python's standard test suite using importlib.__import__.
 
+Tests known to fail because of assumptions that importlib (properly)
+invalidates are automatically skipped if the entire test suite is run.
+Otherwise all command-line options valid for test.regrtest are also valid for
+this script.
+
 XXX FAILING
-    test___all__  # tuple being given for fromlist (looks like interpreter is
-                    doing it)
     test_builtin  # Wanting a TypeError for an integer name
     test_import  # execution bit, exception name differing, file name differing
                     between code and module (?)