Question

有没有办法从以下模块main中提取所有文档字符串，包括模块nested的文档字符串，它们位于模块main内，，但不知道是什么模块在模块main 内？

"This is Module main"
module main

"This is fA()"
fA(x) = x

"This is module nested"
module nested

"This is fB()"
fB(x) = x

end

end

我可以获取模块main和模块nested的文档字符串，假设我已经知道模块nested中存在模块main。

? main
This is Module main
? main.nested
This is Module nested

我熟悉names()，这有助于，但在最简单的咒语中却没有那么多：

names(main, all = true)
7-element Array{Symbol,1}:
 Symbol("##meta#252")
 Symbol("#eval")     
 Symbol("#fA")       
 :eval               
 :fA                 
 :main               
 :nested

解释names()的输出并不容易：nested是main内的模块并不明显。

Answer 1

问题并不完全清楚，但这里有一些有用的代码：

# check if a symbol is a nested module
issubmodule(m::Module, s::Symbol) = isa(eval(m,s),Module) && module_name(m) != s

# get a list of all submodules of module m
submodules(m) = filter(x->issubmodule(m,x),names(m,true))

# get a list of all docstring bindings in a module
allbindings(m) = [ [y[2].data[:binding] for y in x[2].docs]
  for x in eval(m,Base.Docs.META)]

# recursively get all docstrings from a module and submodules
function alldocs(m)
    thedocs = map(x->Base.Docs.doc(x[1]),allbindings(m))
    return vcat(thedocs,map(x->alldocs(eval(m,x)),submodules(m))...)
end

现在你有：

julia> alldocs(main)
  This is fA()
  This is Module main
  This is module nested
  This is fB()

希望这有帮助。

Julia：列出模块内的文档字符串

1 个答案: