summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorTzafrir Cohen <tzafrir@cohens.org.il>2018-02-27 19:47:27 +0200
committerTzafrir Cohen <tzafrir@cohens.org.il>2018-02-27 19:47:27 +0200
commitf393b7f9924a028955408b97deb1f812f3390619 (patch)
tree5e853226e45338c5cb1e1503373f35cc80094f0b /README
parent4d16eec8207908d94df26511a8a617c8f7cf7234 (diff)
Generate the "README"-s
Diffstat (limited to 'README')
-rw-r--r--README37
1 files changed, 37 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..ac0ccfa
--- /dev/null
+++ b/README
@@ -0,0 +1,37 @@
+usage: argparse-html.py [-h] [-a ARG_A] [-b PARAM_B] [-v] [-d] [-c]
+ [--html-usage] [--html-usage-raw]
+
+ This script demonstrates how to automatically convert argparse
+ output to HTML. See also the class HTMLFormatter.
+
+ It's a hack. It does not produce a very clean HTML (there's an
+ extra '</ul>, for instance). But it's good enough for me. An empty
+ (or spaces-only) line is considered as a paragraph separator.
+
+ I needed to produce HTML as a single line and thus this is the
+ default output. This is not part of the class and can be easily
+ changed in the wrapper function html_usage().
+
+
+
+optional arguments:
+ -h, --help show this help message and exit
+ -a ARG_A, --arg-a ARG_A
+ Set value of A. Default: 1.1.
+ -b PARAM_B, --param-b PARAM_B
+ Set value of B. Default: 2.
+ -v, --verbose Be verbose
+
+For Interactive Use:
+ -d, --no-act Do nothing. Just print what is to be run
+ -c, --config Do nothing. Just show configuration
+ --html-usage Do nothing. Format help as HTML (a single line)
+ --html-usage-raw If html-usage: don't squash HTML to a single line
+
+ Note that we use RawTextHelpFormatter as the parser, rather than
+ HelpFormatter itself. Otherwise splitting to paragarphs with empty
+ lines won't show up in the standard --help output.
+
+ If you have no problem with that, you can remove the formatter_class
+ parameter above.
+