Wyświetlanie dokumentacji funkcji w Pythonie

W ciele funkcji można wpisać ciąg znaków, opisujący istotę wykonywanej pracy. Taki ciąg znaków jest uważany za dokumentację funkcji. Jest ujęty w pojedyncze cudzysłowy i umieszczony w pierwszej linii ciała funkcji. Aby go przeczytać, należy użyć specjalnej funkcji help, do parametru której przekazywana jest nazwa funkcji.

Załóżmy, że mamy funkcję sumującą dwie liczby. Zostawiono o tym ciąg znaków z odpowiednią informacją:

def getSum(num1, num2):
	'this function sums two numbers'
	return num1 + num2

Wywołajmy help i dowiedzmy się, co zakomentowano w getSum:

help(getSum)

Po wykonaniu kodu w konsoli pojawi się ciąg znaków z nazwą funkcji i jej dokumentacją:

Help on function getSum in module __main__:

getSum(num1, num2)
	this function sums two numbers

Za pomocą funkcji help można czytać dokumentację także standardowych funkcji. Dowiedzmy się informacji o funkcji print:

help(print)

Aby wyświetlić tylko ciąg znaków z dokumentacją funkcji, należy przekazać do help po nazwie funkcji konstrukcję serwisową .__doc__:

help(print.__doc__)

Utwórz funkcję, która będzie przyjmować parametrem listę nazw miesięcy i wyświetlać je z dużej litery. Opisz istotę działania funkcji w dokumentacji i wyświetl ją w konsoli.

Wyświetl całą dokumentację o funkcji sum.

Wyświetl tylko ciąg znaków z dokumentacją o funkcji len.