how to run a doctest in python code example

Example 1: running doctests python

python -m doctest -v filename.py

Example 2: how to write a python doctest

def a_function(*args):
  '''
  >>>an input
  expected output
  '''
  if this:
    return that
# A doctest may also include a docstring