Още тестване и документация

Примерно пакетче с модули

Нека разгледаме модула world

клас наследник на unittest.TestCase
всеки негов метод започващ с test е отделен сценарий
unittest.main се грижи да намери подходящите класове и да извика подходящите им методи
просто!

понякога се налага да правим едно и също преди и след някой сценарий (метод на TestCase)
методът setUp на TestCase ще се извика преди всеки сценарий
методът tearDownще се извика след всеки сценарий

def setUp(self):
    self.w = world.World()
def tearDown(self):
    self.w = None

world.destroyer.do отпечатва разни неща, които не искаме да виждаме по време на тестовете
можем да си направим наследник на unittest.TestCase, който има желаната функционалност
и ползваме негов наследник в случаите, в които ни трябва тази функционалност
Пример: world.test.testcases

http://docs.python.org/ — обновена, удобна, ако знаете къде да търсите, това което ви трябва
- Library Reference—систематизирано описание на функции, модули
- Global Module Index—азбучен списък с подробни описания на модулите
- Language Reference—синтактични правила, твърдения, оператори
често най-бързия начин да намерите, каквото ви е нужно е търсене в Google за python <функция/метод/клас/…>
- Пример: python unittest

Под Windows—Python Manuals в chm формат. Може да се търси, на практика в него е цялата HTML документация.
HTML документация—почти същата като на сайта (малко по-стара вероятно) и й лиспва търсене. Ще я намерите на собствения си компютър някъде, освен ако за вашата ОС не се разпространява отделно от самия Python.

Под Windows: python.exe pydoc.py Трябва да сложите в пътя директориите PythonX.Y и PythonX.Y/Lib.
На другите места: pydoc
pydoc <име>—търси документация за тази функция, тема, модул ключова дума…
pydoc -k <ключова дума>—търси тази дума в описанията на всички модули
pydoc -p <порт>—пуска HTTP сървър на вашия компютър и можете да разглеждате HTML документацията като отворите с браузъра си http://localhost:<порт>/
pydoc -g—отваря графична програма, в която може да търсите по ключова дума

def f(x, y):
      """f makes you happy putting a x into your y."""

Стига вашия модул да се намира някъде в пътя за търсене на Pythоn
- можете да погледнете в sys.path
- PYTHONPATH
- модулът site
при разглеждане с pydoc ще се вижда и документацията на вашите модули
pydoc -w —записва документация на диска в HTML формат