Padrões de projeto em Python

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.

  • Avançado
  • 2 min de leitura
  • 1 exemplo executável

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.

Do sinal da escola ao código
_instance = None🔔 Nenhum sinal instalado ainda
if cls._instance is None:🔧 Instale na primeira vez que alguém pedir
return cls._instance🔁 Depois disso, todos recebem o mesmo sinal
first is second✅ Dois pedidos, um objeto: True
Toda chamada devolve o mesmo objeto.
Em uma frase

O 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

  1. _instance é um atributo de classe que guarda o único objeto compartilhado.
  2. __new__ é o método que o Python chama para criar um objeto; ele só cria o objeto quando _instance ainda é None.
  3. cls._instance.theme = "dark" configura o objeto compartilhado uma única vez.
  4. 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

Executar código →
main.py
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)
Gerar um botão Run para este exemplo

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.

  1. Substitua o domínio do exemplo preservando a estrutura do padrão.
  2. Compare o padrão com uma implementação mais simples e explique as diferenças.
  3. Escreva testes para cada participante antes de adicionar outra implementação.
Executar no compilador Python →

Erros comuns

Configurar o estado no __init__

O __init__ roda em toda chamada, então reinicia o objeto compartilhado a cada vez.

Problema
def __init__(self):
    self.theme = "dark"  # runs again for every AppConfig()
Correção
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