run-tests: add some docstrings
authorGregory Szorc <gregory.szorc@gmail.com>
Sun, 20 Apr 2014 10:28:35 -0700
changeset 21383 772ed56e2519
parent 21382 4b8ffe3abdd2
child 21384 a36cc85a5b7b
run-tests: add some docstrings
tests/run-tests.py
--- a/tests/run-tests.py	Sun Apr 20 10:24:00 2014 -0700
+++ b/tests/run-tests.py	Sun Apr 20 10:28:35 2014 -0700
@@ -128,6 +128,7 @@
     return entries
 
 def getparser():
+    """Obtain the OptionParser used by the CLI."""
     parser = optparse.OptionParser("%prog [options] [tests]")
 
     # keep these sorted
@@ -208,6 +209,7 @@
     return parser
 
 def parseargs(args, parser):
+    """Parse arguments with our OptionParser and validate results."""
     (options, args) = parser.parse_args(args)
 
     # jython is always pure
@@ -370,6 +372,10 @@
             shutil.rmtree(self._threadtmp, True)
 
     def run(self):
+        """Run this test instance.
+
+        This will return a tuple describing the result of the test.
+        """
         if not os.path.exists(self._path):
             return self.skip("Doesn't exist")