diff options
author | Brett Cannon <bcannon@gmail.com> | 2003-04-30 01:42:35 (GMT) |
---|---|---|
committer | Brett Cannon <bcannon@gmail.com> | 2003-04-30 01:42:35 (GMT) |
commit | e6b7033e7955573e3a62975b1e1ef2f41a1419dc (patch) | |
tree | 1118a53429e97daafeda035cab7e38f12158ec0c /Lib/test/README | |
parent | 533366beb007c1b9d917f9abaee4dd7db6ff3c4e (diff) | |
download | cpython-e6b7033e7955573e3a62975b1e1ef2f41a1419dc.zip cpython-e6b7033e7955573e3a62975b1e1ef2f41a1419dc.tar.gz cpython-e6b7033e7955573e3a62975b1e1ef2f41a1419dc.tar.bz2 |
Flesh out test_support docs.
Diffstat (limited to 'Lib/test/README')
-rw-r--r-- | Lib/test/README | 22 |
1 files changed, 19 insertions, 3 deletions
diff --git a/Lib/test/README b/Lib/test/README index daa3273..496c400 100644 --- a/Lib/test/README +++ b/Lib/test/README @@ -332,10 +332,22 @@ test_support provides the following useful objects: platform doesn't offer all the required facilities (like large file support), even if all the required modules are available. + * ``ResourceDenied`` - this is raised when a test requires a resource that + is not available. Primarily used by 'requires'. + * ``verbose`` - you can use this variable to control print output. Many modules use it. Search for "verbose" in the test_*.py files to see lots of examples. + * ``forget(module_name)`` - attempts to cause Python to "forget" that it + loaded a module and erase any PYC files. + + * ``is_resource_enabled(resource)`` - Returns a boolean based on whether + the resource is enabled or not. + + * ``requires(resource [, msg])`` - if the required resource is not + available the ResourceDenied exception is raised. + * ``verify(condition, reason='test failed')``. Use this instead of:: assert condition[, reason] @@ -344,6 +356,10 @@ test_support provides the following useful objects: mode, and it raises ``TestFailed`` on failure instead of ``AssertionError``. + * ``have_unicode`` - true if Unicode is available, false otherwise. + + * ``is_jython`` - true if the interpreter is Jython, false otherwise. + * ``TESTFN`` - a string that should always be used as the filename when you need to create a temp file. Also use ``try``/``finally`` to ensure that your temp files are deleted before your test completes. @@ -359,13 +375,13 @@ test_support provides the following useful objects: somewhere along sys.path or in the Lib/test tree - see test_linuxaudiodev.py for an example of its use. - * ``use_large_resources`` - true iff tests requiring large time or space - should be run. - * ``fcmp(x,y)`` - you can call this function to compare two floating point numbers when you expect them to only be approximately equal withing a fuzz factor (``test_support.FUZZ``, which defaults to 1e-6). + * ``check_syntax(statement)`` - make sure that the statement is *not* + correct Python syntax. + Python and C statement coverage results are currently available at |