基于BasedPyright实现Python类专属方法与静态专属方法装饰器

在Python类型检查工具BasedPyright项目中，开发者提出了一种实现类专属方法(classonlymethod)和静态专属方法(staticonlymethod)装饰器的创新方案。这类装饰器可以限制方法的使用方式，确保它们只能通过类调用或只能通过静态方式调用。

背景与需求

Python标准库中提供了@classmethod和@staticmethod装饰器，但它们并不限制方法的调用方式。有时我们希望某些方法只能通过类调用（不能通过实例调用），或者只能通过静态调用（不能通过类或实例调用）。这种需求在某些设计模式或API设计中很有价值。

技术实现原理

基于Python的描述符协议(Descriptor Protocol)，我们可以完全在运行时实现这些装饰器，而不需要修改类型检查器(Pyright)的核心逻辑。描述符协议是Python中实现属性访问控制的基础机制，通过实现__get__方法可以自定义属性的访问行为。

类专属方法装饰器实现

类专属方法装饰器(classonlymethod)确保方法只能通过类调用，不能通过实例调用。其核心实现思路是：

1. 在方法被实例访问时抛出异常
2. 在方法被类访问时正常返回绑定方法

这种装饰器对于工厂方法或某些类级别操作非常有用，可以防止误用。

静态专属方法装饰器实现

静态专属方法装饰器(staticonlymethod)则更加严格，它要求方法只能以静态方式调用，既不能通过类调用也不能通过实例调用。实现要点包括：

1. 检查调用方式（通过描述符的__get__方法）
2. 非静态调用时抛出异常
3. 静态调用时正常执行

这种装饰器适合纯工具函数，确保它们不会意外地访问类或实例状态。

优势与价值

这种实现方式有几个显著优势：

1. 完全兼容现有类型检查器，不需要修改Pyright核心
2. 运行时安全，能有效防止API误用
3. 实现简洁，基于Python内置机制
4. 类型提示保持完整，不影响静态分析

应用场景

这类装饰器特别适合以下场景：

• 严格的API设计，防止用户误用
• 框架开发，明确区分不同调用方式
• 代码安全加固，限制敏感操作
• 设计模式实现，如工厂方法

通过这种方式，Python开发者可以在不修改类型检查器的情况下，实现更严格的调用约束，提高代码的健壮性和可维护性。