Customizing Attribute Access

Intermediate Object-Oriented Programming in Python

Jake Roach

Data Engineer

AttributeError

class Student:
  def __init__(self, student_name, major):
    self.student_name = student_name
    self.major = major
...
karina = Student("Karina", "Literature")
student.residence_hall  # Attempt to access an attribute that does not exist
...
AttributeError: 'Student' object has no attribute 'residence_hall'
Intermediate Object-Oriented Programming in Python

__getattr__()

# Rest of the class definition above

  def __getattr__(self, name):
    # Implement logic here
    ...

An object's namespace is a collection of attributes that are associated with that object

__getattr__() is executed when an attempt to reference ANY attribute outside of an object's namespace** is made

  • Magic method, not called directly
  • Takes a name parameter
  • Implements custom functionality, rather than raising an AttributeError
Intermediate Object-Oriented Programming in Python

Resolving the AttributeError

class Student:
  def __init__(self, student_name, major):
    self.student_name = student_name
    self.major = major

  def __getattr__(self, name):
      print(f"""{name} does not exist in this object's namespace, try setting 
            a value for {name} first""")
karina.residence_hall  # Now, try to retrieve the residence_hall attribute again
residence_hall does not exist in this object's namespace, try setting a value for 
  residence_hall first
Intermediate Object-Oriented Programming in Python

__setattr__()

__setattr__() is a magic method that is executed when a (new or existing) attribute is set or updated

  • Includes attributes set using __init__()
  • Takes name of attribute and value
  • Leverages __dict__ attribute of the object

$$

$$

Controlling changes to attributes, validation, transformation

# Rest of the class definition above

  def __setattr__(self, name, value):
    # Implement logic here
    ...

    # Use __dict__ to create/update 
    # the attribute
    self.__dict__[name] = value

__dict__ stores all attributes of the object, can be used to retrieve and store data

Intermediate Object-Oriented Programming in Python

Customizing attribute storage

class Student:
  def __init__(self, student_name, major):
    self.student_name = student_name
    self.major = major

  def __setattr__(self, name, value):
    # If value is a string, set the attribute using the __dict__ attribute
    if isinstance(value, str):
      print(f"Setting {name} = {value}")
      self.__dict__[name] = value

    else: # Otherwise, raise an exception noting an incorrect data type
        raise Exception("Unexpected data type!")
Intermediate Object-Oriented Programming in Python

__setattr__ in action

# Set an attribute using a value of type 'str'
karina.residence_hall = "Honors College South"
print(karina.residence_hall)
Setting residence_hall = Honors College South
Honors College South
# Set an attribute using a value of type 'int'
karina.student_id = 19301872
...
    raise Exception("Unexpected data type!")
Exception: Unexpected data type!
Intermediate Object-Oriented Programming in Python

Using __getattr__ and __setattr__ together

class Student:
    ...   

    def __getattr__(self, name):
        # Set the attribute with a placeholder
        self.__setattr__(name, None)
        return None

    def __setattr__(self, name, value):
        if value is None:  # Print a message denoting a placeholder
            print(f"Setting placeholder for {name}")

        self.__dict__[name] = value  # Set the attribute
Intermediate Object-Oriented Programming in Python

Let's practice!

Intermediate Object-Oriented Programming in Python

Preparing Video For Download...