【问题标题】:Which should be used: python-<module> or <module>-python?应该使用哪个:python-<module> 或 <module>-python?
【发布时间】:2014-02-23 20:50:56
【问题描述】:

创建 Python 模块/库时,应使用哪种命名约定?我见过像python-requests 这样的项目,然后是像mysql-python 这样的项目。 python 应该是模块名称的前缀还是后缀?哪种方式更被采用/推荐?

【问题讨论】:

  • 你是指项目名还是发布时的包名?分发包通常遵循自己的命名约定(例如Fedora)。

标签: python naming-conventions python-module


【解决方案1】:

official Python style guide 通常不鼓励使用长名称,如果需要标点符号,您应该使用下划线而不是连字符。就后缀或前缀而言,两者都不是必需的,但都可以接受。在这两者中,使用“Py”作为前缀可能是最常见的。例如,PyQuerypy2appPyX

以下是一些数据,来自PyPi 上可用的 43,000 多个软件包列表:

+-----------------------------------------------+-------+--------+
| Neither starts nor ends with 'Py' or 'Python' | 37943 | 87.40% |
+-----------------------------------------------+-------+--------+
| Starts with 'Py'                              |  3639 | 8.38%  |
+-----------------------------------------------+-------+--------+
| Starts with 'Python'                          |   814 | 1.88%  |
+-----------------------------------------------+-------+--------+
| Ends with 'Py'                                |   796 | 1.83%  |
+-----------------------------------------------+-------+--------+
| Ends with 'Python'                            |   219 | 0.50%  |
+-----------------------------------------------+-------+--------+

【讨论】:

  • 只有 10% 的 Python 包以“Py”开头,所以绝对不是最常见的。
  • “Py”也经常用作后缀 - NumPy、SciPy 等。
  • 我的意思是它作为前缀比后缀更常见。
猜你喜欢
  • 1970-01-01
  • 2018-12-02
  • 2011-11-22
  • 2021-06-18
  • 2022-12-02
  • 2022-12-19
  • 1970-01-01
  • 2022-08-24
  • 1970-01-01
相关资源
最近更新 更多