~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/doc/api/__init__.py

  • Committer: Robert Collins
  • Date: 2005-12-24 02:20:45 UTC
  • mto: (1185.50.57 bzr-jam-integration)
  • mto: This revision was merged to the branch mainline in revision 1550.
  • Revision ID: robertc@robertcollins.net-20051224022045-14efc8dfa0e1a4e9
Start tests for api usage.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
# (C) 2005 Canonical Development Ltd
 
2
 
 
3
# This program is free software; you can redistribute it and/or modify
 
4
# it under the terms of the GNU General Public License as published by
 
5
# the Free Software Foundation; either version 2 of the License, or
 
6
# (at your option) any later version.
 
7
 
 
8
# This program is distributed in the hope that it will be useful,
 
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
 
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
11
# GNU General Public License for more details.
 
12
 
 
13
# You should have received a copy of the GNU General Public License
 
14
# along with this program; if not, write to the Free Software
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
 
17
"""API Documentation for bzrlib.
 
18
 
 
19
This documentation is made up of doctest testable examples.
 
20
 
 
21
Look for bzrlib/doc/api/*.txt to read it.
 
22
 
 
23
This documentation documents the current best practice in using the library.
 
24
For details on specific apis, see pydoc on the api, or read the source.
 
25
"""
 
26
 
 
27
import doctest
 
28
import os
 
29
    
 
30
def test_suite():
 
31
    candidates = os.listdir(os.path.dirname(__file__))
 
32
    scripts = [candidate for candidate in candidates 
 
33
               if candidate.endswith('.txt')]
 
34
    return doctest.DocFileSuite(*scripts)