基于深度学习的视觉检测小项目（四） pyside6和python一些常用的修饰器和属性、工具的基础知识

在 PySide6有一些常用的装饰器和工具，用于增强代码的功能和可读性。以下是一些常见的装饰器及其用法：

1. `@staticmethod`

@staticmethod 是 Python 内置的装饰器，用于声明静态方法。静态方法不需要访问类实例或类本身，可以直接通过类名调用。

示例：

class MyClass:@staticmethoddef my_static_method():print("This is a static method")# 调用静态方法
MyClass.my_static_method()

2. `@classmethod`

@classmethod 是 Python 内置的装饰器，用于声明类方法。类方法的第一个参数是类本身（通常命名为 cls），而不是实例。

示例：

class MyClass:@classmethoddef my_class_method(cls):print(f"This is a class method of {cls.__name__}")# 调用类方法
MyClass.my_class_method()

3. `@property`

@property 是 Python 内置的装饰器，用于将方法转换为属性。通过 @property，你可以像访问属性一样访问方法，而不需要显式调用方法。

示例：

class MyClass:def __init__(self):self._value = 10@propertydef value(self):return self._value@value.setterdef value(self, new_value):self._value = new_value# 使用属性
obj = MyClass()
print(obj.value)  # 访问属性
obj.value = 20    # 设置属性

4. `@functools.lru_cache`

@functools.lru_cache 是 Python 标准库 functools 中的装饰器，用于缓存函数的返回值，避免重复计算。

示例：

import functools@functools.lru_cache(maxsize=128)
def fibonacci(n):if n < 2:return nreturn fibonacci(n - 1) + fibonacci(n - 2)# 调用函数
print(fibonacci(10))  # 结果会被缓存

5. `Signal`

在 PySide6 中，PySide6.QtCore.Signal 用于声明自定义信号。信号是 Qt 框架中用于对象间通信的机制。

示例：

from PySide6.QtCore import QObject, Signalclass MyObject(QObject):my_signal = Signal(int)  # 声明一个带 int 参数的信号def trigger_signal(self):self.my_signal.emit(42)  # 发射信号# 使用信号
obj = MyObject()
obj.my_signal.connect(lambda value: print(f"Signal received: {value}"))
obj.trigger_signal()

6. `@PySide6.QtCore.Property`

@PySide6.QtCore.Property 是 PySide6 中的装饰器，用于声明 Qt 属性。Qt 属性可以在 QML 或 Qt Designer 中使用。

示例：

from PySide6.QtCore import QObject, Propertyclass MyObject(QObject):def __init__(self):super().__init__()self._value = 10@Property(int)  # 声明一个 int 类型的 Qt 属性def value(self):return self._value@value.setterdef value(self, new_value):self._value = new_value# 使用 Qt 属性
obj = MyObject()
print(obj.value)  # 访问属性
obj.value = 20    # 设置属性

7. `@contextlib.contextmanager`

@contextlib.contextmanager 是 Python 标准库 contextlib 中的装饰器，用于创建上下文管理器。上下文管理器通常用于资源管理（如文件操作、数据库连接等）。

示例：

from contextlib import contextmanager@contextmanager
def open_file(file_name, mode):file = open(file_name, mode)try:yield filefinally:file.close()# 使用上下文管理器
with open_file("test.txt", "w") as f:f.write("Hello, World!")

8. `@dataclasses.dataclass`

@dataclasses.dataclass 是 Python 标准库 dataclasses 中的装饰器，用于自动生成类的 __init__、__repr__ 等方法，简化类的定义。

示例：

from dataclasses import dataclass@dataclass
class Point:x: inty: int# 使用数据类
p = Point(10, 20)
print(p)  # 输出: Point(x=10, y=20)

9. `@typing.overload`

@typing.overload 是 Python 标准库 typing 中的装饰器，用于声明函数的重载。它可以帮助静态类型检查工具（如 mypy）理解函数的不同调用方式。

示例：

from typing import overload@overload
def process(value: int) -> int: ...
@overload
def process(value: str) -> str: ...def process(value):if isinstance(value, int):return value * 2elif isinstance(value, str):return value.upper()# 调用函数
print(process(10))  # 输出: 20
print(process("hello"))  # 输出: HELLO

10. `@unittest.mock.patch`

@unittest.mock.patch 是 Python 标准库 unittest.mock 中的装饰器，用于在单元测试中模拟对象或函数的行为。

示例：

from unittest.mock import patchdef my_function():return 42@patch("__main__.my_function", return_value=100)
def test_my_function(mock_function):assert my_function() == 100# 运行测试
test_my_function()

11. `@flag`

@flag用于定义一个标志类型。标志类型可以用于表示多个选项的组合。

示例：

from PySide6.QtCore import Flag@Flag
class MyFlags:Flag1 = 0x1Flag2 = 0x2Flag3 = 0x4

12. `@Enum`

@Enum用于定义一个枚举类型。枚举类型在处理有限的选择集合时非常有用。

示例：

from PySide6.QtCore import Enum@Enum
class MyEnum:Option1 = 0Option2 = 1Option3 = 2

13. `QMetaObject.connectSlotsByName()`

QMetaObject.connectSlotsByName() 是 Qt 框架中的一个函数，用于自动将某个对象的信号和槽通过名称匹配的方式连接起来。这个函数通常在自定义的 QObject 子类中使用，特别是在实现自定义的 UI 控件或组件时，可以简化信号和槽的连接过程。

示例：

class MyWidget(QWidget):def __init__(self):super().__init__()# 设置UIself.setupUi()# 自动连接信号和槽QMetaObject.connectSlotsByName(self)def setupUi(self):# 创建一个按钮，并设置对象名self.button = QPushButton("Click me", self)self.button.setObjectName("button")@pyqtSlot()def on_button_clicked(self):print("Button clicked!")

命名规则：
connectSlotsByName() 会根据槽函数的命名规则来匹配信号和槽。槽函数的命名规则如下：

槽函数名称: on_<objectName>_<signalName>
objectName: 对象的名称，通常通过 setObjectName() 设置。
signalName: 信号的名称，通常是信号的函数名去掉参数部分。
例如，如果有一个名为 button 的按钮对象，并且希望在按钮被点击时触发某个操作，可以定义一个槽函数名为 on_button_clicked。这样，connectSlotsByName() 会自动将 button 的 clicked 信号连接到这个槽函数。

需要知道的是：使用pyuic转换而来的.py文件代码中，QMetaObject.connectSlotsByName()命令已经被自动添加了，所以只需要根据槽函数的命名规则进行命名使用即可。

总结

装饰器	用途
`@staticmethod`	声明静态方法，无需访问实例或类。
`@classmethod`	声明类方法，第一个参数是类本身。
`@property`	将方法转换为属性，支持 getter 和 setter。
`@functools.lru_cache`	缓存函数返回值，避免重复计算。
`@PySide6.QtCore.Signal`	声明自定义信号，用于对象间通信。
`@PySide6.QtCore.Property`	声明 Qt 属性，支持在 QML 或 Qt Designer 中使用。
`@contextlib.contextmanager`	创建上下文管理器，用于资源管理。
`@dataclasses.dataclass`	自动生成类的 `__init__`、`__repr__` 等方法，简化类定义。
`@typing.overload`	声明函数重载，帮助静态类型检查工具理解函数的不同调用方式。
`@unittest.mock.patch`	在单元测试中模拟对象或函数的行为。
`@flag`	定义一个标志类型。
`@Enum`	`定义一个枚举类型。`
`connectSlotsByName()`	`将对象的信号和槽通过名称匹配的方式连接起来`