Если ты уже немного шаришь в Python, то наверняка сталкивался с @staticmethod и @classmethod. Но зачем они вообще нужны, когда есть обычные методы? Почему не просто писать функции вне класса? Давай разберёмся, когда и зачем их использовать, и почему это не просто «питоновская магия для галочки». Погнали!

Возможности

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

Это удобно, когда хочется структурировать код, но не плодить глобальные функции, а всё держать в рамках класса.

Что требуется

• Python 3.x (работает и в 2.x, но лучше не мучить себя древностями)
• Любая ОС: Linux, macOS, Windows — без разницы
• Железо: любой калькулятор, на котором крутится Python
• Текстовый редактор, IDE или даже vim/nano

Установка — пошаговая инструкция

Специально ничего ставить не надо — @staticmethod и @classmethod идут из коробки с Python. Но если вдруг у тебя Python не установлен:

1. Скачай Python с официального сайта и установи его.
2. Проверь, что всё работает:

   python --version

   или

   python3 --version

3. Открой свой любимый редактор и создай файл, например, static_vs_class.py.

Всё, можно кодить!

Использование: полный список команд и вариантов

Вот базовая шпаргалка:

class MyClass:
    @staticmethod
    def static_method(arg1, arg2):
        print(f"Static method called with {arg1}, {arg2}")

    @classmethod
    def class_method(cls, arg1):
        print(f"Class method called from {cls.__name__} with {arg1}")

    def instance_method(self, arg1):
        print(f"Instance method called from {self} with {arg1}")

# Вызовы:
MyClass.static_method(1, 2)     # Static method called with 1, 2
MyClass.class_method("foo")     # Class method called from MyClass with foo

obj = MyClass()
obj.static_method(3, 4)         # Static method called with 3, 4
obj.class_method("bar")         # Class method called from MyClass with bar
obj.instance_method("baz")      # Instance method called from  with baz

• static_method — не зависит ни от объекта, ни от класса. Просто функция внутри класса для логической группировки.
• class_method — знает о классе, может, например, создавать новые экземпляры: return cls(...).
• instance_method — обычный метод, работает с конкретным объектом.

Примеры паттернов

• Фабричный метод через @classmethod:

  
  class User:
      def __init__(self, name):
          self.name = name
  
      @classmethod
      def from_dict(cls, data):
          return cls(data['name'])
  
  user = User.from_dict({'name': 'Vasya'})
      

• Вспомогательная функция через @staticmethod:

  
  class Math:
      @staticmethod
      def add(a, b):
          return a + b
      

Ошибки: как делать не надо

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

Пример реального использования в окружении

Реальный кейс из жизни: допустим, у тебя есть класс, который парсит логи. Для разбора строки лога тебе нужна вспомогательная функция, но она не зависит ни от объекта, ни от класса.

class LogParser:
    def __init__(self, filepath):
        self.filepath = filepath

    @staticmethod
    def parse_line(line):
        # Допустим, лог в формате: "DATE LEVEL MESSAGE"
        parts = line.strip().split(' ', 2)
        return {'date': parts[0], 'level': parts[1], 'message': parts[2]}

    def parse(self):
        with open(self.filepath) as f:
            for line in f:
                entry = self.parse_line(line)
                print(entry)

А вот фабричный метод через @classmethod:

class Server:
    def __init__(self, host, port):
        self.host = host
        self.port = port

    @classmethod
    def from_url(cls, url):
        # url: "host:port"
        host, port = url.split(':')
        return cls(host, int(port))

srv = Server.from_url("localhost:8080")

Заключение

@staticmethod и @classmethod — мощные инструменты для структурирования кода в Python. Они не только помогают держать код в порядке, но и делают его гибче и удобнее для расширения. Главное — не путать их между собой и использовать по назначению.

Официальная документация:

• staticmethod
• classmethod

Если остались вопросы или есть что добавить — пиши в комменты, всегда рад обсудить! Happy coding!