O que é uma classe?

Uma classe é uma definição — ela descreve como um objeto vai ser, mas não é o objeto em si. Pense como um projeto de engenharia: o projeto não é o produto, mas contém tudo que o produto precisa ter.

Analogias úteis

• Classe = receita de bolo / Objeto = o bolo pronto
• Classe = planta arquitetônica / Objeto = o prédio construído
• Classe = espécie (Cachorro) / Objeto = animal específico (Rex)
• Classe = forma de biscoito / Objeto = cada biscoito recortado

Por que isso importa?

Você define a estrutura uma vez e pode criar quantas instâncias precisar, cada uma com seus próprios dados mas compartilhando a mesma estrutura e comportamentos.

Sintaxe mínima

class MinhaClasse:
    pass  # classe vazia

obj = MinhaClasse()  # instanciar = criar objeto

O pass é necessário porque Python exige ao menos uma instrução no corpo da classe.

O que é __init__?

O __init__ é o construtor da classe — executado automaticamente quando você cria um objeto. É onde você define os atributos iniciais.

O que acontece em Cachorro("Rex", 3)?

• Python cria um novo objeto vazio do tipo Cachorro
• Chama __init__ passando esse objeto como self, "Rex" como nome e 3 como idade
• self.nome = nome guarda "Rex" dentro do objeto
• O objeto pronto é retornado e atribuído à variável rex

O papel do self

self é uma convenção para o primeiro parâmetro de qualquer método de instância. Ele recebe automaticamente o objeto que chamou o método. Nunca quebre essa convenção.

Atributos de instância

class Cachorro:
    def __init__(self, nome, idade):
        self.nome  = nome
        self.idade = idade

rex  = Cachorro("Rex", 3)
bolt = Cachorro("Bolt", 1)

rex.nome = "Max"
print(bolt.nome)  # Bolt — bolt não mudou

Por que o self é necessário?

Quando você escreve o código da classe, você ainda não sabe o nome que o usuário vai dar para o objeto. Você não sabe se vai ser rex, bolt ou totó.

O self funciona como um nome genérico (um pronome) dentro da classe que significa: "este objeto aqui que está executando a ação agora".

O que acontece "por baixo dos panos"?

Veja a diferença entre como você escreve e como o Python lê:

Como você escreve:

class Cachorro:
    def __init__(self, nome):
        self.nome = nome

rex = Cachorro("Rex")

Como o Python interpreta:

Quando você faz Cachorro("Rex"), o Python reserva um espaço na memória e faz o seguinte:

"Ei, função __init__, preencha os dados para este novo objeto que acabei de criar. O self dele vai ser essa região de memória que vou chamar de rex."

Por que ele tem que ser o primeiro parâmetro?

Porque o Python sempre envia o próprio objeto como o primeiro argumento de qualquer função dentro da classe, de forma automática.

# Se você chama:
rex.latir()

# Python na verdade executa:
Cachorro.latir(rex)

O self recebe o rex para que, dentro da função, o código saiba se deve usar o latido de um Labrador ou de um Pinscher.

O que é um método?

Um método de instância é uma função dentro de uma classe que sempre recebe self como primeiro parâmetro. Através de self, o método acessa e modifica os atributos do objeto.

Diferença entre função e método

# Função avulsa
def latir(nome):
    print(f"{nome} diz: Au!")

# Método — o dado pertence ao objeto
class Cachorro:
    def latir(self):
        print(f"{self.nome} diz: Au!")

Como Python chama o método

rex.latir() — Python automaticamente passa rex como self. Nos bastidores: Cachorro.latir(rex).

Métodos podem retornar valores e chamar outros métodos

class Aluno:
    def calcular_media(self):
        return sum(self.notas) / len(self.notas)

    def situacao(self):
        media = self.calcular_media()
        return "Aprovado" if media >= 7 else "Reprovado"

1. Esquecer o self no método

Todo método de instância precisa dele como o primeiro parâmetro entre os parênteses.

❌ Errado:

def latir():

Dará erro quando você tentar chamar o método.

✅ Certo:

def latir(self):

2. Não usar self. para acessar atributos

Dentro da classe, o Python não adivinha que "nome" é o atributo do objeto. Você precisa apontar.

❌ Errado:

print(nome)

O Python dirá que "nome" não está definido.

✅ Certo:

print(self.nome)

3. Esquecer de inicializar no __init__

Você não pode usar ou alterar algo que não foi "apresentado" ao Python no construtor.

❌ Errado:

self.notas.append(10)  # sem ter criado a lista

Vai dar AttributeError.

✅ Certo:

def __init__(self):
    self.notas = []  # criar primeiro

4. Chamar método sem parênteses

Sem os parênteses (), você só está citando o nome do método, não mandando ele agir.

❌ Errado:

rex.latir

O código passa direto e nada acontece.

✅ Certo:

rex.latir()

Agora sim o cachorro late no console.

5. Confundir Classe com Objeto

A Classe é a planta, o Objeto é a casa pronta. Você interage com a casa.

❌ Errado:

Cachorro.latir()

Você está tentando fazer o "molde" latir.

✅ Certo:

rex = Cachorro()
rex.latir()

Você cria o objeto e depois o usa.

1. Por que self aparece na definição mas não na chamada?

Quando você escreve def latir(self):, está dizendo ao Python que esse método pertence a um objeto. Mas quando você chama rex.latir(), o Python já sabe que rex é o objeto — então ele passa o rex como self automaticamente nos bastidores.

É como se o Python traduzisse rex.latir() para Cachorro.latir(rex). Você nunca precisa passar o self explicitamente na chamada.

2. Qual a diferença entre Cachorro e Cachorro()?

Cachorro sem parênteses é a classe em si — o molde, a definição. Você pode até inspecioná-la, mas ela não é um cachorro de verdade.

Cachorro() com parênteses chama o construtor __init__ e fabrica um objeto novo na memória. É a diferença entre a planta arquitetônica e o prédio construído.

Sempre que quiser um objeto para usar, use os parênteses.

3. Posso ter uma classe sem __init__?

Sim. Se você não escrever um __init__, o Python usa um construtor padrão vazio. Na prática, porém, quase toda classe precisa de um, porque é nele que você define o estado inicial do objeto.

Sem __init__:

class Cachorro:
    pass

rex = Cachorro()
rex.nome = "Rex"   # atributo adicionado depois

Com __init__ — mais organizado e seguro:

class Cachorro:
    def __init__(self, nome):
        self.nome = nome

rex = Cachorro("Rex")  # todo cachorro nasce com nome

A segunda forma garante que todo objeto nasce com seus dados. Na primeira, você poderia criar um cachorro sem nome e só descobrir o erro lá na frente.

4. Quando uso classe e quando uso só funções?

A regra prática: se você tem dados que andam juntos e ações que operam sobre esses dados, crie uma classe. Se é uma operação isolada sem estado, use função.

Função — sem estado, só transforma:

def celsius_para_fahrenheit(c):
    return c * 1.8 + 32

Classe — dados e ações juntos:

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

    def em_fahrenheit(self):
        return self.celsius * 1.8 + 32

Se você só precisa converter um valor pontualmente, a função basta. Se precisa representar um termômetro real com estado, use a classe.