Padrão de projeto Singleton em Python
Nesta lição, você vai implementar o padrão Singleton para garantir que uma classe tenha um único objeto compartilhado.
Introdução
O problema
Algumas coisas devem existir só uma vez num programa: as configurações do app, um pool de conexões, um logger que escreve num único arquivo. Se cada parte do código cria a sua própria cópia, as configurações deixam de bater e você desperdiça recursos.
Pense assim
Um singleton é como o único sinal da escola num prédio. Todas as salas usam o mesmo sinal, e ninguém instala um sinal só seu. Em qualquer sala, quem pede o sinal recebe sempre aquele mesmo sinal.
_instance = None🔔 Nenhum sinal instalado aindaif cls._instance is None:🔧 Instale na primeira vez que alguém pedirreturn cls._instance🔁 Depois disso, todos recebem o mesmo sinalfirst is second✅ Dois pedidos, um objeto: TrueO padrão Singleton faz uma classe devolver sempre a mesma instância, toda vez que alguém tenta criá-la. Assim, o programa inteiro compartilha um único objeto.
Pontos-chave
_instanceé um atributo de classe que guarda o único objeto compartilhado.__new__é o método que o Python chama para criar um objeto; ele só cria o objeto quando_instanceainda é None.cls._instance.theme = "dark"configura o objeto compartilhado uma única vez.first is secondé True: os dois nomes apontam para o mesmo objeto.
Quando usar?
- Configuração de toda a aplicação, lida por todos os módulos.
- Um recurso compartilhado, como cache, logger ou pool de conexões.
- Aprender como
__new__controla a criação de objetos.
Quando não é preciso
- A maior parte do código Python: um objeto no nível do módulo (módulos são criados uma vez só) é mais simples e faz o mesmo.
- Código que você quer testar com facilidade: estado global escondido faz os testes dependerem uns dos outros. Prefira passar o objeto como argumento.
Código de exemplo
class AppConfig:
# Singleton: every caller receives one shared configuration object.
_instance = None
def __new__(cls):
# Create the shared instance only on the first call.
if cls._instance is None:
cls._instance = super().__new__(cls)
cls._instance.theme = "dark"
return cls._instance
first = AppConfig()
second = AppConfig()
print(first is second)
Resultado da execução
True
Explicação do código
O método __new__ é chamado antes de __init__ toda vez que um objeto é criado. Na primeira chamada, _instance ainda é None, então o objeto é criado e guardado. Nas chamadas seguintes, __new__ apenas devolve o objeto já guardado, por isso a comparação dos dois objetos com is resulta em True.
Altere os valores e execute o programa no compilador Python online CodeUtility sem instalar Python.
Exercícios práticos
Tente modificar o código seguindo as sugestões abaixo. Mudar o código e observar o resultado ajuda você a entender muito mais do que só ler.
- Substitua o domínio do exemplo preservando a estrutura do padrão.
- Compare o padrão com uma implementação mais simples e explique as diferenças.
- Escreva testes para cada participante antes de adicionar outra implementação.
Erros comuns
Configurar o estado no __init__
O __init__ roda em toda chamada, então reinicia o objeto compartilhado a cada vez.
def __init__(self):
self.theme = "dark" # runs again for every AppConfig()
if cls._instance is None:
cls._instance = super().__new__(cls)
cls._instance.theme = "dark"
Terminou esta lição?
Marque como aprendida para acompanhar seu progresso.
Pratique com um desafio
Use o conteúdo desta lição para resolver um problema real. Cada desafio roda no navegador, com testes instantâneos e uma revisão por IA.
Todos os desafios