update unittest library chapter

Author: rambasnet

demos/utility/factorial.py

@@ -6,6 +6,10 @@
 120
 """
 
+import math
+import doctest
+
+
 def factorial(n):
     """ given a positive integer n, returns its factorial 
     >>> factorial(1)
@@ -35,37 +39,38 @@ def factorial(n):
         ...
     OverflowError: n too large
     """
-    import math
     if n < 0:
         raise ValueError("n must be >= 0")
     if math.floor(n) != n:
         raise ValueError("n must be exact integer")
 
     if n+1 == n:  # catch a value like 1e300
         raise OverflowError("n too large")
-    
+
     fact = 1
     n = int(n)
     for i in range(1, n+1):
         fact *= i
     return fact
 
+
 def _test1():
     print('test cases with assert statement called')
     assert factorial(1) == 1, "1! != 1"
     assert factorial(5) == 120, "5! != 120"
     assert factorial(20) == 2432902008176640000
-    
+
     # factorial of -ve integer
     # factorial of non-integer
     print('all test cases passed!')
 
+
 def _test2():
     print("docttest.testmod() called")
-    import doctest
     doctest.testmod()
     print('all test cases passed!')
 
+
 if __name__ == "__main__":
     import sys
     if len(sys.argv) >= 2:

demos/utility/fib.py demos/utility/fibonacci.pydemos/utility/fib.py renamed to demos/utility/fibonacci.py

@@ -5,32 +5,29 @@
 """
 
 import unittest
-from fib import fib
+from utility.fibonacci import fib
 
 
 class FibTest(unittest.TestCase):
     # optional - executes before each test function
     def setUp(self):
-        self.fibSeq = [(1, 1), (2, 1), (3, 2), (10, 55), (20, 6765)]
+        self.fib_seq = [(1, 1), (2, 1), (3, 2), (10, 55), (20, 6765)]
         print('setUp executed...')
 
     # any function that start with test* will be executed automatically
     def test1(self):
-        print('test1')
         # assertEqual is defined in TestCase class
-        for n, val in self.fibSeq:
+        for n, val in self.fib_seq:
             self.assertEqual(fib(n), val)
 
     def test2(self):
-        print('test2')
         # function name can be arbitrary but must start with test or
         # should be runTest
         self.assertEqual(fib(1), 1)
         self.assertEqual(fib(10), 55)
         self.assertEqual(fib(20), 6765)
 
     def test3(self):
-        print('test3')
         # doesn't test fib function but gets called...
         self.assertAlmostEqual(22/7, 3.142857, 6)
         # uncomment the following and run it
@@ -51,8 +48,3 @@ def someTest(self):
     def tearDown(self):
         self.fibElems = None
         print("tearDown executed...")
-
-
-if __name__ == "__main__":
-    # auto-discover unittest in this module and run it...
-    unittest.main()

demos/utility/fib_unittest.py demos/utility/test_fibonacci.pydemos/utility/fib_unittest.py renamed to demos/utility/test_fibonacci.py

@@ -24,7 +24,9 @@
     "### [Ch10-1 - File IO & YAML](./Ch10-1-FileIOYAML.ipynb)\n",
     "### [Ch10-2 - Rich UI Library](./Ch10-2-RichLibrary.ipynb)\n",
     "### [Ch13 - Recursion](./Ch13-Recursion.ipynb)\n",
-    "### [Ch14 - OOP Introduction](./Ch14-OOP.ipynb)\n"
+    "### [Ch14 - OOP Introduction](./Ch14-OOP.ipynb)\n",
+    "### [Ch16 - Exceptions - Error Handling](./Ch16-Exceptions.ipynb)\n",
+    "### [Ch17 - Inheritance & unittest Library](./Ch19-UnittestLibrary.ipynb)\n"
    ]
   },
   {

notebooks/Ch00-IntroCourseTableOfContents.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Unit Test\n",
+    "# Unittest\n",
     "\n",
     "<a href=\"https://colab.research.google.com/github/rambasnet/Python-Fundamentals/blob/master/notebooks/Ch19-UnitTest.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>\n",
     "\n",
@@ -29,8 +29,7 @@
     "    - function entry/exit coverage\n",
     "- full path coverage is usually impractical or impossible\n",
     "    - module with a succession of $n$ decision in it can have up to $2^n$ paths\n",
-    "    - loops can result in an infinite number of paths\n",
-    "- see this repository for more examples of unit testing: https://github.com/rambasnet/KattisDemos"
+    "    - loops can result in an infinite number of paths"
    ]
   },
   {
@@ -61,18 +60,31 @@
    "metadata": {},
    "source": [
     "### doctest demo\n",
-    "- see `factorial.py` in `demos/utility` package for doctest example"
+    "- see `factorial.py` in `demos/utility` package for doctest example\n",
+    "- to run the doctest, run `python -m doctest -v <module.py>` from command line\n",
+    "\n",
+    "```python\n",
+    "python -m doctest -v demos/utility/factorial.py\n",
+    "```"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Unit testing\n",
+    "## Unittest Library Example\n",
     "- python provides unittest standard library to help with unit testing\n",
     "- documentation: https://docs.python.org/dev/library/unittest.html#module-unittest\n",
-    "- see `fib_unittest.py` in `demos/utility` package for unittest example\n",
-    "- run `fib_unittest.py` from command line to run the test suite"
+    "- see `test_fibonacci.py` in `demos/utility` package for unittest example\n",
+    "- `pytest` can also be used to run unittest test cases\n",
+    "- run `pytest -v` from command line to run the test suite"
    ]
   },
   {