A resposta abaixo é uma coletânea adaptada das respostas a esta pergunta do SOen.
Opção 1: tornar o objeto iterável
Ao rodar este código:
class Usuario:
def __init__(self, nome, idade):
self.nome = nome
self.idade = idade
user = Usuario('Fulano', 42)
# como fazer com que "nome" e "idade" recebam os valores que estão na instância?
nome, idade = user
O erro que dá é:
TypeError: cannot unpack non-iterable Usuario object
E isso já dá a dica: para se fazer o unpacking, um objeto precisa ser iterável. Para isso, podemos implementar o método __iter__
, retornando um iterador com os campos desejados:
class Usuario:
def __init__(self, nome, idade):
self.nome = nome
self.idade = idade
def __iter__(self):
return iter((self.nome, self.idade))
user = Usuario('Fulano', 42)
nome, idade = user
print(f'{nome} tem {idade} anos') # Fulano tem 42 anos
Um detalhe importante em iter((self.nome, self.idade))
: embora pareça redundante ter dois pares de parênteses, não é. Se eu fizer apenas iter(self.nome, self.idade)
, dará erro, pois neste caso estou passando dois argumentos para iter
: o nome e a idade. Colocando o segundo par de parênteses, estou criando uma tupla contendo o nome e idade, e esta tupla é passada como argumento para iter
.
Outra solução é implementar o método __getitem__
:
class Usuario:
def __init__(self, nome, idade):
self.nome = nome
self.idade = idade
def __getitem__(self, index):
return (self.nome, self.idade)[index]
Independente da solução escolhida, agora será possível fazer o unpacking não só na atribuição, mas também ao se passar o objeto como argumento de uma função:
class Usuario:
def __init__(self, nome, idade):
self.nome = nome
self.idade = idade
def __iter__(self):
return iter((self.nome, self.idade))
def faz_algo(nome, idade):
print(f'{nome} tem {idade} anos')
user = Usuario('Fulano', 42)
# unpacking, passa o nome no primeiro argumento, e idade no segundo
faz_algo(*user) # Fulano tem 42 anos
Opção 2: dataclass
A partir do Python 3.7, você pode usar dataclass
:
from dataclasses import astuple, dataclass
@dataclass
class Usuario:
nome: str
idade: int
def __iter__(self):
return iter(astuple(self))
user = Usuario('Fulano', 42)
nome, idade = user
print(f'{nome} tem {idade} anos') # Fulano tem 42 anos
Um detalhe importante é que segundo a documentação, astuple
retorna deep copies dos objetos. Isso pode fazer diferença dependendo do caso. Por exemplo, no código abaixo, a lista original é modificada se não usarmos dataclass
:
from dataclasses import astuple, dataclass
@dataclass
class ComDataClass:
nome: str
notas: list[int]
def __iter__(self):
return iter(astuple(self))
c = ComDataClass('Fulano', [1, 2, 3])
nome, notas = c
# muda a nota
notas[1] = 10
# não altera a lista original (unpacking retorna uma deep copy da lista)
print(c.notas) # [1, 2, 3]
class SemDataClass:
def __init__(self, nome, notas):
self.nome = nome
self.notas = notas
def __iter__(self):
return iter((self.nome, self.notas))
s = SemDataClass('Fulano', [1, 2, 3])
nome, notas = s
# muda a nota
notas[1] = 10
# altera a lista original (pois unpacking retorna a mesma lista, não é feita uma cópia)
print(s.notas) # [1, 10, 3]
Uma forma de evitar a deep copy seria alterar o método __iter__
para:
from dataclasses import astuple, dataclass, fields
@dataclass
class ComDataClass:
nome: str
notas: list[int]
def __iter__(self):
return (getattr(self, field.name) for field in fields(self))
c = ComDataClass('Fulano', [1, 2, 3])
nome, notas = c
# muda a nota
notas[1] = 10
# altera a lista original (não é mais feita a deep copy)
print(c.notas) # [1, 10, 3]
Ou seja, agora não é mais feita a deep copy da lista, então alterações feitas nela afetam a original.
Vale notar que os parênteses em volta da expressão getattr(self, etc...
são obrigatórios: sem eles ocorre um erro de sintaxe, pois trata-se de uma generator expression.
Outra opção é retornar iter(self.__dict__.values())
. Lembrando que a partir do Python 3.6 o atributo __dict__
garante que os campos são retornados na ordem em que foram declarados. Se quiser que os campos estejam em outra ordem, o jeito é retorná-los explicitamente em uma tupla: iter((campoX, campoY, etc))
. Vale lembrar também que o atributo __dict__
só está disponível caso a classe não declare o atributo __slots__
(ver mais aqui).
Opção 3: namedtuple
Por fim, outra opção é usar namedtuple
, que já dá "de bônus" a capacidade de se fazer o unpacking:
from collections import namedtuple
Usuario = namedtuple('Usuario', ['nome', 'idade'])
user = Usuario('Fulano', 42)
nome, idade = user
print(f'{nome} tem {idade} anos') # Fulano tem 42 anos
Um detalhe é que, independente da solução escolhida, os nomes das variáveis não precisam bater com os das propriedades. Então nada impede que se faça a, b = user
, por exemplo. Independente dos nomes, a primeira variável receberá o primeiro valor retornado pelo iterador, a segunda variável receberá o segundo valor, e assim por diante.
Vale lembrar que existem diferenças entre classe, dataclass
e nametuple
, que podem ou não ser relevantes depedendo de cada caso (já foge do escopo da pergunta, mas de qualquer forma, sugiro ler aqui e aqui).
Obs: A outra resposta é um ótimo complemento que resolve de forma engenhosa uma situação específica. Mas ela possui várias restrições: as variáveis devem ter os mesmos nomes dos campos da classe, e ainda exigiria um código adicional (e bem complexo) para detectar casos em que o objeto é passado para uma função, como em func(*user)
ou func(*objeto_de_classe_diferente, *user)
.