docutils/setup.py

   1 #!/usr/bin/env python
   2 # $Id$
   3 # Copyright: This file has been placed in the public domain.
   4
   5 import sys
   6 import os
   7 import glob
   8 try:
   9     from distutils.core import setup, Command
  10     from distutils.command.build import build
  11     from distutils.command.build_py import build_py
  12     if sys.version_info >= (3,):
  13         from distutils.command.build_py import build_py_2to3
  14         from distutils.util import copydir_run_2to3
  15     from distutils.command.install_data import install_data
  16     from distutils.util import convert_path
  17     from distutils import log
  18 except ImportError:
  19     print ('Error: The "distutils" standard module, which is required for the ')
  20     print ('installation of Docutils, could not be found.  You may need to ')
  21     print ('install a package called "python-devel" (or similar) on your ')
  22     print ('system using your package manager.')
  23     sys.exit(1)
  24
  25
  26 if sys.version_info >= (3,):
  27     # copy-convert auxiliary python sources
  28     class copy_build_py_2to3(build_py_2to3):
  29         """Copy/convert Python source files in given directories recursively.
  30
  31         Build py3k versions of the modules and packages.
  32         Also copy 'test/' suite and run 2to3 on *.py files.
  33         """
  34         manifest_in = """\
  35         exclude *.pyc *~ .DS_Store
  36         recursive-exclude * *.pyc *~ .DS_Store
  37         recursive-exclude functional/output *
  38         include functional/output/README.txt
  39         prune .svn
  40         prune */.svn
  41         prune */*/.svn
  42         prune */*/*/.svn
  43         prune */*/*/*/.svn
  44         prune */*/*/*/*/.svn
  45         """
  46         def run(self):
  47             # fix
  48             print("build_py_2to3")
  49             build_py_2to3.run(self)
  50             print("copy/convert test suite")
  51             loglevel = log.set_threshold(log.ERROR)
  52             copydir_run_2to3('test', 'test3', template=self.manifest_in)
  53             log.set_threshold(loglevel)
  54
  55
  56 class smart_install_data(install_data):
  57     # From <http://wiki.python.org/moin/DistutilsInstallDataScattered>,
  58     # by Pete Shinners.
  59
  60     def run(self):
  61         #need to change self.install_dir to the library dir
  62         install_cmd = self.get_finalized_command('install')
  63         self.install_dir = getattr(install_cmd, 'install_lib')
  64         return install_data.run(self)
  65
  66 class build_data(Command):
  67
  68     def initialize_options(self):
  69         pass
  70
  71     def finalize_options(self):
  72         pass
  73
  74     def run(self):
  75         build_py = self.get_finalized_command('build_py')
  76         data_files = self.distribution.data_files
  77         for f in data_files:
  78             dir = convert_path(f[0])
  79             dir = os.path.join(build_py.build_lib, dir)
  80             self.mkpath(dir)
  81             for data in f[1]:
  82                 data = convert_path(data)
  83                 self.copy_file(data, dir)
  84
  85 # let our build_data run
  86 build.sub_commands.append(('build_data', lambda *a: True))
  87
  88
  89 def do_setup():
  90     kwargs = package_data.copy()
  91     kwargs['classifiers'] = classifiers
  92     # Install data files properly.
  93     kwargs['cmdclass'] = {'build_data': build_data,
  94                           'install_data': smart_install_data}
  95     # Auto-convert source code for Python 3
  96     if sys.version_info >= (3,):
  97         kwargs['cmdclass']['build_py'] = copy_build_py_2to3
  98     else:
  99         kwargs['cmdclass']['build_py'] = build_py
 100     dist = setup(**kwargs)
 101     return dist
 102
 103 s5_theme_files = []
 104 for dir in glob.glob('docutils/writers/s5_html/themes/*'):
 105     if os.path.isdir(dir):
 106         theme_files = glob.glob('%s/*' % dir)
 107         s5_theme_files.append((dir, theme_files))
 108
 109 package_data = {
 110     'name': 'docutils',
 111     'description': 'Docutils -- Python Documentation Utilities',
 112     'long_description': """\
 113 Docutils is a modular system for processing documentation
 114 into useful formats, such as HTML, XML, and LaTeX.  For
 115 input Docutils supports reStructuredText, an easy-to-read,
 116 what-you-see-is-what-you-get plaintext markup syntax.""", # wrap at col 60
 117     'url': 'http://docutils.sourceforge.net/',
 118     'version': '0.15b.dev',
 119     'author': 'David Goodger',
 120     'author_email': 'goodger@python.org',
 121     'maintainer': 'docutils-develop list',
 122     'maintainer_email': 'docutils-develop@lists.sourceforge.net',
 123     'license': 'public domain, Python, 2-Clause BSD, GPL 3 (see COPYING.txt)',
 124     'platforms': 'OS-independent',
 125     'package_dir': {'docutils': 'docutils',
 126                     'docutils.tools': 'tools'},
 127     'packages': ['docutils',
 128                  'docutils.languages',
 129                  'docutils.parsers',
 130                  'docutils.parsers.rst',
 131                  'docutils.parsers.rst.directives',
 132                  'docutils.parsers.rst.languages',
 133                  'docutils.readers',
 134                  # 'docutils.readers.python', # in the sandbox since 0.8
 135                  'docutils.transforms',
 136                  'docutils.utils',
 137                  'docutils.utils.math',
 138                  'docutils.writers',
 139                  'docutils.writers.html4css1',
 140                  'docutils.writers.html5_polyglot',
 141                  'docutils.writers.pep_html',
 142                  'docutils.writers.s5_html',
 143                  'docutils.writers.latex2e',
 144                  'docutils.writers.xetex',
 145                  'docutils.writers.odf_odt',
 146                  ],
 147     'data_files': ([('docutils/parsers/rst/include',
 148                      glob.glob('docutils/parsers/rst/include/*.txt')),
 149                     ('docutils/writers/html5_polyglot',
 150                      ['docutils/writers/html5_polyglot/minimal.css',
 151                       'docutils/writers/html5_polyglot/plain.css',
 152                       'docutils/writers/html5_polyglot/math.css',
 153                       'docutils/writers/html5_polyglot/template.txt']),
 154                     ('docutils/writers/html4css1',
 155                      ['docutils/writers/html4css1/html4css1.css',
 156                       'docutils/writers/html4css1/template.txt']),
 157                     ('docutils/writers/latex2e',
 158                      ['docutils/writers/latex2e/default.tex',
 159                       'docutils/writers/latex2e/titlepage.tex',
 160                       'docutils/writers/latex2e/xelatex.tex',]),
 161                     ('docutils/writers/pep_html',
 162                      ['docutils/writers/pep_html/pep.css',
 163                       'docutils/writers/pep_html/template.txt']),
 164                     ('docutils/writers/s5_html/themes',
 165                      ['docutils/writers/s5_html/themes/README.txt']),
 166                     ('docutils/writers/odf_odt',
 167                      ['docutils/writers/odf_odt/styles.odt']),
 168                    ]
 169                    + s5_theme_files),
 170     'scripts' : ['tools/rst2html.py',
 171                  'tools/rst2html4.py',
 172                  'tools/rst2html5.py',
 173                  'tools/rst2s5.py',
 174                  'tools/rst2latex.py',
 175                  'tools/rst2xetex.py',
 176                  'tools/rst2man.py',
 177                  'tools/rst2xml.py',
 178                  'tools/rst2pseudoxml.py',
 179                  'tools/rstpep2html.py',
 180                  'tools/rst2odt.py',
 181                  'tools/rst2odt_prepstyles.py',
 182                  ],}
 183 """Distutils setup parameters."""
 184
 185 classifiers = [
 186     'Development Status :: 4 - Beta',
 187     'Environment :: Console',
 188     'Intended Audience :: End Users/Desktop',
 189     'Intended Audience :: Other Audience',
 190     'Intended Audience :: Developers',
 191     'Intended Audience :: System Administrators',
 192     'License :: Public Domain',
 193     'License :: OSI Approved :: Python Software Foundation License',
 194     'License :: OSI Approved :: BSD License',
 195     'License :: OSI Approved :: GNU General Public License (GPL)',
 196     'Operating System :: OS Independent',
 197     'Programming Language :: Python :: 2.6',
 198     'Programming Language :: Python :: 2.7',
 199     'Programming Language :: Python :: 3',
 200     'Topic :: Documentation',
 201     'Topic :: Software Development :: Documentation',
 202     'Topic :: Text Processing',
 203     'Natural Language :: English',      # main/default language, keep first
 204     'Natural Language :: Afrikaans',
 205     'Natural Language :: Catalan',
 206     'Natural Language :: Chinese (Simplified)',
 207     'Natural Language :: Chinese (Traditional)',
 208     'Natural Language :: Czech',
 209     'Natural Language :: Dutch',
 210     'Natural Language :: Esperanto',
 211     'Natural Language :: Finnish',
 212     'Natural Language :: French',
 213     'Natural Language :: Galician',
 214     'Natural Language :: German',
 215     'Natural Language :: Italian',
 216     'Natural Language :: Japanese',
 217     'Natural Language :: Polish',
 218     'Natural Language :: Portuguese (Brazilian)',
 219     'Natural Language :: Russian',
 220     'Natural Language :: Slovak',
 221     'Natural Language :: Spanish',
 222     'Natural Language :: Swedish',
 223     ]
 224 # BUG pypi did not like following languages
 225 #   'Natural Language :: Lithuanian',
 226 """Trove classifiers for the Distutils "register" command."""
 227
 228 if __name__ == '__main__' :
 229     do_setup()