HOWTO · Python

Cómo imprimir los atributos de un objeto en Python

Aprende a acceder e inspeccionar los atributos de un objeto en Python con ejemplos prácticos.

En esta página

Para imprimir un atributo conocido, accede a él con la notación de punto y pasa su valor a print(). Si el nombre está guardado en una cadena, usa getattr(); para inspeccionar los atributos almacenados en una instancia, usa __dict__ o vars() cuando estén disponibles; y para descubrir los nombres que Python expone en un objeto, usa dir(). Cada opción ofrece una vista distinta: elige según necesites un valor concreto, el mapeo de la instancia o una lista más amplia de nombres.

Una clase Person puede definir atributos de clase, y cada objeto también puede guardar sus propios atributos de instancia. En los ejemplos siguientes crearemos una persona con nombre, edad y ciudad.

Imprimir atributos de un objeto en Python con print y acceso a atributos

Cuando conoces el nombre del atributo, la notación de punto es la forma más directa de leerlo. Pasa su valor a la función integrada print():

class Person:
    def __init__(self, name, age, city):
        self.name = name
        self.age = age
        self.city = city

person = Person("John Doe", 30, "New York")
print(person.name)
John Doe

La expresión lee name de esta instancia y escribe su valor en la salida estándar.

Imprimir atributos de un objeto en Python con la función getattr

Usa getattr() cuando el nombre del atributo esté en una variable o se determine durante la ejecución. El segundo argumento debe ser una cadena. El tercer argumento, que es opcional, proporciona un valor alternativo si ese nombre no está disponible; si lo omites, un atributo inexistente provoca AttributeError.

class Person:
    def __init__(self, name, age, city):
        self.name = name
        self.age = age
        self.city = city

person = Person("John Doe", 30, "New York")
attribute_name = "city"
city = getattr(person, attribute_name, "Unknown")
print(city)
New York

Cambia attribute_name para seleccionar otro atributo, o modifica el valor predeterminado según las necesidades de tu aplicación. Sin el tercer argumento, un nombre inexistente provoca AttributeError.

Imprimir atributos de un objeto en Python con el atributo __dict__

El atributo __dict__ de una instancia es su mapeo de atributos, si esa instancia lo expone. Contiene los atributos almacenados en la instancia, como los valores asignados a self.name en __init__; no incluye los atributos definidos únicamente en la clase.

class Person:
    def __init__(self, name, age, city):
        self.name = name
        self.age = age
        self.city = city

person = Person("John Doe", 30, "New York")
attributes = person.__dict__
print(attributes["name"])
John Doe

Algunos objetos no exponen un __dict__ de instancia. Por ejemplo, puede ocurrir con instancias de clases que usan __slots__ sin un diccionario, así que este método no sirve para todos los objetos.

Imprimir atributos de un objeto en Python con la función dir()

Llama a dir(person) para obtener una lista ordenada de los nombres que Python expone para inspeccionar el objeto. La lista puede incluir atributos de instancia y de clase, métodos y nombres especiales; no contiene únicamente datos almacenados en la instancia. Para presentar una lista larga de forma más legible, puedes usar la función pprint() de la biblioteca estándar:

class Person:
    def __init__(self, name, age, city):
        self.name = name
        self.age = age
        self.city = city

person = Person("John Doe", 30, "New York")
print("name" in dir(person))
True

Esta comprobación muestra que name está entre los nombres expuestos. Los nombres exactos dependen del objeto y de su clase, y un método __dir__() personalizado puede modificar lo que devuelve dir(). Por eso, considera dir() una ayuda para descubrir nombres, no una instantánea del diccionario de la instancia. Para ver la lista completa con un formato legible, pasa dir(person) a la función pprint().

Imprimir atributos de un objeto en Python con la función vars()

En un objeto que expone __dict__, vars(person) devuelve el mismo mapeo de atributos de instancia. Puedes pasar ese mapeo a pprint() para darle un formato más fácil de leer:

class Person:
    def __init__(self, name, age, city):
        self.name = name
        self.age = age
        self.city = city

person = Person("John Doe", 30, "New York")
print(vars(person)["name"])
John Doe

Llamar a vars() sin argumentos tiene otro propósito: devuelve la tabla de símbolos local actual. Si pasas un objeto que no tiene __dict__, se produce TypeError; por tanto, usa esta función para obtener el mapeo de la instancia cuando sepas que el objeto lo proporciona. Para dar formato al mapeo completo, pasa vars(person) a la función pprint().

Conclusión

Elige el método según lo que necesites: usa el acceso con punto y print() para un valor conocido; getattr() para un nombre de atributo dinámico; __dict__ o vars() para consultar los atributos almacenados en la instancia cuando el objeto exponga un diccionario; y dir() para descubrir un conjunto más amplio de nombres. Recuerda que dir() puede incluir métodos y nombres especiales, mientras que el diccionario de una instancia contiene solo los atributos almacenados en esa instancia.