# A sample module

"""email enquiries@wellho.net for training in Python

difference(n,m) returns the difference of two numbers
stepper(what,by=1,times=1) returns what increased by by times times."""

copyright = "Well House Consultants"

def difference(one, two):

        '''Returns the difference between two number

        First parameter - the first number
        Second parameter - the second number.'''

        if one < two:
                diff = two - one
        else:
                diff = one - two
        return diff

def stepper(what, by=1, times=1):
        '''Increments a variable by a certain amount 1 or more times

        First parameter - the incoming value to be incremented
        Second parameter - How much to increment it by (optional)
        Third parameter - How many times to increment it (optional).'''

        stepper.counter += 1
        what += by * times
        return what

stepper.counter = 0
if (__name__ == "__main__"):
        print("Not designed to run standalone")
        print("******************************\n")
        print( __doc__)

""" Sample Output

WomanWithCat:y105 grahamellis$ python2 mod2.py
Not designed to run standalone
******************************

email enquiries@wellho.net for training in Python

difference(n,m) returns the difference of two numbers
stepper(what,by=1,times=1) returns what increased by by times times.
WomanWithCat:y105 grahamellis$ python3 mod2.py
Not designed to run standalone
******************************

email enquiries@wellho.net for training in Python

difference(n,m) returns the difference of two numbers
stepper(what,by=1,times=1) returns what increased by by times times.
WomanWithCat:y105 grahamellis$

"""