text: #!/usr/bin/env python
  """Script to auto-generate our API docs.
  """
  from __future__ import print_function, division
  
  # stdlib imports
  import sys
  import re
  from os.path import join as pjoin
  
  # local imports
  from apigen import ApiDocWriter
  
  # version comparison
  from distutils.version import LooseVersion as V
  
  #*****************************************************************************
  
  def abort(error):
      print('*WARNING* API documentation not generated: %s' % error)
      exit()
  
  
  if __name__ == '__main__':
      package = sys.argv[1]
      outdir = sys.argv[2]
      try:
          other_defines = sys.argv[3]
      except IndexError:
          other_defines = True
      else:
          other_defines = other_defines in ('True', 'true', '1')
  
      # Check that the package is available. If not, the API documentation is not
      # (re)generated and existing API documentation sources will be used.
  
      try:
          __import__(package)
      except ImportError, e:
          abort("Can not import " + package)
  
      module = sys.modules[package]
  
      # Check that the source version is equal to the installed
      # version. If the versions mismatch the API documentation sources
      # are not (re)generated. This avoids automatic generation of documentation
      # for older or newer versions if such versions are installed on the system.
  
      installed_version = V(module.__version__)
  
      info_file = pjoin('..', package, 'info.py')
      info_lines = open(info_file).readlines()
      source_version = '.'.join([v.split('=')[1].strip(" '\n.")
                                 for v in info_lines if re.match(
                                         '^_version_(major|minor|micro|extra)', v
                                         )])
      print('***', source_version)
  
      if source_version != installed_version:
          abort("Installed version does not match source version")
  
      docwriter = ApiDocWriter(package, rst_extension='.rst',
                               other_defines=other_defines)
      docwriter.package_skip_patterns += [r'\.fixes$',
                                          r'\.externals$',
                                          r'\.reconst.eit$',
                                          r'\.tracking\.interfaces.*$',
                                          r'\.tracking\.gui_tools.*$',
                                          r'.*test.*$',
                                          r'\.utils.*$',
                                          r'\.viz.*$',
                                          r'\.boots\.resampling.*$',
                                          r'\.fixes.*$',
                                          r'\.info.*$',
                                          r'\.pkg_info.*$',
                                          ]
      docwriter.write_api_docs(outdir)
      docwriter.write_index(outdir, 'index', relative_to=outdir)
      print('%d files written' % len(docwriter.written_modules))
  