diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/setup_command.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/setup_command.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,89 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.setup_command - ~~~~~~~~~~~~~~~~~~~~ - - Setuptools/distutils commands to assist the building of sphinx - documentation. - - :author: Sebastian Wiesner - :contact: basti.wiesner@gmx.net - :copyright: 2008 by Sebastian Wiesner. - :license: MIT. -""" - -import sys -import os -from StringIO import StringIO -from distutils.cmd import Command - -from sphinx.application import Sphinx -from sphinx.util.console import darkred, nocolor - - -class BuildDoc(Command): - """Distutils command to build Sphinx documentation.""" - - description = 'Build Sphinx documentation' - user_options = [ - ('fresh-env', 'E', 'discard saved environment'), - ('all-files', 'a', 'build all files'), - ('source-dir=', 's', 'Source directory'), - ('build-dir=', None, 'Build directory'), - ('builder=', 'b', 'The builder to use. Defaults to "html"'), - ] - boolean_options = ['fresh-env', 'all-files'] - - - def initialize_options(self): - self.fresh_env = self.all_files = False - self.source_dir = self.build_dir = None - self.conf_file_name = 'conf.py' - self.builder = 'html' - - def finalize_options(self): - if self.source_dir is None: - if os.path.isdir('doc'): - for root, dirnames, filenames in os.walk('doc'): - if 'conf.py' in filenames: - self.source_dir = root - self.announce('Using source directory %s' % root) - break - self.ensure_dirname('source_dir') - self.source_dir = os.path.abspath(self.source_dir) - - if self.build_dir is None: - build = self.get_finalized_command('build') - self.build_dir = os.path.join(build.build_base, 'sphinx') - self.mkpath(self.build_dir) - self.ensure_dirname('build_dir') - self.doctree_dir = os.path.join(self.build_dir, 'doctrees') - self.mkpath(self.doctree_dir) - self.builder_target_dir = os.path.join(self.build_dir, self.builder) - self.mkpath(self.builder_target_dir) - - def run(self): - if not sys.stdout.isatty() or sys.platform == 'win32': - # Windows' poor cmd box doesn't understand ANSI sequences - nocolor() - if not self.verbose: - status_stream = StringIO() - else: - status_stream = sys.stdout - app = Sphinx(self.source_dir, self.source_dir, - self.builder_target_dir, self.doctree_dir, - self.builder, {}, status_stream, - freshenv=self.fresh_env) - - try: - if self.all_files: - app.builder.build_all() - else: - app.builder.build_update() - except Exception, err: - from docutils.utils import SystemMessage - if isinstance(err, SystemMessage): - sys.stderr, darkred('reST markup error:') - print >>sys.stderr, err.args[0].encode('ascii', 'backslashreplace') - else: - raise