diff options
author | Hans Ulrich Niedermann <hun@n-dimensional.de> | 2011-01-21 11:09:39 +0100 |
---|---|---|
committer | Hans Ulrich Niedermann <hun@n-dimensional.de> | 2011-01-21 11:09:39 +0100 |
commit | 06fda5ee1e0338330e44bc0d08ca5026e4fb5618 (patch) | |
tree | 640fea8e2113f64f5cef4d7dbfc52c1e0719a937 /src/pyfedpkg | |
parent | 57272679992bdcfebc40d48d49f71233b7d98a50 (diff) | |
parent | a730ad030b7d37b4e50a0cb8072beb1d99cf5158 (diff) | |
download | fedora-packager-06fda5ee1e0338330e44bc0d08ca5026e4fb5618.tar.gz fedora-packager-06fda5ee1e0338330e44bc0d08ca5026e4fb5618.tar.xz fedora-packager-06fda5ee1e0338330e44bc0d08ca5026e4fb5618.zip |
Merge branch '4/man-page' into 4/ALL
Diffstat (limited to 'src/pyfedpkg')
-rw-r--r-- | src/pyfedpkg/man_page.py | 134 |
1 files changed, 134 insertions, 0 deletions
diff --git a/src/pyfedpkg/man_page.py b/src/pyfedpkg/man_page.py new file mode 100644 index 0000000..a9e16f0 --- /dev/null +++ b/src/pyfedpkg/man_page.py @@ -0,0 +1,134 @@ +# Print a man page from the help texts. + + +import argparse +import sys +import datetime + + +# We could substitute the "" in .TH with the fedpkg version if we knew it +man_header = """\ +.\" man page for fedpkg +.TH fedpkg 1 "%(today)s" "" "fedora\-packager" +.SH "NAME" +fedpkg \- Fedora Packaging utility +.SH "SYNOPSIS" +.B "fedpkg" +[ +.I global_options +] +.I "command" +[ +.I command_options +] +[ +.I command_arguments +] +.br +.B "fedpkg" +.B "help" +.br +.B "fedpkg" +.I "command" +.B "\-\-help" +.SH "DESCRIPTION" +.B "fedpkg" +is a script to interact with the Fedora Packaging system. +""" + +man_footer = """\ +.SH "SEE ALSO" +.UR "https://fedorahosted.org/fedora\-packager/" +.BR "https://fedorahosted.org/fedora\-packager/" +""" + +class ManFormatter(object): + + def __init__(self, man): + self.man = man + + def write(self, data): + #print "MF:", repr(data) + for line in data.split('\n'): + #print 'MFL:', line + self.man.write(' %s\n' % line) + + +def strip_usage(s): + """Strip "usage: " string from beginning of string if present""" + if s.startswith('usage: '): + return s.replace('usage: ', '', 1) + else: + return s + + +def man_constants(): + """Global constants for man file templates""" + today = datetime.date.today() + today_manstr = today.strftime('%Y\-%m\-%d') + return {'today': today_manstr} + + +def generate(parser, subparsers): + """\ + Generate the man page on stdout + + Given the argparse based parser and subparsers arguments, generate + the corresponding man page and write it to stdout. + """ + + # Not nice, but works: Redirect any print statement output to + # stderr to avoid clobbering the man page output on stdout. + man_file = sys.stdout + sys.stdout = sys.stderr + + mf = ManFormatter(man_file) + + #print dir(subparsers) + # subparsers.print_help() + + choices = subparsers.choices + k = choices.keys() + k.sort() + + man_file.write(man_header % man_constants()) + + man_file.write('.SH "COMMAND OVERVIEW"\n') + + help_texts = {} + for pa in subparsers._choices_actions: + help_texts[pa.dest] = getattr(pa, 'help', None) + + for command in k: + parser = choices[command] + if not parser.add_help: + continue + usage = parser.format_usage() + usage = strip_usage(usage) + usage = ''.join(usage.split('\n')) + usage = ' '.join(usage.split()) + if help_texts[command]: + man_file.write('.TP\n.B "%s"\n%s\n' % (usage, help_texts[command])) + else: + man_file.write('.TP\n.B "%s"\n' % (usage)) + + man_file.write('.SH "COMMAND REFERENCE"\n') + for command in k: + parser = choices[command] + if not parser.add_help: + continue + + #print + #print "####", command, "####" + man_file.write('.SS "%s"\n' % parser.prog) + + help = help_texts[command] + if help and not parser.description: + if not help.endswith('.'): help = "%s." % help + parser.description = help + #print parser + formatter = parser.formatter_class(parser.prog) + h = parser.format_help() + mf.write(h) + + man_file.write(man_footer) |