cpython/Lib/test
Fred Drake 9a0a65b524 Merged revisions 67528 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67528 | fred.drake | 2008-12-04 13:25:17 -0500 (Thu, 04 Dec 2008) | 4 lines

  Issue #1055234: cgi.parse_header(): Fixed parsing of header parameters to
  support unusual filenames (such as those containing semi-colons) in
  Content-Disposition headers.
........
2008-12-04 19:24:50 +00:00
..
crashers Issue #4407: Fix source file that caused the compileall step in Windows 2008-11-30 10:36:49 +00:00
decimaltestdata Merged revisions 65257 via svnmerge from 2008-07-31 16:32:12 +00:00
leakers
__init__.py
185test.db
audiotest.au
autotest.py
bad_coding2.py
bad_coding.py
badcert.pem
badkey.pem
badsyntax_3131.py
badsyntax_future3.py
badsyntax_future4.py
badsyntax_future5.py
badsyntax_future6.py
badsyntax_future7.py
badsyntax_future8.py
badsyntax_future9.py
badsyntax_nocaret.py
badsyntax_pep3120.py
buffer_tests.py Removed PyInt_GetMax and sys.maxint 2007-12-04 23:02:19 +00:00
cfgparser.1
check_soundcard.vbs
cjkencodings_test.py Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from 2008-02-09 02:18:51 +00:00
cmath_testcases.txt Merged revisions 62380,62382-62383 via svnmerge from 2008-04-19 00:31:39 +00:00
curses_tests.py Merged revisions 60094-60123 via svnmerge from 2008-01-20 09:06:41 +00:00
dis_module.py
doctest_aliases.py
double_const.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
empty.vbs
exception_hierarchy.txt Merged revisions 59275-59303 via svnmerge from 2007-12-03 21:02:03 +00:00
floating_points.txt Added missing file 2007-12-10 22:27:18 +00:00
fork_wait.py Rename thread to _thread and dummy_thread to _dummy_thread. Issue #2875. 2008-05-25 13:05:15 +00:00
https_svn_python_org_root.pem
ieee754.txt Quick fix for test_math failures on Solaris 10 buildbot. For future 2008-06-18 10:04:31 +00:00
inspect_fodder2.py Patch from Georg Brandl and me for #1493 2007-11-25 09:39:14 +00:00
inspect_fodder.py
keycert.pem
list_tests.py Issue 3689: list_reverseiterator should support __length_hint__ instead of __len__. 2008-12-02 21:33:45 +00:00
mapping_tests.py Migrate remaining tests from UserDict.UserDict to collections.UserDict. 2008-02-06 00:07:11 +00:00
nullcert.pem
outstanding_bugs.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
pickletester.py #4298: pickle.load() can segfault on invalid or truncated input. 2008-11-11 20:05:06 +00:00
profilee.py Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60568-60598,60600-60616 via svnmerge from 2008-02-06 14:31:34 +00:00
pyclbr_input.py
pydoc_mod.py Merged revisions 63724,63726,63732,63744,63754-63755,63757-63758,63760,63775,63781-63782,63787,63805-63808,63818-63819,63823-63824 via svnmerge from 2008-06-10 16:57:31 +00:00
pydocfodder.py Merged revisions 60176-60209 via svnmerge from 2008-01-23 08:24:23 +00:00
pystone.py Merged revisions 65012,65035,65037-65040,65048,65057,65077,65091-65095,65097-65099,65127-65128,65131,65133-65136,65139,65149-65151,65155,65158-65159,65176-65178,65183-65184,65187-65190,65192,65194 via svnmerge from 2008-07-23 16:10:53 +00:00
randv2_32.pck Merged revisions 59275-59303 via svnmerge from 2007-12-03 21:02:03 +00:00
randv2_64.pck Merged revisions 59275-59303 via svnmerge from 2007-12-03 21:02:03 +00:00
randv3.pck Merged revisions 59275-59303 via svnmerge from 2007-12-03 21:02:03 +00:00
re_tests.py #2834: Change re module semantics, so that str and bytes mixing is forbidden, 2008-08-19 17:56:33 +00:00
README remove test.support.have_unicode 2008-05-26 17:44:33 +00:00
regex_tests.py Remove several mentions of old Python versions that don't apply anymore. 2008-01-05 20:00:55 +00:00
regrtest.py unbreak test_cprofile 2008-10-06 21:03:05 +00:00
relimport.py Another missing file after merge from trunk. 2008-03-20 01:10:45 +00:00
reperf.py
sample_doctest.py
seq_tests.py Closes release blocker #3627. 2008-08-24 07:08:55 +00:00
sgml_input.html
sortperf.py
ssl_cert.pem
ssl_key.pem
string_tests.py Merged revisions 66631 via svnmerge from 2008-09-26 22:48:41 +00:00
support.py forward port r66386 2008-10-16 23:24:44 +00:00
svn_python_org_https_cert.pem
test___all__.py Merged revisions 66321 via svnmerge from 2008-09-09 01:52:27 +00:00
test___future__.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test__locale.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_abc.py Issue #2534: speed up isinstance() and issubclass() by 50-70%, so as to 2008-08-26 22:40:48 +00:00
test_abstract_numbers.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_array.py Merged revisions 66703,66708 via svnmerge from 2008-10-10 22:20:52 +00:00
test_ast.py Merged revisions 63829-63831,63858,63865,63879,63882,63948,63970-63972,63976,63989,64014-64015,64021-64022,64063-64065,64067 via svnmerge from 2008-06-10 16:37:50 +00:00
test_asynchat.py Committing Py3k version of changelist 64080 and 64257, along with updated tests 2008-07-07 04:15:08 +00:00
test_asyncore.py Issue #3782: os.write() must not accept unicode strings 2008-09-15 23:02:56 +00:00
test_atexit.py merge from trunk 2008-10-11 00:49:57 +00:00
test_audioop.py Merged revisions 65012,65035,65037-65040,65048,65057,65077,65091-65095,65097-65099,65127-65128,65131,65133-65136,65139,65149-65151,65155,65158-65159,65176-65178,65183-65184,65187-65190,65192,65194 via svnmerge from 2008-07-23 16:10:53 +00:00
test_augassign.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_base64.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_bigaddrspace.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_bigmem.py Closes release blocker #3627. 2008-08-24 07:08:55 +00:00
test_binascii.py Issue #4387: binascii now refuses to accept str as binary input. 2008-12-02 06:00:15 +00:00
test_binhex.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_binop.py division is no longer a future thing for test_binop 2008-06-28 23:34:00 +00:00
test_bisect.py merge from trunk 2008-10-11 00:49:57 +00:00
test_bool.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_bufio.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_builtin.py #3946 fix PyObject_CheckBuffer on a memoryview object 2008-09-26 21:49:22 +00:00
test_bytes.py Merged revisions 67295,67301-67302,67318,67330,67342-67343 via svnmerge from 2008-11-22 22:18:04 +00:00
test_bz2.py Merged revisions 64623,64640,64665,64687,64689-64690,64719,64721,64735,64742,64744-64746,64756-64761,64767-64769,64771-64772,64774-64775,64788,64793,64835-64836 via svnmerge from 2008-07-16 03:43:04 +00:00
test_calendar.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_call.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_capi.py add tests for PyInstanceMethod_Type 2008-10-16 23:56:29 +00:00
test_cfgparser.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_cgi.py Merged revisions 67528 via svnmerge from 2008-12-04 19:24:50 +00:00
test_charmapcodec.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_class.py remove some more references to __cmp__ #1717 2008-10-16 19:34:46 +00:00
test_cmath.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_cmd_line_script.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_cmd_line.py Enable this test only when subprocess supports non-ascii arguments. 2008-11-12 00:59:11 +00:00
test_cmd.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_code.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codeccallbacks.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codecencodings_cn.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codecencodings_hk.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codecencodings_jp.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codecencodings_kr.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codecencodings_tw.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codecmaps_cn.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codecmaps_hk.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codecmaps_jp.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codecmaps_kr.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codecmaps_tw.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_codecs.py Issue #2394: implement more of the memoryview API. 2008-08-19 22:09:34 +00:00
test_codeop.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_coding.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_collections.py Devil merge! 2008-09-28 02:06:32 +00:00
test_colorsys.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_compare.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_compile.py now that exec is a function, we can use the shorter assertRaises to test 2008-06-30 15:01:21 +00:00
test_complex.py Merged revisions 63829-63831,63858,63865,63879,63882,63948,63970-63972,63976,63989,64014-64015,64021-64022,64063-64065,64067 via svnmerge from 2008-06-10 16:37:50 +00:00
test_contains.py Issue #4296: Fix PyObject_RichCompareBool so that "x in [x]" evaluates to 2008-11-12 23:23:36 +00:00
test_contextlib.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_copy.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_copyreg.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_cprofile.py Merged revisions 66677,66700 via svnmerge from 2008-10-07 02:32:59 +00:00
test_crypt.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_csv.py Merged revisions 65605 via svnmerge from 2008-08-09 19:44:22 +00:00
test_ctypes.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_curses.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_datetime.py merge from trunk 2008-10-11 00:49:57 +00:00
test_dbm_dumb.py dbm.gnu and dbm.ndbm accept both strings and bytes as keys and values. For the 2008-11-25 19:19:17 +00:00
test_dbm_gnu.py Fix a broken test_dbm_gnu as introducted by r67380. 2008-11-25 21:27:00 +00:00
test_dbm_ndbm.py dbm.gnu and dbm.ndbm accept both strings and bytes as keys and values. For the 2008-11-25 19:19:17 +00:00
test_dbm.py fix merge boo-boo 2008-10-11 02:19:18 +00:00
test_decimal.py Merged revisions 64475,64544-64545,64550,64557-64558,64565,64570,64577,64582-64583,64585,64590,64592-64593,64625,64630,64638,64647,64655-64656,64663-64664 via svnmerge from 2008-07-02 20:22:54 +00:00
test_decorators.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_defaultdict.py #4170: Fix segfault when pickling a defauldict object. 2008-10-30 20:58:42 +00:00
test_deque.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_descr.py Issue #4387: binascii now refuses to accept str as binary input. 2008-12-02 06:00:15 +00:00
test_descrtut.py Merged revisions 63856-63857,63859-63860 via svnmerge from 2008-06-04 14:18:43 +00:00
test_dict.py Merged revisions 65459,65472,65481,65518,65536,65581,65609,65637,65641,65644-65645 via svnmerge from 2008-08-12 08:35:52 +00:00
test_dictcomps.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_dictviews.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_difflib_expect.html
test_difflib.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_dis.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_distutils.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_doctest2.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_doctest2.txt
test_doctest3.txt Bug #2565: The repr() of type objects now calls them 'class', 2008-04-07 05:43:42 +00:00
test_doctest4.txt
test_doctest.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_doctest.txt
test_docxmlrpc.py merge from trunk 2008-10-11 00:49:57 +00:00
test_dummy_thread.py Merged revisions 64903 via svnmerge from 2008-07-13 01:19:15 +00:00
test_dummy_threading.py Merged revisions 65824 via svnmerge from 2008-08-18 18:09:21 +00:00
test_email.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_enumerate.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_eof.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_epoll.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_errno.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_exception_variations.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_exceptions.py Issue #2534: speed up isinstance() and issubclass() by 50-70%, so as to 2008-08-26 22:40:48 +00:00
test_extcall.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_fcntl.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_file.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_filecmp.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_fileinput.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_fileio.py make FileIO.mode always include 'b' 2008-11-22 00:41:45 +00:00
test_float.py Issue #4296: Fix PyObject_RichCompareBool so that "x in [x]" evaluates to 2008-11-12 23:23:36 +00:00
test_fnmatch.py Issue #3187: Better support for "undecodable" filenames. Code by Victor 2008-10-02 18:55:37 +00:00
test_fork1.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_format.py The Unicode database was updated to 5.1, and some characters have become printable. 2008-09-10 23:51:42 +00:00
test_fractions.py Merged revisions 64722,64729,64753,64845-64846,64849,64871,64880-64882,64885,64888,64897,64900-64901,64915,64926-64929,64938-64941,64944,64961,64966,64973 via svnmerge from 2008-07-16 12:55:28 +00:00
test_frozen.py fix #4211: the __path__ of a frozen package should be a list. 2008-11-05 22:48:33 +00:00
test_ftplib.py Merged revisions 66673 via svnmerge from 2008-09-28 21:00:42 +00:00
test_funcattrs.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_functools.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_future1.py
test_future2.py
test_future3.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_future4.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_future5.py Merged revisions 67030-67031 via svnmerge from 2008-10-26 20:58:53 +00:00
test_future.py Merged revisions 67066 via svnmerge from 2008-10-31 02:28:05 +00:00
test_gc.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_generators.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_genericpath.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_genexps.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_getargs2.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_getopt.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_gettext.py #2512 implement the 3.0 gettext API 2008-07-14 14:32:15 +00:00
test_glob.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_global.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_grammar.py add grammar tests for nonlocal 2008-10-24 22:16:39 +00:00
test_grp.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_gzip.py make FileIO.mode always include 'b' 2008-11-22 00:41:45 +00:00
test_hash.py remove some more references to __cmp__ #1717 2008-10-16 19:34:46 +00:00
test_hashlib.py Merged revisions 66496 via svnmerge from 2008-09-24 22:53:33 +00:00
test_heapq.py Remove 2.6 compatibility code: 2008-06-17 21:25:35 +00:00
test_hmac.py Merged revisions 66321 via svnmerge from 2008-09-09 01:52:27 +00:00
test_htmlparser.py Change test_htmlparser to reflect the HTMLParser -> html.parser 2008-05-21 13:51:18 +00:00
test_http_cookiejar.py - Issue #3300: make urllib.parse.[un]quote() default to UTF-8. 2008-08-18 21:44:30 +00:00
test_http_cookies.py Remove deprecated SmartCookie and SerialCookie classes. 2008-05-28 15:56:30 +00:00
test_httplib.py Merged revisions 63562,63570,63728,63734,63784,63788,63802,63817,63827,63839,63887,63975,63998 via svnmerge from 2008-06-10 17:40:04 +00:00
test_httpservers.py Make a new urllib package . 2008-06-18 20:49:58 +00:00
test_imaplib.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_imp.py Issue #3806: LockTests in test_imp should be skipped when thread is not available. 2008-09-09 07:33:27 +00:00
test_import.py forward port r66386 2008-10-16 23:24:44 +00:00
test_importhooks.py Merged revisions 65163 via svnmerge from 2008-07-20 23:21:49 +00:00
test_index.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_inspect.py Merged revisions 63829-63831,63858,63865,63879,63882,63948,63970-63972,63976,63989,64014-64015,64021-64022,64063-64065,64067 via svnmerge from 2008-06-10 16:37:50 +00:00
test_int_literal.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_int.py Issue #3236: Return small longs from PyLong_FromString. 2008-06-30 04:06:08 +00:00
test_io.py make FileIO.mode always include 'b' 2008-11-22 00:41:45 +00:00
test_ioctl.py Merged revisions 63542-63544,63546,63553,63563-63564,63567,63569,63576 via svnmerge from 2008-05-26 17:36:47 +00:00
test_isinstance.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_iter.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_iterlen.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_itertools.py Merged revisions 65259,65263,65296,65307,65321 via svnmerge from 2008-07-31 20:21:46 +00:00
test_json.py Merged revisions 63412,63445-63447,63449-63450,63452,63454,63459,63463,63465,63470,63483-63484,63496-63497,63499-63501,63530-63531,63540,63614 via svnmerge from 2008-05-25 18:19:30 +00:00
test_keywordonlyarg.py allow keyword args after *args in a function call 2008-08-19 20:57:10 +00:00
test_kqueue.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_largefile.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_lib2to3.py Merged revisions 66653-66654 via svnmerge from 2008-09-27 22:17:35 +00:00
test_list.py Merged revisions 65910,65977,65980,65984,65986,66000,66011-66012,66014,66017,66020 via svnmerge from 2008-08-25 21:05:21 +00:00
test_listcomps.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_locale.py Merged revisions 65244-65245,65248 via svnmerge from 2008-07-26 21:02:53 +00:00
test_logging.py Merged revisions 66337,66347,66350,66352,66358 via svnmerge from 2008-09-10 21:57:34 +00:00
test_long.py remove some more references to __cmp__ #1717 2008-10-16 19:34:46 +00:00
test_longexp.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_macpath.py Issue3187 for Macintosh platform: 2008-10-03 21:57:20 +00:00
test_mailbox.py Merged revisions 65459,65472,65481,65518,65536,65581,65609,65637,65641,65644-65645 via svnmerge from 2008-08-12 08:35:52 +00:00
test_marshal.py #2957: marshal recursion limit exceeded when importing a large .pyc file 2008-05-26 21:41:42 +00:00
test_math.py Merged revisions 65258,65292,65299,65308-65309,65315,65326 via svnmerge from 2008-08-01 08:16:13 +00:00
test_memoryio.py Issue 2918: Merge StringIO and cStringIO. 2008-06-11 22:58:36 +00:00
test_memoryview.py kill memoryview.size in favor of len(view) 2008-09-10 21:47:03 +00:00
test_metaclass.py fix test_metaclass 2008-07-01 20:26:36 +00:00
test_mimetypes.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_minidom.py Issue 2918: Merge StringIO and cStringIO. 2008-06-11 22:58:36 +00:00
test_mmap.py #2834: Change re module semantics, so that str and bytes mixing is forbidden, 2008-08-19 17:56:33 +00:00
test_module.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_modulefinder.py Merged revisions 67028,67040,67044,67046,67052,67065,67070,67077,67082 via svnmerge from 2008-11-03 20:31:38 +00:00
test_multibytecodec_support.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_multibytecodec.py Merged revisions 65012,65035,65037-65040,65048,65057,65077,65091-65095,65097-65099,65127-65128,65131,65133-65136,65139,65149-65151,65155,65158-65159,65176-65178,65183-65184,65187-65190,65192,65194 via svnmerge from 2008-07-23 16:10:53 +00:00
test_multiprocessing.py Merged revisions 66670,66681,66688,66696-66699 via svnmerge from 2008-10-04 22:00:42 +00:00
test_mutants.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_netrc.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_nis.py disable test_nis; it hangs 2008-08-19 23:02:38 +00:00
test_normalization.py Merged revisions 66369 via svnmerge from 2008-09-10 21:15:32 +00:00
test_ntpath.py Second part of #3187, for windows: 2008-10-03 18:38:26 +00:00
test_opcodes.py Merged revisions 63412,63445-63447,63449-63450,63452,63454,63459,63463,63465,63470,63483-63484,63496-63497,63499-63501,63530-63531,63540,63614 via svnmerge from 2008-05-25 18:19:30 +00:00
test_openpty.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_operator.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_optparse.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_os.py Fix Windows buildbot failures after r66469. 2008-09-15 23:54:52 +00:00
test_ossaudiodev.py #3567: fix sunau for running with -bb and make test_ossaudiodev work. 2008-08-17 00:38:32 +00:00
test_parser.py Merged revisions 67348,67355,67359,67362,67364-67365,67367-67368,67398,67423-67424,67432,67440-67441,67444-67445,67454-67455,67457-67458 via svnmerge from 2008-11-30 22:46:23 +00:00
test_peepholer.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pep247.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pep263.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pep277.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pep292.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pep352.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pep3120.py Latin-1 source code was not being properly decoded when passed through 2008-10-17 03:38:50 +00:00
test_pep3131.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pickle.py Restore _pickle module accelerator module. 2008-06-12 18:26:05 +00:00
test_pickletools.py Restore _pickle module accelerator module. 2008-06-12 18:26:05 +00:00
test_pipes.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pkg.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pkgimport.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pkgutil.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_platform.py Merged revisions 66974,66977,66984,66989,66992,66994-66996,66998-67000,67007,67015 via svnmerge from 2008-10-25 15:49:17 +00:00
test_plistlib.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_poll.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_popen.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_poplib.py Fixed issue #3727: poplib module broken by str to unicode conversion 2008-11-05 19:48:27 +00:00
test_posix.py Issue #3187: Better support for "undecodable" filenames. Code by Victor 2008-10-02 18:55:37 +00:00
test_posixpath.py Issue #3187: Better support for "undecodable" filenames. Code by Victor 2008-10-02 18:55:37 +00:00
test_pow.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pprint.py Merged revisions 64446,64490,64495,64526,64567 via svnmerge from 2008-07-16 03:00:45 +00:00
test_print.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_profile.py a trival fix to let test_profile pass if it runs after test_cprofile 2008-10-06 22:05:00 +00:00
test_profilehooks.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_property.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pstats.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pty.py Issue #3782: os.write() must not accept unicode strings 2008-09-15 23:02:56 +00:00
test_pwd.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_pyclbr.py Make a new urllib package . 2008-06-18 20:49:58 +00:00
test_pydoc.py Merged revisions 64475,64544-64545,64550,64557-64558,64565,64570,64577,64582-64583,64585,64590,64592-64593,64625,64630,64638,64647,64655-64656,64663-64664 via svnmerge from 2008-07-02 20:22:54 +00:00
test_pyexpat.py #2630: Implement PEP 3138. 2008-06-11 18:37:52 +00:00
test_queue.py Merged revisions 64125 via svnmerge from 2008-06-11 19:14:14 +00:00
test_quopri.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_raise.py Issue 3611: in some cases (a __del__ re-raising an exception, when called from inside 2008-08-29 07:13:32 +00:00
test_random.py Merged revisions 65258,65292,65299,65308-65309,65315,65326 via svnmerge from 2008-08-01 08:16:13 +00:00
test_range.py Issue #4183: Some tests didn't run with pickle.HIGHEST_PROTOCOL. 2008-10-23 00:38:15 +00:00
test_re.py Issue #3756: make re.escape() handle bytes as well as str. 2008-09-10 17:44:35 +00:00
test_reprlib.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_resource.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_richcmp.py remove some more references to __cmp__ #1717 2008-10-16 19:34:46 +00:00
test_robotparser.py Merged revisions 65209-65216,65225-65226,65233,65239,65246-65247,65255-65256 via svnmerge from 2008-07-31 16:23:04 +00:00
test_runpy.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_sax.py #2501 xml.sax.parser doesn't terminate when given a filename; enable some more tests! 2008-09-04 02:22:52 +00:00
test_scope.py Merged revisions 65012,65035,65037-65040,65048,65057,65077,65091-65095,65097-65099,65127-65128,65131,65133-65136,65139,65149-65151,65155,65158-65159,65176-65178,65183-65184,65187-65190,65192,65194 via svnmerge from 2008-07-23 16:10:53 +00:00
test_select.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_set.py Issue #1721812: Binary operations and copy operations on set/frozenset 2008-11-16 11:44:54 +00:00
test_setcomps.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_shelve.py Merged revisions 65209-65216,65225-65226,65233,65239,65246-65247,65255-65256 via svnmerge from 2008-07-31 16:23:04 +00:00
test_shlex.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_shutil.py Merged revisions 64722,64729,64753,64845-64846,64849,64871,64880-64882,64885,64888,64897,64900-64901,64915,64926-64929,64938-64941,64944,64961,64966,64973 via svnmerge from 2008-07-16 12:55:28 +00:00
test_signal.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_SimpleHTTPServer.py Create http package. #2883. 2008-05-26 16:32:26 +00:00
test_site.py Merged revisions 64365,64370,64406,64408-64409,64412,64416-64417,64420-64421,64425-64428 via svnmerge from 2008-07-02 16:11:42 +00:00
test_slice.py Merged revisions 64365,64370,64406,64408-64409,64412,64416-64417,64420-64421,64425-64428 via svnmerge from 2008-07-02 16:11:42 +00:00
test_smtplib.py Merged revisions 66028 via svnmerge from 2008-08-25 03:55:03 +00:00
test_socket.py make FileIO.mode always include 'b' 2008-11-22 00:41:45 +00:00
test_socketserver.py Merged revisions 65824 via svnmerge from 2008-08-18 18:09:21 +00:00
test_sort.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_sqlite.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_ssl.py fixes from issue 3162 for SSL module 2008-09-08 16:45:19 +00:00
test_startfile.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_strftime.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_string.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_stringprep.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_strlit.py
test_strptime.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_struct.py Merged revisions 66321 via svnmerge from 2008-09-09 01:52:27 +00:00
test_structmembers.py forward port r66386 2008-10-16 23:24:44 +00:00
test_structseq.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_subprocess.py Issue #3782: os.write() must not accept unicode strings 2008-09-15 23:02:56 +00:00
test_sundry.py forward port r66386 2008-10-16 23:24:44 +00:00
test_super.py Fix for bug 4360 "SystemError when method has both super() & closure". Patch 2008-11-20 20:01:57 +00:00
test_symtable.py revert 65897 2008-08-20 12:55:31 +00:00
test_syntax.py Merged revisions 64622 via svnmerge from 2008-07-01 20:03:27 +00:00
test_sys.py Benjamin Peterson's patch to fix bug 3661, sys.call_tracing segfaults. 2008-10-17 01:29:56 +00:00
test_syslog.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_tarfile.py Merged revisions 66539 via svnmerge from 2008-09-21 11:50:03 +00:00
test_tcl.py #2967: Tkinter -> tkinter in test_tcl. 2008-05-25 11:53:14 +00:00
test_telnetlib.py Merged revisions 63562,63570,63728,63734,63784,63788,63802,63817,63827,63839,63887,63975,63998 via svnmerge from 2008-06-10 17:40:04 +00:00
test_tempfile.py Fix Windows buildbot failures after r66469. 2008-09-15 23:54:52 +00:00
test_textwrap.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_thread.py Rename thread to _thread and dummy_thread to _dummy_thread. Issue #2875. 2008-05-25 13:05:15 +00:00
test_threaded_import.py Rename thread to _thread and dummy_thread to _dummy_thread. Issue #2875. 2008-05-25 13:05:15 +00:00
test_threadedtempfile.py fix small typo 2008-09-05 00:43:33 +00:00
test_threading_local.py Merged revisions 64601 via svnmerge from 2008-06-30 23:30:24 +00:00
test_threading.py forward port r66386 2008-10-16 23:24:44 +00:00
test_threadsignals.py Rename thread to _thread and dummy_thread to _dummy_thread. Issue #2875. 2008-05-25 13:05:15 +00:00
test_time.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_timeout.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_tokenize.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_trace.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_traceback.py Issues #2384 and #3975: Tracebacks were not correctly printed when the source file 2008-10-09 23:37:48 +00:00
test_tuple.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_typechecks.py Issue #2534: speed up isinstance() and issubclass() by 50-70%, so as to 2008-08-26 22:40:48 +00:00
test_types.py Merged revisions 65125 via svnmerge from 2008-07-19 00:33:23 +00:00
test_ucn.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_unary.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_unicode_file.py Make the test more robust in face of remaining files. 2008-10-03 19:34:30 +00:00
test_unicode.py The Unicode database was updated to 5.1, and some characters have become printable. 2008-09-10 23:51:42 +00:00
test_unicodedata.py Merged revisions 67320 via svnmerge from 2008-11-21 22:58:57 +00:00
test_unittest.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_univnewlines.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_unpack_ex.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_unpack.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_urllib2_localnet.py Make a new urllib package . 2008-06-18 20:49:58 +00:00
test_urllib2.py Issue #2776: fixed small issue when handling an URL with double slash 2008-08-16 14:44:32 +00:00
test_urllib2net.py Make a new urllib package . 2008-06-18 20:49:58 +00:00
test_urllib.py Merged revisions 66974,66977,66984,66989,66992,66994-66996,66998-67000,67007,67015 via svnmerge from 2008-10-25 15:49:17 +00:00
test_urllibnet.py #2491: os.fdopen() is now almost an alias to the builtin open(), and accepts the same parameters. 2008-08-01 00:06:49 +00:00
test_urlparse.py Issue 600362: Relocated parse_qs() and parse_qsl(), from the cgi module 2008-09-03 22:49:01 +00:00
test_userdict.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_userlist.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_userstring.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_uu.py Issue 2918: Merge StringIO and cStringIO. 2008-06-11 22:58:36 +00:00
test_uuid.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_wait3.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_wait4.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_warnings.py forward port r66386 2008-10-16 23:24:44 +00:00
test_wave.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_weakref.py Merged revisions 66337,66347,66350,66352,66358 via svnmerge from 2008-09-10 21:57:34 +00:00
test_weakset.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_winreg.py #3247 Get rid of Py_FindMethod; use tp_members instead. 2008-07-02 20:50:16 +00:00
test_winsound.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_with.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_wsgiref.py - Issue #3300: make urllib.parse.[un]quote() default to UTF-8. 2008-08-18 21:44:30 +00:00
test_xdrlib.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_xml_etree_c.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_xml_etree.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_xmlrpc_net.py revert r64092 because http://xmlrpc.com is back up 2008-06-11 02:37:01 +00:00
test_xmlrpc.py Make a new urllib package . 2008-06-18 20:49:58 +00:00
test_zipfile64.py #2971: test_zipfile64 fails. 2008-11-12 01:57:36 +00:00
test_zipfile.py Merged revisions 65235 via svnmerge from 2008-07-25 19:58:18 +00:00
test_zipimport.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00
test_zlib.py Issue #4387: binascii now refuses to accept str as binary input. 2008-12-02 06:00:15 +00:00
test.xml
test.xml.out
testcodec.py
testtar.tar Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60734 via svnmerge from 2008-02-11 22:57:17 +00:00
tf_inherit_check.py Issue #3782: os.write() must not accept unicode strings 2008-09-15 23:02:56 +00:00
threaded_import_hangers.py Merged revisions 64125 via svnmerge from 2008-06-11 19:14:14 +00:00
time_hashlib.py
tokenize_tests-latin1-coding-cookie-and-utf8-bom-sig.txt Ran svneol.py 2008-06-13 23:34:35 +00:00
tokenize_tests-no-coding-cookie-and-utf8-bom-sig-only.txt Ran svneol.py 2008-06-13 23:34:35 +00:00
tokenize_tests-utf8-coding-cookie-and-no-utf8-bom-sig.txt Ran svneol.py 2008-06-13 23:34:35 +00:00
tokenize_tests-utf8-coding-cookie-and-utf8-bom-sig.txt Ran svneol.py 2008-06-13 23:34:35 +00:00
tokenize_tests.txt
warning_tests.py
xmltests.py #2621 rename test.test_support to test.support 2008-05-20 21:35:26 +00:00

+++++++++++++++++++++++++++++++
Writing Python Regression Tests
+++++++++++++++++++++++++++++++

:Author: Skip Montanaro
:Contact: skip@pobox.com

Introduction
============

If you add a new module to Python or modify the functionality of an existing
module, you should write one or more test cases to exercise that new
functionality.  There are different ways to do this within the regression
testing facility provided with Python; any particular test should use only
one of these options.  Each option requires writing a test module using the
conventions of the selected option:

    - unittest_ based tests
    - doctest_ based tests
    - "traditional" Python test modules

Regardless of the mechanics of the testing approach you choose,
you will be writing unit tests (isolated tests of functions and objects
defined by the module) using white box techniques.  Unlike black box
testing, where you only have the external interfaces to guide your test case
writing, in white box testing you can see the code being tested and tailor
your test cases to exercise it more completely.  In particular, you will be
able to refer to the C and Python code in the CVS repository when writing
your regression test cases.

.. _unittest: http://www.python.org/doc/current/lib/module-unittest.html
.. _doctest: http://www.python.org/doc/current/lib/module-doctest.html

unittest-based tests
------------------
The unittest_ framework is based on the ideas of unit testing as espoused
by Kent Beck and the `Extreme Programming`_ (XP) movement.  The specific
interface provided by the framework is tightly based on the JUnit_
Java implementation of Beck's original SmallTalk test framework.  Please
see the documentation of the unittest_ module for detailed information on
the interface and general guidelines on writing unittest-based tests.

The test_support helper module provides a function for use by
unittest-based tests in the Python regression testing framework,
``run_unittest()``. This is the primary way of running tests in the
standard library. You can pass it any number of the following:

- classes derived from or instances of ``unittest.TestCase`` or
  ``unittest.TestSuite``. These will be handed off to unittest for
  converting into a proper TestSuite instance.

- a string; this must be a key in sys.modules. The module associated with
  that string will be scanned by ``unittest.TestLoader.loadTestsFromModule``.
  This is usually seen as ``test_support.run_unittest(__name__)`` in a test
  module's ``test_main()`` function. This has the advantage of picking up
  new tests automatically, without you having to add each new test case
  manually.
   
All test methods in the Python regression framework have names that
start with "``test_``" and use lower-case names with words separated with
underscores.

Test methods should *not* have docstrings!  The unittest module prints
the docstring if there is one, but otherwise prints the function name
and the full class name.  When there's a problem with a test, the
latter information makes it easier to find the source for the test
than the docstring.

All unittest-based tests in the Python test suite use boilerplate that
looks like this (with minor variations)::

    import unittest
    from test import test_support

    class MyTestCase1(unittest.TestCase):

        # Define setUp and tearDown only if needed

        def setUp(self):
            unittest.TestCase.setUp(self)
            ... additional initialization...

        def tearDown(self):
            ... additional finalization...
            unittest.TestCase.tearDown(self)

        def test_feature_one(self):
            # Testing feature one
            ...unit test for feature one...

        def test_feature_two(self):
            # Testing feature two
            ...unit test for feature two...

        ...etc...

    class MyTestCase2(unittest.TestCase):
        ...same structure as MyTestCase1...

    ...etc...

    def test_main():
        test_support.run_unittest(__name__)

    if __name__ == "__main__":
        test_main()

This has the advantage that it allows the unittest module to be used
as a script to run individual tests as well as working well with the
regrtest framework.

.. _Extreme Programming: http://www.extremeprogramming.org/
.. _JUnit: http://www.junit.org/

doctest based tests
-------------------
Tests written to use doctest_ are actually part of the docstrings for
the module being tested.  Each test is written as a display of an
interactive session, including the Python prompts, statements that would
be typed by the user, and the output of those statements (including
tracebacks, although only the exception msg needs to be retained then).
The module in the test package is simply a wrapper that causes doctest
to run over the tests in the module.  The test for the difflib module
provides a convenient example::

    import difflib
    from test import test_support
    test_support.run_doctest(difflib)

If the test is successful, nothing is written to stdout (so you should not
create a corresponding output/test_difflib file), but running regrtest
with -v will give a detailed report, the same as if passing -v to doctest.

A second argument can be passed to run_doctest to tell doctest to search
``sys.argv`` for -v instead of using test_support's idea of verbosity.  This
is useful for writing doctest-based tests that aren't simply running a
doctest'ed Lib module, but contain the doctests themselves.  Then at
times you may want to run such a test directly as a doctest, independent
of the regrtest framework.  The tail end of test_descrtut.py is a good
example::

    def test_main(verbose=None):
        from test import test_support, test_descrtut
        test_support.run_doctest(test_descrtut, verbose)

    if __name__ == "__main__":
        test_main(1)

If run via regrtest, ``test_main()`` is called (by regrtest) without
specifying verbose, and then test_support's idea of verbosity is used.  But
when run directly, ``test_main(1)`` is called, and then doctest's idea of
verbosity is used.

See the documentation for the doctest module for information on
writing tests using the doctest framework.

"traditional" Python test modules
---------------------------------
The mechanics of how the "traditional" test system operates are fairly
straightforward.  When a test case is run, the output is compared with the
expected output that is stored in .../Lib/test/output.  If the test runs to
completion and the actual and expected outputs match, the test succeeds, if
not, it fails.  If an ``ImportError`` or ``test_support.TestSkipped`` error
is raised, the test is not run.

Executing Test Cases
====================
If you are writing test cases for module spam, you need to create a file
in .../Lib/test named test_spam.py.  In addition, if the tests are expected
to write to stdout during a successful run, you also need to create an
expected output file in .../Lib/test/output named test_spam ("..."
represents the top-level directory in the Python source tree, the directory
containing the configure script).  If needed, generate the initial version
of the test output file by executing::

    ./python Lib/test/regrtest.py -g test_spam.py

from the top-level directory.

Any time you modify test_spam.py you need to generate a new expected
output file.  Don't forget to desk check the generated output to make sure
it's really what you expected to find!  All in all it's usually better
not to have an expected-out file (note that doctest- and unittest-based
tests do not).

To run a single test after modifying a module, simply run regrtest.py
without the -g flag::

    ./python Lib/test/regrtest.py test_spam.py

While debugging a regression test, you can of course execute it
independently of the regression testing framework and see what it prints::

    ./python Lib/test/test_spam.py

To run the entire test suite:

- [UNIX, + other platforms where "make" works] Make the "test" target at the
  top level::

    make test

- [WINDOWS] Run rt.bat from your PCBuild directory.  Read the comments at
  the top of rt.bat for the use of special -d, -O and -q options processed
  by rt.bat.

- [OTHER] You can simply execute the two runs of regrtest (optimized and
  non-optimized) directly::

    ./python Lib/test/regrtest.py
    ./python -O Lib/test/regrtest.py

But note that this way picks up whatever .pyc and .pyo files happen to be
around.  The makefile and rt.bat ways run the tests twice, the first time
removing all .pyc and .pyo files from the subtree rooted at Lib/.

Test cases generate output based upon values computed by the test code.
When executed, regrtest.py compares the actual output generated by executing
the test case with the expected output and reports success or failure.  It
stands to reason that if the actual and expected outputs are to match, they
must not contain any machine dependencies.  This means your test cases
should not print out absolute machine addresses (e.g. the return value of
the id() builtin function) or floating point numbers with large numbers of
significant digits (unless you understand what you are doing!).


Test Case Writing Tips
======================
Writing good test cases is a skilled task and is too complex to discuss in
detail in this short document.  Many books have been written on the subject.
I'll show my age by suggesting that Glenford Myers' `"The Art of Software
Testing"`_, published in 1979, is still the best introduction to the subject
available.  It is short (177 pages), easy to read, and discusses the major
elements of software testing, though its publication predates the
object-oriented software revolution, so doesn't cover that subject at all.
Unfortunately, it is very expensive (about $100 new).  If you can borrow it
or find it used (around $20), I strongly urge you to pick up a copy.

The most important goal when writing test cases is to break things.  A test
case that doesn't uncover a bug is much less valuable than one that does.
In designing test cases you should pay attention to the following:

    * Your test cases should exercise all the functions and objects defined
      in the module, not just the ones meant to be called by users of your
      module.  This may require you to write test code that uses the module
      in ways you don't expect (explicitly calling internal functions, for
      example - see test_atexit.py).

    * You should consider any boundary values that may tickle exceptional
      conditions (e.g. if you were writing regression tests for division,
      you might well want to generate tests with numerators and denominators
      at the limits of floating point and integer numbers on the machine
      performing the tests as well as a denominator of zero).

    * You should exercise as many paths through the code as possible.  This
      may not always be possible, but is a goal to strive for.  In
      particular, when considering if statements (or their equivalent), you
      want to create test cases that exercise both the true and false
      branches.  For loops, you should create test cases that exercise the
      loop zero, one and multiple times.

    * You should test with obviously invalid input.  If you know that a
      function requires an integer input, try calling it with other types of
      objects to see how it responds.

    * You should test with obviously out-of-range input.  If the domain of a
      function is only defined for positive integers, try calling it with a
      negative integer.

    * If you are going to fix a bug that wasn't uncovered by an existing
      test, try to write a test case that exposes the bug (preferably before
      fixing it).

    * If you need to create a temporary file, you can use the filename in
      ``test_support.TESTFN`` to do so.  It is important to remove the file
      when done; other tests should be able to use the name without cleaning
      up after your test.

.. _"The Art of Software Testing": 
        http://www.amazon.com/exec/obidos/ISBN=0471043281

Regression Test Writing Rules
=============================
Each test case is different.  There is no "standard" form for a Python
regression test case, though there are some general rules (note that
these mostly apply only to the "classic" tests; unittest_- and doctest_-
based tests should follow the conventions natural to those frameworks)::

    * If your test case detects a failure, raise ``TestFailed`` (found in
      ``test.test_support``).

    * Import everything you'll need as early as possible.

    * If you'll be importing objects from a module that is at least
      partially platform-dependent, only import those objects you need for
      the current test case to avoid spurious ``ImportError`` exceptions
      that prevent the test from running to completion.

    * Print all your test case results using the ``print`` statement.  For
      non-fatal errors, print an error message (or omit a successful
      completion print) to indicate the failure, but proceed instead of
      raising ``TestFailed``.

    * Use ``assert`` sparingly, if at all.  It's usually better to just print
      what you got, and rely on regrtest's got-vs-expected comparison to
      catch deviations from what you expect.  ``assert`` statements aren't
      executed at all when regrtest is run in -O mode; and, because they
      cause the test to stop immediately, can lead to a long & tedious
      test-fix, test-fix, test-fix, ... cycle when things are badly broken
      (and note that "badly broken" often includes running the test suite
      for the first time on new platforms or under new implementations of
      the language).

Miscellaneous
=============
There is a test_support module in the test package you can import for
your test case.  Import this module using either::

    import test.test_support

or::

    from test import test_support

test_support provides the following useful objects:

    * ``TestFailed`` - raise this exception when your regression test detects
      a failure.

    * ``TestSkipped`` - raise this if the test could not be run because the
      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]

      ``verify()`` has two advantages over ``assert``:  it works even in -O
      mode, and it raises ``TestFailed`` on failure instead of
      ``AssertionError``.

    * ``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.
      Note that you cannot unlink an open file on all operating systems, so
      also be sure to close temp files before trying to unlink them.

    * ``sortdict(dict)`` - acts like ``repr(dict.items())``, but sorts the
      items first.  This is important when printing a dict value, because
      the order of items produced by ``dict.items()`` is not defined by the
      language.

    * ``findfile(file)`` - you can call this function to locate a file
      somewhere along sys.path or in the Lib/test tree - see
      test_ossaudiodev.py for an example of its use.

    * ``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_error(testcase, statement)`` - make sure that the
      statement is *not* correct Python syntax.


Some Non-Obvious regrtest Features
==================================
    * Automagic test detection:  When you create a new test file
      test_spam.py, you do not need to modify regrtest (or anything else)
      to advertise its existence.  regrtest searches for and runs all
      modules in the test directory with names of the form test_xxx.py.

    * Miranda output:  If, when running test_spam.py, regrtest does not
      find an expected-output file test/output/test_spam, regrtest
      pretends that it did find one, containing the single line

      test_spam

      This allows new tests that don't expect to print anything to stdout
      to not bother creating expected-output files.

    * Two-stage testing:  To run test_spam.py, regrtest imports test_spam
      as a module.  Most tests run to completion as a side-effect of
      getting imported.  After importing test_spam, regrtest also executes
      ``test_spam.test_main()``, if test_spam has a ``test_main`` attribute.
      This is rarely required with the "traditional" Python tests, and
      you shouldn't create a module global with name test_main unless
      you're specifically exploiting this gimmick.  This usage does
      prove useful with unittest-based tests as well, however; defining
      a ``test_main()`` which is run by regrtest and a script-stub in the
      test module ("``if __name__ == '__main__': test_main()``") allows
      the test to be used like any other Python test and also work
      with the unittest.py-as-a-script approach, allowing a developer
      to run specific tests from the command line.