Prikaz dokumentacije funkcije v Pythonu

V telesu funkcije lahko napišemo niz, ki opisuje bistvo opravljenega dela. Tak niz običajno štejemo za dokumentacijo funkcije. Je zaprt v enojne narekovaje in se nahaja v prvi vrstici telesa funkcije. Da jo preberemo, moramo uporabiti posebno funkcijo help, v parameter katere se poda ime funkcije.

Recimo, da imamo funkcijo, ki sešteje dve števili. O tem je puščena opomba s ustreznimi informacijami:

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

Pokličimo help in izvedimo, kaj je zakomentirano v getSum:

pythonhelp(getSum)

Po izvedbi kode se bo v konzoli pojavil niz z imenom funkcije in njeno dokumentacijo:

pythonHelp on function getSum in module __main__:

getSum(num1, num2)
  this function sums two numbers

S funkcijo help lahko beremo dokumentacijo tudi standardnih funkcij. Izvedimo informacije o funkciji print:

pythonhelp(print)

Če želimo izpisati samo niz z dokumentacijo funkcije, moramo podati v help za imenom funkcije službeno konstrukcijo .__doc__:

pythonhelp(print.__doc__)