После этого урока ты сможешь:

• Определять, когда методу нужен экземпляр (self), класс (cls) или ни то, ни другое.
• Объявлять и вызывать @classmethod для работы с информацией уровня класса или создания объектов.
• Объявлять и вызывать @staticmethod для вспомогательной функции, концептуально относящейся к классу.
• Сочетать три вида методов в небольшом классе без путаницы между состоянием объекта и общим состоянием.

Обычный метод экземпляра начинается с self, текущего объекта. Ты уже использовал его для чтения и изменения атрибутов, созданных в __init__:

class Job:
    def __init__(self, name):
        self.name = name

    def display_name(self):
        return self.name.upper()

Метод класса начинается с cls и помечается декоратором @classmethod. Он получает класс автоматически, независимо от того, вызываешь ли ты его через класс или через экземпляр. Методы класса удобны для чтения общих настроек или создания экземпляра из альтернативного формата входных данных.

Статический метод, помеченный декоратором @staticmethod, не получает self или cls автоматически. Используй его для тесно связанных вычислений или валидации, которым не требуется состояние объекта.

Эти аннотации используют синтаксис @..., но тебе пока не нужны универсальные декораторы. @classmethod и @staticmethod — это встроенные формы, необходимые в этом уроке.

1. Чтение общей настройки с помощью метода класса

cls ссылается на класс, поэтому результат использует его общую настройку.

class Mailer:
    default_sender = "robot@example.com"

    @classmethod
    def sender(cls):
        return cls.default_sender

print(Mailer.sender())

Вывод:

robot@example.com

В отличие от метода экземпляра, этот метод можно вызвать без создания объекта Mailer.

2. Валидация без состояния объекта

Статический метод группирует служебную функцию с типом данных, к которому она относится. Он принимает только те параметры, которые ты объявил.

class PortRules:
    @staticmethod
    def is_allowed(port):
        return 1 <= port <= 65535

print(PortRules.is_allowed(443))

Вывод:

True

Здесь нет self или cls в is_allowed, так как метод использует только port.

3. Создание объекта через метод класса

Метод класса может предоставлять альтернативный способ создания валидного экземпляра.

class Badge:
    def __init__(self, title):
        self.title = title

    @classmethod
    def from_text(cls, raw_title):
        return cls(raw_title.strip())

print(Badge.from_text("  Operator  ").title)

Вывод:

Operator

Использование cls(...) создает экземпляр того класса, который вызвал метод.

4. Использование метода экземпляра для индивидуального состояния

Метод, использующий self, возвращает информацию о конкретном объекте.

class Subscription:
    def __init__(self, plan, active):
        self.plan = plan
        self.active = active

    def status(self):
        if self.active:
            return f"{self.plan}: active"
        return f"{self.plan}: inactive"

print(Subscription("starter", False).status())

Вывод:

starter: inactive

Каждая подписка может иметь различное состояние, поэтому здесь уместен метод экземпляра.

• Забытый @classmethod с расчетом на то, что cls передастся автоматически.
• Объявление статического метода с self, хотя вызывающий код передает только явные аргументы.
• Обновление self.setting, когда целью является изменение настройки, общей для всего класса.
• Использование статического метода, когда поведению требуется читать атрибуты отдельного объекта.