def make_rest_doc(self, path=""): content = super(BoolOption, self).make_rest_doc(path) fullpath = get_fullpath(self, path) if self.negation and self.cmdline is not None: if self.cmdline is DEFAULT_OPTION_NAME: cmdline = '--%s' % (fullpath.replace('.', '-'), ) else: cmdline = self.cmdline neg_cmdline = [ "--" + _getnegation(argname.lstrip("-")) for argname in cmdline.split() if argname.startswith("--") ][0] content.add( ListItem(Strong("command-line for negation:"), neg_cmdline)) content.add(ListItem(Strong("option type:"), "boolean option")) if self.default is not None: content.add(ListItem(Strong("default:"), str(self.default))) if self._requires is not None: requirements = [ ListItem(Link(opt, opt + ".html"), "must be set to '%s'" % (rval, )) for (opt, rval) in self._requires ] if requirements: content.add(ListItem(Strong("requirements:"), *requirements)) if self._suggests is not None: suggestions = [ ListItem(Link(opt, opt + ".html"), "should be set to '%s'" % (rval, )) for (opt, rval) in self._suggests ] if suggestions: content.add(ListItem(Strong("suggestions:"), *suggestions)) return content
def make_rest_doc(self, path=""): fullpath = get_fullpath(self, path) content = Rest(Title(fullpath, abovechar="=", belowchar="="), Directive("contents")) if path: content.add(Paragraph(Link("back to parent", path + ".html"))) content.join(Title("Basic Option Information"), ListItem(Strong("name:"), self._name), ListItem(Strong("description:"), self.doc), Title("Sub-Options")) stack = [] prefix = fullpath curr = content config = Config(self) for ending in self.getpaths(include_groups=True): subpath = fullpath + "." + ending while not (subpath.startswith(prefix) and subpath[len(prefix)] == "."): curr, prefix = stack.pop() print subpath, fullpath, ending, curr sub, step = config._cfgimpl_get_home_by_path(ending) doc = getattr(sub._cfgimpl_descr, step).doc if doc: new = curr.add( ListItem(Link(subpath + ":", subpath + ".html"), Em(doc))) else: new = curr.add(ListItem(Link(subpath + ":", subpath + ".html"))) stack.append((curr, prefix)) prefix = subpath curr = new return content
def make_rest_doc(self, path=""): content = super(ChoiceOption, self).make_rest_doc(path) content.add(ListItem(Strong("option type:"), "choice option")) content.add( ListItem(Strong("possible values:"), *[ListItem(str(val)) for val in self.values])) if self.default is not None: content.add(ListItem(Strong("default:"), str(self.default))) requirements = [] for val in self.values: if val not in self._requires: continue req = self._requires[val] requirements.append( ListItem( "value '%s' requires:" % (val, ), *[ ListItem(Link(opt, opt + ".html"), "to be set to '%s'" % (rval, )) for (opt, rval) in req ])) if requirements: content.add(ListItem(Strong("requirements:"), *requirements)) return content
def make_rest_doc(self, path=""): fullpath = get_fullpath(self, path) result = Rest(Title(fullpath, abovechar="=", belowchar="="), ListItem(Strong("name:"), self._name), ListItem(Strong("description:"), self.doc)) if self.cmdline is not None: cmdline = get_cmdline(self.cmdline, fullpath) result.add(ListItem(Strong("command-line:"), cmdline)) return result
def make_rest_doc(self, path=""): content = super(ArbitraryOption, self).make_rest_doc(path) content.add(ListItem(Strong("option type:"), "arbitrary option (mostly internal)")) if self.default is not None: content.add(ListItem(Strong("default:"), str(self.default))) elif self.defaultfactory is not None: content.add(ListItem(Strong("factory for the default value:"), str(self.defaultfactory))) return content
def make_rest_doc(self, path=""): fullpath = get_fullpath(self, path) content = Rest(Title(fullpath, abovechar="=", belowchar="=")) toctree = [] for child in self._children: subpath = fullpath + "." + child._name toctree.append(subpath) content.add(Directive("toctree", *toctree, **{'maxdepth': 4})) content.join(ListItem(Strong("name:"), self._name), ListItem(Strong("description:"), self.doc)) return content
def make_rest_doc(self, path=""): fullpath = get_fullpath(self, path) result = Rest(Title(fullpath, abovechar="=", belowchar="="), Directive("contents"), Paragraph(Link("back to parent", path + ".html")), Title("Basic Option Information"), ListItem(Strong("name:"), self._name), ListItem(Strong("description:"), self.doc)) if self.cmdline is not None: cmdline = get_cmdline(self.cmdline, fullpath) result.add(ListItem(Strong("command-line:"), cmdline)) return result
def make_rest_doc(self, path=""): content = super(StrOption, self).make_rest_doc(path) content.add(ListItem(Strong("option type:"), "string option")) if self.default is not None: content.add(ListItem(Strong("default:"), str(self.default))) return content