Python Google风格注释的使用

def add(a, b):
    """Adds two numbers together.

    Args:
        a: The first number.
        b: The second number.

    Returns:
        The sum of a and b.
    """
    return a + b

class Person:
    """A class representing a person.

    Attributes:
        name (str): The person's name.
        age (int): The person's age.
        gender (str): The person's gender.
    """

    def __init__(self, name, age, gender):
        """Initializes a new Person object.

        Args:
            name (str): The person's name.
            age (int): The person's age.
            gender (str): The person's gender.
        """
        self.name = name
        self.age = age
        self.gender = gender

    def get_name(self):
        """Returns the person's name."""
        return self.name

    def get_age(self):
        """Returns the person's age."""
        return self.age

    def get_gender(self):
        """Returns the person's gender."""
        return self.gender

    def set_name(self, name):
        """Sets the person's name.

        Args:
            name (str): The person's new name.
        """
        self.name = name

    def set_age(self, age):
        """Sets the person's age.

        Args:
            age (int): The person's new age.
        """
        self.age = age

    def set_gender(self, gender):
        """Sets the person's gender.

        Args:
            gender (str): The person's new gender.
        """
        self.gender = gender