tl.testing

tl.testing oferă diverse utilități care pot fi folosite la scris teste de & nbsp;. Este compatibil cu versiunile Python 2.6 și 2.7.
cu nisip de directoare și fișiere
La testarea cod care modifica directoarele și fișierele, este util să fie capabil de a crea și de a inspecta un copac eșantion de directoare și fișiere cu ușurință. Modulul tl.testing.fs oferă suport pentru crearea unui copac de la o descriere textuală, listarea se în același format și curat dupa sine.
Într-un test de doc, aceste facilități pot fi folosite ca aceasta pentru a crea și lista un director, un fișier și o legătură simbolică:
>>> din tl.testing.fs new_sandbox import, ls
>>> New_sandbox ("" ​​"
... D foo
... F foo / bar asdf
... L Baz -> foo / bar
... "" ")
>>> ls ()
l Baz -> foo / bar
d foo
f foo / bar asdf
Vezi fs.txt fișier găsit cu codul sursă pentru mai multe sfaturi, inclusiv cum să înființeze și să dărâme teste folosind nisipuri fișier de sistem.
Instalarea script-uri nevărsate
Unele funcționalități s-ar putea dori să testeze face uz de programe externe, cum ar fi un pager sau un editor de text. Modulul tl.testing.script prevede utilitati care instalează scripturi simple machete în locuri în care codul care urmează să fie testate le va găsi. Ei iau un șir de cod Python și de a crea un script înveliș care stabilește calea Python pentru a se potrivi cel al testului și rulează codul.
Acesta este modul în care un astfel de scenariu fals ar putea fi utilizate într-un test doc:
>>> Din import tl.testing.script instalare
>>> Script_path = instala ("print" Un script simplu. "")
>>> Print deschis (script_path) se citi ()
#! ...

SYS import
sys.path [:] = [...]

print "Un script simplu."
>>> Subproces import
>>> Sub = subprocess.Popen (script_path, coajă = Adevărat, stdout = subprocess.PIPE)
>>> Stdout, stderr = sub.communicate ()
>>> Stdout imprimare
Un script simplu.
Vezi script.txt fișier găsit cu codul sursă pentru mai multe posibilități de cum se instalează și de acces script-uri false, precum și modul de a dărâma teste folosind scripturi false.
continutul grafica a suprafetelor Cairo de testare Doc
Deși este simplu de configurat pentru a compara conținutul a două suprafețe Cairo, în cod Python, manipulare grafică este dincolo de teste doc. Cu toate acestea, pachetul Manuel pot fi folosite pentru a extrage cazuri de testare mai generale dintr-un document text permițând în același timp pentru a le amesteca cu teste doc într-un mod natural.
Modulul tl.testing.cairo oferă o fabrică de suita de teste care utilizează Manuel a executa teste grafice formulate ca cifrele restructurate-text. Legenda unei astfel de cifră ar trebui să fie o expresie Python literal a cărui valoare este o suprafață Cairo, iar imaginea sa este folosit ca așteptările încercare.
Acesta este modul în care o suprafață poate fi comparat cu o imagine de așteptat, într-o încercare doc:
>>> Cairo import
>>> Din pkg_resources resource_filename import
>>> Imagine = resource_filename ('tl.testing "," testimages / correct.png ")
.. Figura :: tl / testarea / testimages / correct.png
& Nbsp; `` cairo.ImageSurface.create_from_png (imagine) ``
Vezi cairo.txt fișier găsit cu codul sursă pentru sfaturi și documentare a posibil ieșire încercări suplimentare.
Lucrul cu fire din codul de încercare
Standard Clasa testcase nu colectează erori și eșecuri care au avut loc în alte fire decât cea principală. Modulul tl.testing.thread oferă cursuri de fire și o clasă ThreadAwareTestCase pentru a permite doar că, la fel de bine ca și alte facilități pentru teste care se ocupă cu fire: prevenirea excepții netratate de tip anticipate din fire de a fi imprimate cu ieșire de test, fire de raportare lăsat în urmă printr-un test, care rulează cod într-un fir demon, care unește fire și numărarea firele au început în timpul rula testul de:
>>> Timp import
>>> Tl.testing.thread import
>>> Clasă SampleTest (tl.testing.thread.ThreadAwareTestCase):
...
... Test_error_in_thread_should_be_reported def (auto):
... Cu tl.testing.thread.ThreadJoiner (1):
... Self.run_in_thread (lambda: 1/0)
...
... Definiție test_active_count_should_count_only_new_threads (auto):
... Cu tl.testing.thread.ThreadJoiner (1):
... Self.run_in_thread (lambda: time.sleep (0,1))
... Self.assertEqual (1, self.active_count ())
... Self.assertEqual (0, self.active_count ())
>>> Unittest import
>>> Run (unittest.makeSuite (SampleTest))
================================================== ====================
EROARE: test_error_in_thread_should_be_reported (__builtin __ SampleTest.)
-------------------------------------------------- --------------------
Traceback (cel mai recent apel ultima):
& Nbsp; ...
ZeroDivisionError: diviziune întreg sau modulo la zero
-------------------------------------------------- --------------------
Ran 2 teste în N.NNNs
FAILED (erori = 1)
Consultați fișierul thread.txt găsit cu codul sursă pentru mai multe detalii din clasa ThreadAwareTestCase.
Construirea apartamente de testare care folosesc Manuel
Manuel oferă câteva caracteristici puternice în plus față de standard de doctests, apartamente de testare manuel sunt înființate ușor diferit de cele standard. Tl.testing.doctest Modulul pune în aplicare o fabrică DocFileSuite care poate fi folosit ca cea standard, dar creează o suită de testare folosind Manuel și permite unele de configurare suplimentare referitoare la manuel, printre care capacitatea de a interpreta notele de subsol care utilizate să fie făcut cu ajutorul dezaprobată zope.testing.doctest:
>>> Sample_txt = scriere ('sample.txt "," ""
... [#footnote] _
... >>> X
... 1
...
... .. [#footnote]
... >>> X = 1
... "" ")
>>> Din tl.testing.doctest DocFileSuite import
>>> Run (DocFileSuite (sample_txt, notele de subsol = true))
-------------------------------------------------- --------------------
Ran 1 încercare în N.NNNs
OK
>>> Sample_txt = scriere ('sample.txt "," ""
... .. Cod-bloc :: piton
... X = 1
...
... >>> X
... 1
... "" ")
>>> Manuel.codeblock import
>>> Run (DocFileSuite (sample_txt, Manuel = manuel.codeblock.Manuel ()))
-------------------------------------------------- --------------------
Ran 1 încercare în N.NNNs
OK

Cerințe :

• Python