python - 如何按照 PEP8 规则缩写维度？

Question

我必须添加一个创建 3D 纹理的函数。 我在整个模块中使用蜗牛案例。

我的选择是:

def texture_3d(...):
    pass

def texture_3D(...):
    pass

def texture3D(...):
    pass

函数的名称应该是什么？

我不对意见感兴趣:哪个看起来更好。我需要一些对其他模块的引用以了解最佳实践。

请至少提及 1 个具有相似功能的模块。

Answer 1

PEP 8 states函数名称的词 之间用下划线分隔的小写字母。现在，因为如果 3d 似乎很固执己见/3D是一个实际的词，你会在名称之间发生冲突 texture_3d和 texture3d (d 为小写)。

查看一些 numpy 函数，例如 lagval3d , laggrid3d , hermegrid3d 名字texture3d看起来是个不错的选择。

在 the matplotlib docs 中搜索相似的名称产生 <name>3d 之间的混合结果和 <name>_3d .

简而言之，基于两个主要软件包，这两个名称似乎都可以接受。归结为两者之间的个人选择。