Mikaela/Limnoria
1
0
Fork 0
mirror of https://github.com/Mikaela/Limnoria.git synced 2024-11-25 12:19:24 +01:00
Code Issues Projects Releases Wiki Activity

supybot-plugin-doc: Fix various edge case issues in the ReST output

Browse Source
This commit is contained in:
Valentin Lorentz 2021-04-05 17:33:37 +02:00
parent 113fc74ca1
commit 76b6c56919
1 changed files with 10 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
scripts/supybot-plugin-doc
View File

@ -92,9 +92,12 @@ class PluginDoc(object):
def appendLine(self, line, indent=0):
line = line.strip()
indent = ' ' * indent
lines = textwrap.wrap(line, 79,
initial_indent=indent,
subsequent_indent=indent)
# this looked like a good idea, but it's actually breaking lines
# in the middle of ReST elements:
#lines = textwrap.wrap(line, 79,
# initial_indent=indent,
# subsequent_indent=indent)
lines = [indent + line.replace('\n', '\n' + indent)]
self.lines.extend(lines)
if self.appendExtraBlankLine:
self.lines.append('')
@ -117,7 +120,9 @@ class PluginDoc(object):
if cdoc is not None:
self.appendLine('Usage')
self.appendLine('-----')
self.appendLine(cdoc)
# We add spaces at the beginning in case the docstring does not
# start with a newline (the default, unfortunately)
self.appendLine(textwrap.dedent(" "* 1000 + cdoc).lstrip())
self.lines.append('')
commands = self.inst.listCommands()
if len(commands):
@ -218,9 +223,7 @@ class PluginDoc(object):
name = v._name
indent = origindent + 1
try:
default = str(v)
if not isinstance(v._default, str):
default = utils.str.dqrepr(default)
default = utils.str.dqrepr(str(v))
help = v.help()
except registry.NonExistentRegistryEntry:
pass