Re: [Docutils-users] ReST from inside a program?

[David G. <go...@py...>]

On Thu, Apr 4, 2013 at 1:43 PM, Skip Montanaro <sk...@po...> wrote:
> I converted all my usage text to ReST and generate man pages from it using a
> make action like this:
>
> $(MANDIR)/%.1 : $(SRCDIR)/%.sh
> rm -f $@
> bash $< -h 2>&1 | rst2man \
> | sed -e '/^\.de1 rstReportMargin/,/^\.\./d' \
>      -e '/^\.de1 INDENT/,/^\.\./d' \
>      -e '/^\.de UNINDENT/,/^\.\./d' \
> | egrep -v '^\.(UN)?INDENT' > $@
> chmod 0444 $@
>
> $(MANDIR)/%.1 : $(SRCDIR)/%.py
> rm -f $@
> python $< -h 2>&1 | rst2man \
> | sed -e '/^\.de1 rstReportMargin/,/^\.\./d' \
>      -e '/^\.de1 INDENT/,/^\.\./d' \
>      -e '/^\.de UNINDENT/,/^\.\./d' \
> | egrep -v '^\.(UN)?INDENT' > $@
> chmod 0444 $@
>
> This works okay, but little workarounds I need for clean rst2man output will
> now turn up when I run the program with the -h flag.  I would prefer it if
> my usage() functions ran rst2man or equivalent (is there an rst2text
> program?).  I took a look at the API documentation, but didn't see anything
> simple.  Most stuff seemed to be geared toward people publishing to new
> formats.  Is there a simple API that takes a string in ReST format as input,
> the name of a publisher ("man", "html", "text", etc) and returns a
> "published" string?

Perhaps docutils.core.publish_string? Documented here:
http://docutils.sourceforge.net/docs/api/publisher.html (under
"Convenience Functions").

--
David Goodger <http://python.net/~goodger>