summaryrefslogtreecommitdiff
path: root/pexpect/DEVELOPERS
diff options
context:
space:
mode:
Diffstat (limited to 'pexpect/DEVELOPERS')
-rw-r--r--pexpect/DEVELOPERS46
1 files changed, 46 insertions, 0 deletions
diff --git a/pexpect/DEVELOPERS b/pexpect/DEVELOPERS
new file mode 100644
index 0000000..905fb23
--- /dev/null
+++ b/pexpect/DEVELOPERS
@@ -0,0 +1,46 @@
+
+First off, you need to source the environment file provided in the root of the
+development directory.
+
+ . test.env
+
+This sets the PYTHONPATH to the Pexpect development root directory. This way
+the unit tests and python interpreter will import the development version of
+pexpect instead of any older versions that you may have installed on the
+system. Running all unit tests is as simple as sourcing test.env and then
+running tools/testall.py.
+
+The Pyunit tests are all located in the tests/ directory. To add a new unit
+test all you have to do is create the file in the tests/ directory with a
+filename in this format:
+
+ test_*.py
+
+The testall.py script in the tools/ directory will automatically add all
+test_*.py files to the test suite. To create a new unit test follow the example
+of one of the other test_*.py scripts. Basically, a new unit test will follow
+this template:
+
+<pre>
+#!/usr/bin/env python
+import pexpect
+import unittest
+import PexpectTestCase
+
+# 1. Derive your test case class from PexpectTestCase.PexpectTestCase.
+# 2. At the end of this script add your test case class to the suite using
+# unittest.MakeSuite.
+# 3. All test case methods should be named like test_*.
+class TestCaseFoo (PexpectTestCase.PexpectTestCase):
+ def test_case (self):
+ assert (False), "This is an example template."
+ def test_case_something_else (self):
+ assert (False), "This is an example template."
+
+if __name__ == '__main__':
+ unittest.main()
+
+suite = unittest.makeSuite(TestCaseFoo,'test')
+</pre>
+
+