~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to HACKING

  • Committer: Robey Pointer
  • Date: 2006-07-01 19:03:33 UTC
  • mfrom: (1829 +trunk)
  • mto: This revision was merged to the branch mainline in revision 1830.
  • Revision ID: robey@lag.net-20060701190333-f58465aec4bd3412
merge from bzr.dev

Show diffs side-by-side

added added

removed removed

Lines of Context:
282
282
    command changes it name or signature. Ideally only the tests for a
283
283
    given command are affected when a given command is changed.
284
284
 
 
285
Doctests
 
286
--------
 
287
 
 
288
We make selective use of doctests__.  In general they should provide 
 
289
*examples* within the API documentation which can incidentally be tested.  We 
 
290
don't try to test every important case using doctests -- regular Python
 
291
tests are generally a better solution.
 
292
 
 
293
Most of these are in ``bzrlib/doc/api``.  More additions are welcome.
 
294
 
 
295
  __ http://docs.python.org/lib/module-doctest.html
 
296
 
 
297
 
285
298
Running tests
286
299
=============
287
300
Currently, bzr selftest is used to invoke tests.
290
303
 
291
304
  ./bzr selftest -v blackbox
292
305
 
 
306
To skip a particular test (or set of tests), you need to use a negative
 
307
match, like so::
 
308
  ./bzr selftest '^(?!.*blackbox)'  
 
309
 
293
310
 
294
311
Errors and exceptions
295
312
=====================
402
419
so, please reply and say so.)
403
420
 
404
421
 
405
 
:: vim:tw=74:ai
 
422
:: vim: ft=rst tw=74 ai