Po tej lekcji będziesz potrafić:

• rozpoznawać, kiedy metoda potrzebuje instancji (self), klasy (cls) albo żadnego z nich.
• definiować i wywoływać @classmethod, aby pracować z informacjami na poziomie klasy lub tworzyć obiekty.
• definiować i wywoływać @staticmethod dla funkcji pomocniczej, która koncepcyjnie należy do klasy.
• łączyć trzy rodzaje metod w małej klasie bez mieszania stanu obiektu i stanu wspólnego.

Zwykła metoda instancji zaczyna się od self, czyli bieżącego obiektu. Była już używana do odczytu i zmiany atrybutów utworzonych w __init__:

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

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

Metoda klasowa zaczyna się od cls i jest oznaczona @classmethod. Automatycznie otrzymuje klasę, niezależnie od tego, czy wywołasz ją przez klasę, czy przez instancję. Metody klasowe są przydatne do odczytu wspólnego ustawienia lub konstruowania instancji z innego formatu danych wejściowych.

Metoda statyczna, oznaczona @staticmethod, nie otrzymuje automatycznie ani self, ani cls. Użyj jej dla ściśle powiązanego obliczenia lub walidacji, które nie potrzebuje stanu obiektu.

Te adnotacje używają składni @..., ale ogólnych dekoratorów jeszcze nie potrzebujesz. @classmethod i @staticmethod to wbudowane formy, których potrzebujesz w tej lekcji.

1. Odczyt wspólnego ustawienia metodą klasową

cls odnosi się do klasy, więc wynik używa jej wspólnego ustawienia.

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

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

print(Mailer.sender())

Wynik:

robot@example.com

W odróżnieniu od metody instancji, można ją wywołać bez tworzenia obiektu Mailer.

2. Walidacja bez stanu obiektu

Metoda statyczna grupuje funkcję pomocniczą z typem, do którego się odnosi. Przyjmuje tylko parametry, które napiszesz.

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

print(PortRules.is_allowed(443))

Wynik:

True

Nie ma ani self, ani cls w is_allowed, ponieważ metoda używa tylko port.

3. Tworzenie obiektu przez metodę klasową

Metoda klasowa może oferować inny sposób utworzenia poprawnej instancji.

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)

Wynik:

Operator

Użycie cls(...) konstruuje instancję klasy, która otrzymała wywołanie.

4. Metoda instancji dla indywidualnego stanu

Metoda używająca self zwraca informacje o konkretnym obiekcie.

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())

Wynik:

starter: inactive

Każda subskrypcja może mieć inny stan, więc metoda instancji jest odpowiednia.

• Zapomnienie o @classmethod i założenie, że cls jest przekazywane automatycznie.
• Zadeklarowanie metody statycznej z self, mimo że wywołujący podaje tylko jej jawne argumenty.
• Aktualizowanie self.setting, gdy celem jest zmiana ustawienia współdzielonego przez klasę.
• Użycie metody statycznej, gdy zachowanie musi odczytywać atrybuty pojedynczego obiektu.