aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rwxr-xr-xsetup.py58
1 files changed, 57 insertions, 1 deletions
diff --git a/setup.py b/setup.py
index 21249c3..f472e19 100755
--- a/setup.py
+++ b/setup.py
@@ -3,6 +3,8 @@
import sys, os
from distutils.core import setup
from distutils.command.install_scripts import install_scripts
+from distutils.core import Command
+from distutils.util import change_root, newer
# Try to run 2to3 automaticaly when building in Python 3.x
try:
@@ -39,6 +41,59 @@ class md_install_scripts(install_scripts):
_, err, _ = sys.exc_info() # for both 2.x & 3.x compatability
print ('ERROR: Unable to create %s: %s' % (bat_path, err))
+
+class build_docs(Command):
+ """ Build mardkown documentation into html."""
+
+ description = '"build" documentation (convert markdown text to html)'
+
+ user_options = [
+ ('build-base=', 'd', 'directory to "build" to'),
+ ('force', 'f', 'forcibly build everything (ignore file timestamps)'),
+ ]
+
+ boolean_options = ['force']
+
+ def initialize_options(self):
+ self.build_base = None
+ self.force = None
+ self.docs = None
+
+ def finalize_options(self):
+ self.set_undefined_options('build',
+ ('build_base', 'build_base'),
+ ('force', 'force'))
+ self.docs = self._get_docs()
+
+ def _get_docs(self):
+ for root, dirs, files in os.walk('docs'):
+ for file in files:
+ yield os.path.join(root, file)
+
+ def run(self):
+ try:
+ import markdown
+ except ImportError:
+ print ('skipping build_docs: Markdown "import" failed!')
+ else:
+ md = markdown.Markdown()
+ for doc in self.docs:
+ outfile, ext = os.path.splitext(doc)
+ if ext == '.txt':
+ outfile += '.html'
+ outfile = change_root(self.build_base, outfile)
+ self.mkpath(os.path.split(outfile)[0])
+ if self.force or newer(doc, outfile):
+ if self.verbose:
+ print ('Converting %s ---> %s' % (doc, outfile))
+ if not self.dry_run:
+ md.convertFile(doc, outfile)
+ md.reset()
+ else:
+ if self.verbose:
+ print ('Skipping... (%s is newer)' % outfile)
+
+
data = dict(
name = 'Markdown',
version = version,
@@ -53,7 +108,8 @@ data = dict(
packages = ['markdown', 'markdown.extensions'],
scripts = ['bin/%s' % SCRIPT_NAME],
cmdclass = {'install_scripts': md_install_scripts,
- 'build_py': build_py},
+ 'build_py': build_py,
+ 'build_docs': build_docs},
classifiers = ['Development Status :: 5 - Production/Stable',
'License :: OSI Approved :: BSD License',
'Operating System :: OS Independent',