类方法

'''
类方法（Class Methods）是定义在类上的方法，而不是实例对象上的方法。它可以通过类名直接调用，也可以通过实例对象调用.
1. 定义类方法：
    1. 类方法使用@classmethod装饰器来标识。
    2. 类方法的第一个参数通常被命名为cls，表示类本身，而不是实例对象。
    3. 类方法可以访问类的属性和其他类方法。

2. 最佳实践：
    1. 类方法适合用于操作类级别的数据，而不是实例级别的数据。
    2. 类方法通常用于创建替代构造函数、提供类级别的功能和辅助方法。

3. 使用场景：
    1. 替代构造函数（Alternative Constructors）：
        1. 类方法可以用于创建对象的替代方式，以提供更灵活的对象实例化选项。
        2. 通过类方法，可以接收不同类型的参数，并返回已经初始化好的对象。
        3. 这对于处理复杂的对象创建逻辑或者提供多种初始化方式非常有用。

    2. 工厂方法（Factory Methods）：
        1. 类方法可以作为工厂方法，用于生成其他类的实例。
        2. 工厂方法可以封装复杂的对象创建过程，隐藏具体的实现细节。
        3. 这对于创建和管理相关对象的集合、实现单例模式等非常有用。

    3. 类级别的操作和功能（Class-Level Operations and Functionality）：
        1. 类方法可以访问类的属性和其他类方法，因此可以用于执行与整个类相关的操作。
        2. 例如，可以在类方法中实现对类属性的修改、计算或验证。
        3. 这对于在类级别上进行统一的操作或提供特定的功能非常有用。

    4. 辅助方法（Utility Methods）：
        1. 类方法可以作为辅助方法，用于提供额外的功能或帮助函数。
        2. 这些方法可能与类的主要功能不直接相关，但可以在类的上下文中起到辅助的作用。
        3. 这对于实现特定的逻辑、处理数据转换或执行其他实用程序任务非常有用。
总的来说，类方法的使用场景是在需要操作类级别的数据、提供额外的对象创建选项、实现辅助功能或隐藏复杂对象创建逻辑时非常有用。通过使用类方法，可以提高代码的灵活性、可读性和可维护性。

4. 坑：
    1. 在类方法中无法直接访问实例属性，因为类方法是与类相关联的，而不是与实例对象相关联的。
    2. 如果需要在类方法中访问实例属性，可以将实例对象作为参数传递给类方法。
'''

# 1. 语法
class MyClass:
    class_attribute = "This is a class attribute"

    @classmethod
    def class_method(cls):
        print("This is a class method")
        print(cls.class_attribute)  # 访问类属性

# 调用类方法：类名.方法名()
MyClass.class_method()  # This is a class attribute

# 2. 最佳实践
import datetime

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

    @classmethod
    def from_birth_year(cls, name, birth_year):
        current_year = datetime.datetime.now().year
        age = current_year - birth_year
        birth_date = datetime.date(current_year, 1, 1) - datetime.timedelta(days=age*365)
        return cls(name, birth_date)

# 使用类方法创建对象
person = Person.from_birth_year("Allen", 1990)
print(person.name)  # Allen
print(person.birth_date)  # 1990-01-09

# 4. 坑: 如果想在类方法中使用实例方法，就必须把实例对象作为实参传给类方法
class MyClass:
    instance_attribute = "This is an instance attribute"

    def __init__(self):
        self.instance_attribute = "This is an instance attribute"

    @classmethod
    def class_method(cls, obj):
        print(obj.instance_attribute)  # 访问实例属性

# 实例化对象并调用类方法
obj = MyClass()
MyClass.class_method(obj)  # This is an instance attribute