Skip to content

Class method and Static method - Методы @classmethod и @staticmethod ​

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

Три вида методов ​

ВидПервый параметрДоступ кКогда нужен
обычныйself (экземпляр)self.*, Class.*логика, привязанная к объекту
@classmethodcls (класс)cls.*фабрики-конструкторы, счётчики, работа с классом
@staticmethodотсутствуеттолько аргументывспомогательная функция, логически связанная с классом

@staticmethod — функция в пространстве имён класса ​

Статический метод не получает ни self, ни cls. Это обычная функция, «переехавшая» внутрь класса ради группировки:

python
class ParcelBox:
    material = 'paper'

    def __init__(self, length, width, height):
        self.length, self.width, self.height = length, width, height

    @staticmethod
    def volume(length, width, height):
        """Вычислить объём без создания объекта."""
        return length * width * height


print(ParcelBox.volume(2, 3, 4))      # 24
box = ParcelBox(2, 3, 4)
print(box.volume(5, 6, 7))      # 210 — вызов через экземпляр тоже работает

@classmethod — метод, которому нужен класс ​

Первый параметр cls — сам класс, а не экземпляр. Типичное применение — альтернативные конструкторы (фабрики):

python
class ParcelBox:
    material = 'paper'
    count = 0  # общий счётчик всех коробок

    def __init__(self, length, width, height):
        self.length, self.width, self.height = length, width, height
        ParcelBox.count += 1

    @classmethod
    def get_box_small(cls):
        """Фабричный метод для создания маленькой коробки (куб 1x1x1)."""
        return cls(1, 1, 1)

    @classmethod
    def get_box_middle(cls):
        """Фабричный метод для создания средней коробки (куб 5x5x5)."""
        return cls(5, 5, 5)

    @classmethod
    def get_box_large(cls):
        """Фабричный метод для создания большой коробки (куб 10x10x10)."""
        return cls(10, 10, 10)

    @classmethod
    def from_volume(cls, volume):
        """Создать куб по заданному объёму."""
        side = round(volume ** (1 / 3), 2)
        return cls(side, side, side)

    @classmethod
    def show_count(cls):
        print(f'Создано коробок: {cls.count}')

# Использование фабричных методов
box_small = ParcelBox.get_box_small()
print(box_small, box_small.__dict__)
box_large = ParcelBox.get_box_large()
print(box_large, box_large.__dict__)

# Создание через объем
box = ParcelBox.from_volume(8)
print(box.length, type(box) is ParcelBox)  # 2.0 True

# Обычное создание через __init__
box = ParcelBox(1, 1, 1)
print(box.__dict__)

# Проверка общего счетчика
ParcelBox.show_count()   # Создано коробок: 4

Пояснения к коду ​

  1. Фабричные методы (get_box_small, get_box_middle, get_box_large): Внутри этих методов вызов cls(...) — это динамическое обращение к конструктору класса. Вместо жестко прописанного ParcelBox(1, 1, 1) мы пишем cls(1, 1, 1). Это инициализирует и возвращает новый объект.
  2. Параметр cls: Когда мы вызываем метод как ParcelBox.get_box_small(), Python автоматически передает сам класс ParcelBox в качестве первого аргумента.
  3. Метод show_count: Показывает, что @classmethod удобен не только для создания объектов, но и для работы с атрибутами самого класса (в данном случае с глобальным счетчиком count), без привязки к конкретному экземпляру.

Почему cls, а не имя класса? ​

Использование параметра cls вместо жестко прописанного имени класса ParcelBox защищает код от поломок при изменении проекта (рефакторинге).

Если в процессе разработки вы решите переименовать класс ParcelBox, например, в Container, то при явном использовании имени класса вам придется вручную искать и менять его во всех методах. Но если внутри методов используется cls, код продолжит работать автоматически. Переменная cls всегда динамически указывает на текущий класс, как бы он ни назывался на самом деле.

Пример защиты от переименования:

python
# Если мы решим переименовать класс, код внутри from_volume продолжит работать,
# так как cls автоматически примет новое актуальное имя класса.
class ParcelBox:
    def __init__(self, side):
        self.side = side

    @classmethod
    def from_volume(cls, volume):
        side = round(volume ** (1 / 3), 2)
        return cls(side)  # Автоматически превращается в вызов ParcelBox(side)

box = ParcelBox.from_volume(27)
print(type(box) is ParcelBox)  # True — фабрика вернула именно объект ParcelBox

Сравнение вызовов ​

Методы класса (@classmethod) и статические методы (@staticmethod) можно вызывать как напрямую через сам класс, так и через его созданные объекты (экземпляры). Однако работают они с разным уровнем доступа к данным:

python
class ParcelBox:
    def __init__(self, length, width, height):
        self.length, self.width, self.height = length, width, height

    @staticmethod
    def get_static():
        # Статический метод ведет себя как обычная изолированная функция.
        # У него нет доступа ни к самому классу ParcelBox, ни к его внутренним переменным.
        return 'static'

    @classmethod
    def get_class(cls):
        # Метод класса всегда автоматически получает ссылку на класс (cls) в качестве первого аргумента,
        # поэтому он имеет полный доступ к атрибутам и имени текущего класса.
        return cls.__name__

# Вызов через класс
print(ParcelBox.get_static(), ParcelBox.get_class())        # static ParcelBox

# Вызов через экземпляр
box_instance = ParcelBox(1, 1, 1)
print(box_instance.get_static(), box_instance.get_class())  # static ParcelBox

Главные отличия: ​

  • @classmethod — это метод, который накрепко связан с самим классом. Python автоматически передает ему класс в аргумент cls. Этот метод незаменим, когда нужно создать альтернативный конструктор (фабрику объектов) или изменить настройки/счетчики самого класса.
  • @staticmethod — это простая функция, которую поместили внутрь класса исключительно ради логической группировки кода. Она не получает никаких скрытых аргументов и не может влиять на переменные класса.

Проверьте себя ​

❓Какой первый параметр у метода с декоратором `@classmethod`?
❓Что такое `@staticmethod`?
❓Зачем фабричные методы пишут как `@classmethod`?
❓Почему внутри фабрики используют `cls`, а не имя `ParcelBox`?
❓Что делает атрибут класса `count` в примере урока?
❓Как можно вызывать `@classmethod` и `@staticmethod`?

Упражнения: ​

  1. Создайте класс Student со статическим методом is_adult(age), возвращающим True, если возраст больше 17:

    • Добавьте в Student атрибут класса enrolled (число зачисленных) и метод __init__, увеличивающий его.
    • Реализуйте @classmethod from_full_name(cls, full_name), создающий студента из строки «Имя Фамилия».
    • Создайте наследника Teacher(Student) и убедитесь, что Teacher.from_full_name('A B') возвращает объект типа Teacher.
  2. Добавьте в класс ParcelBox из урока:

    • атрибут класса count (счётчик созданных коробок) и его инкремент в __init__;
    • @classmethod show_count(cls), выводящий f'Создано коробок: {cls.count}';
    • фабрику @classmethod from_side(cls, side) — квадратная коробка;
    • @staticmethod check_side(side), возвращающую True, если сторона положительна.

    Создайте 3 коробки тремя разными способами (from_side, from_volume, __init__) и убедитесь, что show_count выводит «Создано коробок: 3».

  3. Создайте класс Converter, в котором все методы помечены @staticmethod и переводят температуру между единицами измерения:

    • fahrenheit_to_celsius(fahrenheit) — °F в °C: °C = (°F – 32) × 5 ÷ 9;
    • fahrenheit_to_kelvin(fahrenheit) — °F в K: K = (°F – 32) × 5 ÷ 9 + 273.15;
    • celsius_to_kelvin(celsius) — °C в K: K = °C + 273.15;
    • celsius_to_fahrenheit(celsius) — °C в °F: °F = °C × 9 ÷ 5 + 32;
    • kelvin_to_celsius(kelvin) — K в °C: °C = K – 273.15;
    • kelvin_to_fahrenheit(kelvin) — K в °F: °F = (K – 273.15) × 9 ÷ 5 + 32.

    Убедитесь, что все методы можно вызвать без создания экземпляра класса:

    python
    print(Converter.fahrenheit_to_celsius(212))     # 100.0
    print(Converter.celsius_to_fahrenheit(0))       # 32.0
    print(Converter.kelvin_to_celsius(273.15))      # 0.0
    print(round(Converter.fahrenheit_to_kelvin(-40), 2))   # 233.15
    print(Converter.kelvin_to_fahrenheit(373.15))   # 212.0
  4. Создайте класс проверки строки как числа NumberChecker со статическими методами (каждый принимает строку и возвращает bool):

    • is_positive_int — целое положительное число;
    • is_negative_int — целое отрицательное число;
    • is_int — целое число;
    • is_positive_float — дробное положительное число;
    • is_negative_float — дробное отрицательное число;
    • is_float — дробное число;
    • is_positive — положительное число;
    • is_negative — отрицательное число;
    • is_number — число;
    • is_zero — ноль.

    Постарайтесь переиспользовать уже написанные методы (например, is_positive_int через is_int и is_positive). Проверьте работу методов на наборе тестовых строк. Используйте класс для проверки числовых полей калькулятора котенка (цена, количество, дней, года).

  5. Создайте класс GoodChecker с методами проверки строк для калькулятора котенка (каждый принимает строку и возвращает bool):

    • is_valid_name — название товара: не короче двух символов и содержит хотя бы одну букву;
    • is_valid_quantity — количество товара: целое положительное число, не ноль;
    • is_valid_price — цена товара: положительное число, не более двух знаков после запятой;
    • is_valid_day — день: целое положительное число, не ноль;
    • is_valid_year — год: целое или половинное число (например, 5 или 5.5), не ноль.

    Используйте класс в решении программы калькулятора котенка.