X-Git-Url: https://gitweb.michael.orlitzky.com/?a=blobdiff_plain;f=test%2F__main__.py;h=c8f0f24369debd78bf06b0e4c16f441e16858b67;hb=4a9928501f79549742c2e335742ddc65040f744f;hp=175c884766c899a6cd668ded6ec00b601d1848e0;hpb=bdb596b84a06d0c97e39d42586a51fc36ba44186;p=dunshire.git

diff --git a/test/__main__.py b/test/__main__.py
old mode 100644
new mode 100755
index 175c884..c8f0f24
--- a/test/__main__.py
+++ b/test/__main__.py
@@ -1,3 +1,58 @@
+#!/usr/bin/env python
+"""
+An implementation of __main__() that allows us to "run this module."
+"""
+from sys import argv
+
 from test import build_suite, run_suite
 
-run_suite(build_suite())
+
+def main(doctests, loop, verbose):
+    """
+    The main function for this module. It runs the tests.
+
+    We take two command-line arguments. The first enables you to turn
+    off the doctests, which are deterministic. The second tells us to
+    repeat the test suite indefinitely rather than return the result of
+    running it once. The flags usually occur together so that we don't
+    waste time running the doctests in a loop.
+
+    Parameters
+    ----------
+
+    doctests : bool
+        Do you want to run the doctests?
+
+    loop : bool
+        Do you want to loop and rerun the tests indefinitely?
+
+    verbose : bool
+        Do you want to see the name and result of each test as
+        it is run?
+
+    """
+    # Running the test suite clobbers it! And deepcopy() doesn't work
+    # on a suite that contains doctests! ARRRGRRGRRGRHG!!!!!! You're all
+    # idiots.
+    verbosity = 1
+    if verbose: verbosity = 2
+    result = run_suite(build_suite(doctests), verbosity)
+
+    if result.wasSuccessful() and not loop:
+        return 0
+
+    if loop:
+        passed = 0
+        while result.wasSuccessful():
+            print('Passed: {:d}'.format(passed))
+            passed += 1
+            result = run_suite(build_suite(doctests), verbosity)
+
+    return 1
+
+
+if __name__ == '__main__':
+    doctests = not "--no-doctests" in argv
+    loop = '--loop' in argv
+    verbose = '--verbose' in argv
+    exit(main(doctests, loop, verbose))