【问题标题】:PEP8 and PyQt, how to reconcile function capitalization?PEP8 和 PyQt,如何协调函数大小写?
【发布时间】:2011-04-08 12:45:50
【问题描述】:

我开始在一些项目中使用 PyQt,但我遇到了文体困境。 PyQt 的函数使用驼峰式大小写,但我更喜欢遵循的 PEP8 说函数名称使用下划线和全部小写。

因此,一方面,我可以继续遵循 PEP8,这意味着我的代码将对驼峰式大小写和下划线函数进行混合函数调用,甚至我的类也会有混合函数名,因为我需要重载mousePressEvent 之类的函数。或者,我可以打破 PEP8 并以一致性的名义对我所有的函数名采用驼峰式大小写。

我意识到这是主观的,这正是我个人更喜欢的,但我喜欢听听其他人关于他们的工作以及他们为什么选择这样做的原因。

【问题讨论】:

  • 我刚刚开始使用 PyQt。函数是唯一的问题,还是 PyQt 变量也经常被访问?我正在考虑在我的 PyQt UI 代码中将 camelCase 用于函数,但仍然遵循变量名称的 PEP8 约定。不过,我担心以后可能会造成混乱。
  • 无论如何,我不完全同意这是主观的。我很欣赏 PyQt,但我认为他们不遵循 PEP8 造成了伤害。 (再说一次,即使库的名称也不是很 Pythonic。考虑到我在两大洲遇到的所有说英语的开发人员,QtPy 会好得多它是“可爱派”。;-))

标签: python coding-style pyqt pyqt4 pep8


【解决方案1】:

2020 年 12 月,随着 Qt 6.0 的发布,Qt for Python 6 / PySide6(Qt 的官方 Python 绑定)也发布了,引入了一个名为 __feature__ 的新选项。使用此选项,您可以让 Qt 对象具有符合 PEP8 的蛇形案例方法和真实属性。

旧式:

table = QTableWidget()
table.setColumnCount(2)

button = QPushButton("Add")
button.setEnabled(False)

layout = QVBoxLayout()
layout.addWidget(table)
layout.addWidget(button)

新的 PySide6 样式:

from __feature__ import snake_case, true_property

table = QTableWidget()
table.column_count = 2

button = QPushButton("Add")
button.enabled = False

layout = QVBoxLayout()
layout.add_widget(table)
layout.add_widget(button)

【讨论】:

    【解决方案2】:

    使用最合适的。

    如果您是 Qt 类的子类,或者有一个与其高度集成的函数UseCamelCase。

    否则,use_underscores。

    【讨论】:

    • 这向代码的读者明确显示了与 Qt 相关联的内容,以及不与 Qt 相关的内容。
    • 在一个好的应用程序中,无论如何,实际上使用 GUI 工具包的代码量最少。
    【解决方案3】:

    pep8 文档说明了在这种情况下该怎么做(强调我的):

    新的模块和包(包括第三方框架)应该按照这些标准编写,但是如果现有的库有不同的风格,内部一致性是首选。

    【讨论】:

      【解决方案4】:

      如果你继承它,你可以使用下划线。您可以使用下划线命名您的方法,PyQt4 将能够使用它们,就像您使用 camelCase 命名它们一样。

      class SomeClass(object):
          def __getattr__(self, attr):
              if '_' in attr:
                  new = [c for c in attr]
                  while True:
                      try:
                          new_char = new[new.index('_') + 1].upper()
                          new[new.index('_'):new.index('_') + 2] = new_char
                      except (IndexError, ValueError):
                          break
              else:
                  for c in attr:
                      if c.isupper():
                          new = []
                          for i, c in enumerate(attr):
                              if i != 0 and c.isupper():
                                  new.append('_')
                              new.append(c.lower())
                          break
              try:
                  return super(type(self), self).__getattribute__(''.join(new))
              except Exception:
                  return super(type(self), self).__getattribute__(attr)
      

      【讨论】:

        【解决方案5】:

        也许明智地使用模块来分隔不同模块中的样式会有所帮助。至少尝试将基本的 PEP8 样式代码模块化为自己的辅助函数模块。

        【讨论】:

          【解决方案6】:

          在你的立场上,我不会反对你的框架,就像,作为一般原则,我不反对市政厅;-)。我碰巧分享了您对 PEP 8 指定的带有下划线的小写函数名称的偏好,但是当我在一个强制使用不同大写风格的框架中编程时,我也接受了这种风格,因为我无法说服采用“更好”风格的框架,风格不一致(不同风格的随意混合)真的更糟糕。

          当然,如果您使用多个框架,一些混合是不可避免的......例如,PyQt 及其驼峰式,和标准 Python 库函数及其小写和下划线!-)。但是由于像 Qt 这样的框架通常旨在通过子类化来扩展,而标准 Python 库中这种设计的方面较少,在大多数情况下强制使用大写样式(因为您需要覆盖一个方法,所以您不能选择不同的大小写),它将被强制为驼峰式(由 Qt),很少变为小写(由标准 Python 库)。所以,我认为在这种情况下采用 Qt 风格仍然是较小的弊端。

          【讨论】:

            猜你喜欢
            • 1970-01-01
            • 2015-07-30
            • 2017-11-04
            • 2018-03-24
            • 2011-07-24
            • 2012-11-26
            • 1970-01-01
            • 2019-06-22
            • 1970-01-01
            相关资源
            最近更新 更多