Rework Python testing demo and content slides

Author: IshaanDesai

05_testing_and_ci/python_testing_demo.md

@@ -32,12 +32,12 @@ pip install -U pytest
     # expected_result = pytest.approx(78.3, abs=0.01)
 ```
 
-- **Comparing floating point variables** needs to be handled in functions like `find_average` and is done using `pytest.approx(value, abs)`. The `abs` value is the tolerance up to which the floating-point value will be checked, that is `78.33 +/- 0.01`.
+- **Comparing floating point variables** needs to be handled in functions like `find_mean` and is done using `pytest.approx(value, abs)`. The `abs` value is the tolerance up to which the floating-point value will be checked, that is `78.33 +/- 0.01`.
 - Even if one test fails, pytest runs all the tests and gives a report on the failing test. The assertion failure report generated my pytest is also more detailed than the usual Python assertion report. When the test fails, the following is observed:
 
 ```bash
-=============================================== FAILURES ====================================================
-____________________________________________ test_find_mean _________________________________________________
+========================================== FAILURES ===============================================
+_______________________________________ test_find_mean ____________________________________________
 
     def test_find_mean():
         """
@@ -76,17 +76,17 @@ tests/
 
 ## unittest
 
-- Base class `unittest.TestCase` is used to create a test suite consisting of all the tests of a software.
+- Base class `unittest.TestCase` is used to create a test suite.
 - Each test is now a function of a class which is derived from the class `unittest.TestCase`.
 - The same tests as for `pytest` are implemented using `unittest` in the file `test_operations_unittests.py`. The tests are functions of a class named `TestOperations` which tests our mathematical operations. The class `TestOperations` is derived from `unittest.TestCase`.
-- unittest can be run by:
+- unittest can be run as a Python module:
 
 ```bash
 python -m unittest
 ```
 
-- unittest.TestCase offers functions like `assertEqual`, `assertAlmostEqual`, `assertTrue`, etc. for use instead of the usual assertion statements. These statements help the test runner to accumulate all test results and generate a test report.
-- `unittest.main()` provides an option to run the tests from a command-line interface.
+- unittest.TestCase offers functions like `assertEqual`, `assertAlmostEqual`, `assertTrue`, and more ([see unittest.TestCase documentation](https://docs.python.org/3/library/unittest.html#unittest.TestCase)) for use instead of the usual assertion statements. These statements ensure that test runner to accumulate all test results and generate a test report.
+- `unittest.main()` provides an option to run the tests from a command-line interface and also from a file.
 - `setUp` function is executed before all the tests. Similar a clean up function `tearDown` exists.
 - The intention is to group together sets of similar tests in an instant of `unittest.TestCase` and have multiple such instances.
 - Decorators such as `@unittest.skip`, `@unittest.skipIf`, `@unittest.expectedFailure` can be used to gain flexibility over working of tests.
@@ -123,22 +123,25 @@ coverage html
 
 ## tox
 
-- Automation for Python testing (and much more)
-- Virtual environments are created for each task, and tox takes care of installing dependencies and the package itself inside of the environment.
-- Order of preference for files that tox tries to read: `pyproject.toml`, `tox.ini`, `setup.cfg`
-- `tox.ini` file
-
-```ini
-[tox]
-envlist = my_env
-skipsdist = true
-
-[testenv]
-deps = pytest
-commands = pytest
+- Environment orchestrator to setup and execute various tools for a project.
+- `tox` creates virtual environments to run each tools in.
+- Order of preference for files that tox tries to read: `pyproject.toml`, `tox.toml`, `setup.cfg`
+- `tox.toml` file:
+
+```toml
+requires = ["tox>=4"]
+env_list = ["testing"]
+
+[env_run_base]
+description = "run unit tests"
+deps = [
+    "pytest>=8",
+    "pytest-sugar"
+]
+commands = [["pytest", { replace = "posargs", default = ["tests"], extend = true }]]
 ```
 
-- Global settings defined under section `[tox]` in the INI file.
-- Start tox by running the command `tox` in the directory where the `tox.ini` exists.
+- Global settings defined under section at the top of the `tox.toml` file.
+- Start tox by running the command `tox` in the directory where the `tox.toml` exists.
 - tox takes more time the first time it is run as it creates the necessary virtual environments. Virtual environment setup can be found in the `.tox` repository.
 - Observe that tox starts a virtual environment, installs the dependency (here `pytest`) and runs `pytest`.

05_testing_and_ci/python_testing_slides.md

@@ -46,7 +46,7 @@ slideOptions:
 
 - Python framework specifically designed to run, monitor and automate unit tests.
 - Many features like test automation, sharing of setup and shutdown of tests, etc.
-- Using the base class `unittest.TestCase` to create a test suite.
+- Use the base class `unittest.TestCase` to create a test suite.
 - Command-line interface: `python -m unittest test_module1 test_module2 ...`.
 
 ---
@@ -69,19 +69,27 @@ slideOptions:
 
 ## tox
 
-- Automation for Python testing, building and distribution
-- Creates virtual environments for each process
-- Depending on the command, dependencies are installed, tests are run, packaging is done, etc.
-- tox command line tool reads and runs files like `pyproject.toml`, `tox.ini`, and `setup.cfg`
-- More information in the [tox wiki](https://tox.wiki/en/4.0.15/index.html).
+- Environment orchestrator to setup and execute various tools for a project.
+- Creates virtual environments for each process.
+- Processes include testing, linting, building, documentation generation, and more.
+- Configuration via `tox.toml` or `tox.ini` file.
 
 ---
 
 ## tox Demo
 
 ---
 
-## Further reading
+## Other Testing Frameworks
+
+- [nose](https://pypi.org/project/nose2/) is an extension to `unittest` with added plugins.
+- [testify](https://pypi.org/project/testify/) based on unittest and nose with additional features.
+- [robotframework](https://pypi.org/project/robotframework/) is a generic automation framework.
+
+---
+
+## Further Reading
 
 - [pytest documentation](https://docs.pytest.org/en/6.2.x/)
 - [unittest documentation](https://docs.python.org/3/library/unittest.html)
+- [tox user guide](https://tox.wiki/en/4.23.2/user_guide.html#user-guide)