Dear All
as you can see I have updated the doc string for
Run_unit_tests.__init__ could you have a look and see if it makes sense
(the previous incarnation patently didn't ;-) )
note:
1 Please note that of course the implementation is trailing the
documentation...
2. There are FIXMES and other notes still floating around
regards
gary
garyt@xxxxxxxxxxxxxxx wrote:
>Author: varioustoxins
>Date: Mon Mar 5 10:52:07 2007
>New Revision: 3080
>
>URL: http://svn.gna.org/viewcvs/relax?rev=3080&view=rev
>Log:
>improve command line docs and doc string for Run_unit_tests.__init__
>
>
>Modified:
> 1.3/test_suite/unit_tests/unit_test_runner.py
>
>Modified: 1.3/test_suite/unit_tests/unit_test_runner.py
>URL:
http://svn.gna.org/viewcvs/relax/1.3/test_suite/unit_tests/unit_test_runner.py?rev=3080&r1=3079&r2=3080&view=diff
>==============================================================================
>--- 1.3/test_suite/unit_tests/unit_test_runner.py (original)
>+++ 1.3/test_suite/unit_tests/unit_test_runner.py Mon Mar 5 10:52:07 2007
>@@ -56,9 +56,14 @@
>
> import os,re,unittest,string,sys
> from optparse import OptionParser
>+from textwrap import dedent
>
> #import Tkinter as tk
> #import unittest.unittestgui as unitgui
>+
>+# constants
>+###########
>+PY_FILE_EXTENSION='py'
>
> # utility functions
> ###################
>@@ -287,23 +292,27 @@
>
> @type root_path: a string containing a directory name
> @param root_path: root path to start searching for modules to
unit test
>- from usually this is the current working directory.
>+ from. Two special cases arise: if the string contains '.'
>+ the search starts from the current working directory, if
the value is
>+ the special value TEST_SUITE defined in this file the root
of the
>+ test suite is sought from the current working directory
using
>+ find_unit_test_directory_path() and used instead.
>
> @type test_module: string
> @param test_module: the name of a module to unit test. If the
variable
>- is None it will be interpreted as
>- the current working directory
>- contents. Otherwise it will be used as a module path from
the
>+ is None a search for unit tests using <test-pattern> will
start
>+ form <root_path>, otherwise it will be used as a module
path from the
> current working directory.
>
>- @type test_pattern: a list of strings containing patterns
>- @param test_pattern: a list of patterns against which files will
be
>+ FIXME: rename as testcase_file_pattern
>+ @type test_pattern: a list of strings containing regex patterns
>+ @param test_pattern: a list of regex patterns against which files
will be
> tested to see if they are expected to contain unit tests.
If
>- the file has the correct pattern the class
>- <fileName>.<capitalisedFileName> will be searched for
>- testCases e.g in the case of test_float.py the combination
>- would be test_float.Test_float.
>-
>+ the file has the correct pattern the module contained
inside the
>+ file will be searched for testCases e.g in the case of
test_float.py
>+ the module to be searched for would be
test_float.Test_float.
>+
>+ FIXME: the following to options are search paths and should be
named so
> @type rootSystemDirectory: a list containing a directory name
followed by a
> relative path
> @param rootSystemDirectory: the directory from which the
distribution
>@@ -312,13 +321,16 @@
> relative to the test suite. For the current setup
> in relax this is (\'test_suite\', /'..\'). The first
string is a
> directory to match the second string is a relative path
from that
>- directory to the system directory
>+ directory to the system directory. The search is started
from the true
>+ value of root_path in the file system.
>
> @type root_unit_test_directory: a list containing a directory
name followed by a
> relative path
> @param root_unit_test_directory: the directory from which all unit
> module directories descend. For the current setup in relax
>- this is (\'unit_tests\', \'.\').
>+ this is (\'unit_tests\', \'.\'). The search is started
from the true
>+ value of root_path in the file system.
>+
> @type verbose: Boolean
> @param verbose: produce verbose output during testing e.g.
directories
> searched root directories etc
>@@ -431,6 +443,7 @@
> elems = python_module_path.split('.')
> return os.sep.join(elems)
>
>+# FIXME: logic error two uses for self.testModule
> def paths_from_test_module(self, root_path):
> '''Determine the possible path of the self.test_module.
>
>@@ -441,6 +454,7 @@
> 2. the rootPath itself (self.testModule == None)
> 3. a file or directory relative to the unitTestRootPath
> 4. the unit test directory itself (self.testModule == None)
>+
>
> currently this assumes that if the last two names in testModule
are
> the same barring an initial capital letter in the class name
>@@ -559,7 +573,33 @@
>
> parser.add_option("-v", "--verbose", dest="verbose",
> help="verbose test ouput", default=False,
action='store_true')
>+
>+ usage="""
>+ %%prog [options] [<file-or-dir>...]
>+
>+ a program to find and run subsets of the relax unit test suite using
pyunit.
>+ (details of how to write pyunit tests can be found in your python
distributions
>+ library reference)
>+
>+
>+ arguments:
>+ <file-or-dir> = <file-path> | <dir-path> is a list which can contain
>+ inter-mixed directories and files
>+
>+ <file-path> = a file containing a test case class files of the same
>+ name with the first letter capitalised
>+
>+ e.g. maths_fns/test_chi2.py will be assumed to contain
>+ a test case class called Test_chi2
>+
>+ <dir-path> = a path which will be recursivley searched for
<file-path>s
>+ which end in %s
>+ """ % PY_FILE_EXTENSION
>+
>+ parser.set_usage(dedent(usage))
>+
> (options, args) = parser.parse_args()
>+
>
> for arg in args:
> runner = Run_unit_tests(test_module=arg, verbose=options.verbose)
>
>
>_______________________________________________
>relax (http://nmr-relax.com)
>
>This is the relax-commits mailing list
>relax-commits@xxxxxxx
>
>To unsubscribe from this list, get a password
>reminder, or change your subscription options,
>visit the list information page at
>https://mail.gna.org/listinfo/relax-commits
>
>.
>
>
>
--
-------------------------------------------------------------------
Dr Gary Thompson
Astbury Centre for Structural Molecular Biology,
University of Leeds, Astbury Building,
Leeds, LS2 9JT, West-Yorkshire, UK Tel. +44-113-3433024
email: garyt@xxxxxxxxxxxxxxx Fax +44-113-2331407
-------------------------------------------------------------------
_______________________________________________
relax (http://nmr-relax.com)
This is the relax-devel mailing list
relax-devel@xxxxxxx
To unsubscribe from this list, get a password
reminder, or change your subscription options,
visit the list information page at
https://mail.gna.org/listinfo/relax-devel