Jared Frazier's questions

我正在使用shdoc为我的 bash 函数生成 markdown 文件；但是，我还想将相关的 bash 函数主体以及该主体中的注释附加到由 生成的 markdown 文件中shdoc。如何打印 bash 函数主体，同时还包括函数主体中的注释？

举一个简单的例子，假设我的所有 bash 文件都包含在一个名为的目录中src，并且所有这些文件都以 结尾.sh。文件中的以下函数src/foo.sh

# @description A function that does something
foo() {
  # oh wow, a comment
  echo "something cool"
}

现在，如果我想获取没有注释的函数主体，我可以轻松地做到这一点，declare -f如下所示，在名为的文件中src/doc.sh：

# assuming you are in the `src` dir and both .sh files are executable
. foo.sh
foo_doc=$(declare -f foo)
echo "$foo_doc"

但问题是foo_doc只有函数体，因为echo "$foo_doc"

foo () 
{ 
    echo "something cool"
}

并且没有任何注释。因此，如果我将此信息附加到由 生成的 markdown 中shdoc，它就不是源代码的理想文档。

我认为一种方法是使用sed来确定与感兴趣的函数相对应的行（我的 bash 函数由 和 “分隔” {，}但根据评论我理解还有其他方法可以声明有效的 bash 函数），然后我可以使用来仅获取这里sed完成的那些行。

我了解如何分别使用 1、2 和 3for循环来定义 1、2 和 3 维的求和，但是如何创建一个对多索引求和的通用函数（如下面定义的函数）？

为简单起见，假设u仅采样一个随机整数，即

from random import randint
def u(a=0, b=100):
    return randint(a, b)

举个例子，假设多索引向量js = [0, 0, 0]和上限向量Ms = [5, 5, 5]，这意味着d = 3（即3维多索引），并且求和可以简单地写成如下

mysum = 0
for j1 in range(Ms[0]):
    for j2 in range(Ms[1]):
        for j3 in range(Ms[2]):
            mysum += u()

但是编写d尺寸的一般方法是什么（如图所示）？

编辑：我知道在这个简单的例子中，人们可以简单地做类似的事情

from numpy import prod
M = prod(Ms)
mysum = sum([u() for i in range(M)]) 

但同样，我对一种执行d嵌套for循环的通用方法特别感兴趣，因为该函数u可能更复杂并且取决于索引 j_1、j_2、...、j_d。