1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
|
import distutils # Deprecated in Python 3.10, but no replacement for distutils.log as yet
import os
from pathlib import Path
from setuptools import Command, setup
class BuildDocsCommand(Command):
"""
Custom setuptools command to build man page using pandoc.
Assumes input directory 'doc' and output directory 'man'
"""
description = "Build documentation with pandoc"
user_options = []
def __init__(self, dist, **kw):
super().__init__(dist, **kw)
# Create man dir if it does not already exist
Path("man").mkdir(exist_ok=True)
def initialize_options(self):
self.pandoc_files = []
def finalize_options(self):
options = self.distribution.get_option_dict('options')
self.pandoc_files = [f for f in options['pandoc_files'][1].split('\n') if f]
def run(self):
for in_file in self.pandoc_files:
# Assume a filename like 'application.1.md'
fn, ext = os.path.splitext(in_file)
# Assume input directory doc and output directory man
command = ['pandoc', 'doc/{}'.format(in_file), '-s', '-t', 'man', '-o', 'man/{}'.format(fn)]
self.announce('Running command: %s' % ' '.join(command), level=distutils.log.INFO)
self.spawn(command)
if __name__ == "__main__":
setup(cmdclass={'build_pandoc': BuildDocsCommand})
|
