doc/book/en/B130-tests.en.txt
changeset 198 5e5ba709d022
parent 127 ae611743f5c6
equal deleted inserted replaced
197:1632e01a58a9 198:5e5ba709d022
     1 .. -*- coding: utf-8 -*-
     1 .. -*- coding: utf-8 -*-
     2 
     2 
     3 Tests
     3 Tests
     4 =====
     4 =====
     5 
     5 
     6 Écriture de tests unitaires
     6 Unit tests
     7 ---------------------------
     7 ----------
     8 Le framework de test fournit principalement deux classes de tests dans le module
       
     9 `ginco.devtools.apptest`:
       
    10 
     8 
    11 * `EnvBasedTC`, pour simuler un environnement complet (web + repository)
     9 `CubicWeb` framework provides essentially two Python test classes in the
    12 * `RepositoryBasedTC`, pour simuler un environnement de repository uniquement
    10 module `cubicweb.devtools.apptest`:
    13 
    11 
    14 Ces deux classes ont quasiment la même interface et proposent un certain nombre de méthodes
    12 * `EnvBasedTC`, to simulate a complete environment (web + repository)
    15 rendant l'écriture de test puissante et rapide.
    13 * `RepositoryBasedTC`, to simulate a repository environment only
    16 
    14 
    17 XXXFILLME describe API
    15 Thos two classes almost have the same interface and offers numerous methods to
       
    16 write tests rapidely and efficiently.
    18 
    17 
    19 Dans la plupart des cas, vous allez vouloir hériter de `EnvBasedTC` pour écrire des tests
    18 XXX FILLME describe API
    20 unitaires ou fonctionnels pour vos entités, vues, crochets...
       
    21 
    19 
       
    20 In most of the cases, you will inherit `EnvBasedTC` to write Unittest or
       
    21 functional tests for your entities, views, hooks, etc...
    22 
    22 
    23 Test des courriels de notifications
    23 Email notifications tests
    24 ```````````````````````````````````
    24 -------------------------
    25 Lors de l'éxécution de tests les courriels potentiellement générés ne sont pas réellement
    25 When running tests potentially generated e-mails are not really
    26 envoyé mais se retrouve dans la liste `MAILBOX` du module `ginco.devtools.apptest`. Cette
    26 sent but is found in the list `MAILBOX` of module `cubicweb.devtools.apptest`. 
    27 liste est remise à zéro au *setUp* de chaque test (par le setUp des classes `EnvBasedTC`
    27 This list is reset at each test *setUp* (by the setUp of classes `EnvBasedTC`
    28 et `RepositoryBasedTC`).
    28 and `RepositoryBasedTC`).
    29 
    29 
    30 Vous pouvez donc tester vos notifications en analysant le contenu de cette liste, qui
    30 	
    31 contient des objets ayant deux attributs :
    31 You can test your notifications by analyzing the contents of this list, which
    32 * `recipients`, la liste des destinataires
    32 contains objects with two attributes:
    33 * `msg`, l'objet email.Message
    33 * `recipients`, the list of recipients
       
    34 * `msg`, object email.Message
    34 
    35 
    35 
    36 Automatic testing
    36 Tests automatiques
    37 -----------------
    37 ------------------
       
    38 XXXFILLME
    38 XXXFILLME