← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/testing.txt

  • Committer: Vincent Ladeuil
  • Date: 2010-07-07 11:21:19 UTC
  • mto: (5193.7.1 unify-confs)
  • mto: This revision was merged to the branch mainline in revision 5349.
  • Revision ID: v.ladeuil+lp@free.fr-20100707112119-jwyh312df41w6l0o
Revert previous change as I can't reproduce the related problem anymore.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/testing.txt
293
293
 
294
294
We make selective use of doctests__.  In general they should provide
295
295
*examples* within the API documentation which can incidentally be tested.  We
296
 
don't try to test every important case using doctests -- regular Python
 
296
don't try to test every important case using doctests |--| regular Python
297
297
tests are generally a better solution.  That is, we just use doctests to
298
298
make our documentation testable, rather than as a way to make tests.
299
299
 
511
511
just success or failure.
512
512
 
513
513
If a test can't be run, it can say that it's skipped by raising a special
514
 
exception.  This is typically used in parameterized tests -- for example
 
514
exception.  This is typically used in parameterized tests |--| for example
515
515
if a transport doesn't support setting permissions, we'll skip the tests
516
516
that relating to that.  ::
517
517
 
689
689
 
690
690
In some cases blackbox tests will also want to check error reporting.  But
691
691
it can be difficult to provoke every error through the commandline
692
 
interface, so those tests are only done as needed -- eg in response to a
 
692
interface, so those tests are only done as needed |--| eg in response to a
693
693
particular bug or if the error is reported in an unusual way(?)  Blackbox
694
694
tests should mostly be testing how the command-line interface works, so
695
695
should only test errors if there is something particular to the cli in how
869
869
 
870
870
Please see bzrlib.treebuilder for more details.
871
871
 
 
872
 
 
873
.. |--| unicode:: U+2014
 
874
 
872
875
..
873
876
   vim: ft=rst tw=74 ai et sw=4