数据科学项目的 Python 文件命名约定

Question

数据科学和机器学习项目中文件的正确命名约定是什么？

我认为 Python 类的文件名应该是一个名词。但是，我想明确的是，将类命名为主语名词还是宾语名词。

我应该使用哪一个？

1) 输出绘图的类。

visualization.py、visualizer.py、vis.py 或 ...

2) 分析数据集并输出包含结果的文件的类。

analysis.py、analyzer.py 或 ...

3) 将数据集转换为pickle 文件的类。

preprocessor.py、preprocessing.py、prepare.py 或 ...

（我检查了PEP8，但找不到文件名的明确命名转换）

Answer 1

在PEP-8 命名约定部分，您会找到正确的方法。

pep-8 中也讨论了命名约定不明确。

所以如果你想要一个正确的方法（另一个组织遵循）然后去 GitHub（例如tensorflow）看看他们如何维护维护项目的命名约定。

你可以按照那里的结构开始做这个项目。

没有什么是固定的。这完全取决于您要如何构建它。更好的是它应该易于阅读和维护。