classmethod e staticmethod

Três tipos de método

Até agora, todo método que você escreveu recebia self, a instância, como primeiro parâmetro. Esse é o método de instância, o mais comum, usado quando o código precisa ler ou alterar o estado de um objeto específico. Mas nem toda operação relacionada a uma classe age sobre uma instância. Às vezes você quer uma operação ligada à classe como um todo, e às vezes quer só agrupar uma função auxiliar dentro da classe, por organização. Para esses casos existem dois decoradores: o @classmethod e o @staticmethod. Entender qual usar é uma questão simples: pergunte de que o método precisa.

classmethod e os construtores alternativos

O uso mais valioso do @classmethod é criar construtores alternativos. O __init__ é o construtor principal, mas às vezes você quer criar um objeto a partir de outro formato de dados, como uma string ou um dicionário. Poderia fazer isso com uma função solta, mas fica mais organizado e reutilizável como um método de classe. Ele recebe cls, que é a própria classe, e devolve cls(...), ou seja, uma nova instância. Usar cls em vez de escrever o nome da classe na mão tem uma vantagem: se alguém herdar da sua classe, o construtor alternativo passa a criar objetos da subclasse automaticamente, sem você mexer em nada.

class Data:
    def __init__(self, dia, mes, ano):
        self.dia = dia
        self.mes = mes
        self.ano = ano

    @classmethod
    def de_texto(cls, texto):
        # cria uma Data a partir de "dia/mes/ano"
        dia, mes, ano = (int(p) for p in texto.split("/"))
        return cls(dia, mes, ano)   # cls e a propria classe

    def __repr__(self):
        return f"Data({self.dia}, {self.mes}, {self.ano})"

d1 = Data(7, 9, 2025)
d2 = Data.de_texto("7/9/2025")   # construtor alternativo
print(d2)   # Data(7, 9, 2025)

de_texto é um construtor alternativo: recebe cls e devolve cls(...), uma nova Data.

staticmethod, a função que mora na classe

O @staticmethod é o mais simples de entender: é uma função comum que, por relação lógica, você guarda dentro da classe. Ele não recebe self nem cls, porque não precisa nem da instância nem da classe; não lê nem altera estado nenhum. Você o usa para funções auxiliares que fazem sentido no contexto da classe mas não dependem de um objeto específico, como uma validação genérica ou um cálculo puro relacionado ao tema. Colocar essa função como método estático deixa claro que ela pertence àquele grupo, sem poluir o escopo do módulo com funções soltas.

class Temperatura:
    def __init__(self, celsius):
        self.celsius = celsius

    @staticmethod
    def celsius_para_fahrenheit(c):
        # nao usa self nem cls: puro calculo relacionado ao tema
        return c * 9 / 5 + 32

    @property
    def fahrenheit(self):
        return Temperatura.celsius_para_fahrenheit(self.celsius)

print(Temperatura.celsius_para_fahrenheit(100))  # 212.0
t = Temperatura(25)
print(t.fahrenheit)                               # 77.0

O staticmethod é chamada pura, sem self nem cls; útil como auxiliar organizada na classe.

A regra prática para escolher é direta. Se o método precisa do estado de uma instância, use um método de instância comum, com self. Se ele age sobre a classe, cria objetos dela ou lê algo da classe como um todo, use @classmethod, com cls. Se ele não precisa de nada disso e é só uma função auxiliar que combina com a classe, use @staticmethod. Na dúvida entre estático e uma função solta no módulo, ambos funcionam; o método estático vence quando a função é claramente parte do vocabulário daquela classe e você quer chamá-la a partir dela.