Python 标准库 inspect 检查对象

import inspect

class Test(object):
    """Test Class doc"""

    def test(self):
        self.fuc = lambda x: x

class Testone(Test):
    pass

# 是不是一个类？
inspect.isclass(Test) # True
# 类的文档
inspect.getdoc(Test) # Test Class doc
# 是不是一个函数
inspect.isfunction(Test.test) # True
# 查看对象可调用的成员
inspect.getmembers(Test, callable)

# 栈调用信息
inspect.stack()[0][3]

# 通过输入一个路径返回模块名称
path = "D:\py\my.py"
path = "D:\py"
path = 'hom/my.py'
inspect.getmodulename(path)

# 查看函数的路径
inspect.getabsfile(pd.Series)
# 查看函数代码
print(inspect.getsource(pd.Series.sum))

# 查看函数参数
inspect.getfullargspec(pd.Series.sum)
'''
FullArgSpec(args=['self', 'axis', 'skipna', 'level',
'numeric_only', 'min_count'],
varargs=None, varkw='kwargs',
defaults=(None, None, None, None, 0),
kwonlyargs=[], kwonlydefaults=None,
annotations={})
'''
# 查看类的参数，括号也可写（模块.类.__init__）
inspect.getfullargspec(pd.Series)

inspect.ismodule(object) # 是否为模块
inspect.isclass(object) # 是否为类
# 是否为方法（bound method written in python）
inspect.ismethod(object)
# 是否为函数(包括 lambda 表达式)
inspect.isfunction(object)
# 是否为python生成器函数
inspect.isgeneratorfunction(object)
inspect.isgenerator(object) # 是否为生成器
inspect.istraceback(object) # 是否为 traceback
inspect.isframe(object) # frame
inspect.iscode(object) # 是否为 code
# 是否为 built-in 函数或 built-in 方法
inspect.isbuiltin(object)
# 是否为用户自定义或者built-in函数或方法
inspect.isroutine(object)
inspect.isabstract(object) # 是否为抽象基类
inspect.ismethoddescriptor(object) # 是否为方法标识符
# 是否为数字标识符，数字标识符有__get__ 和__set__属性
# 通常也有__name__和__doc__属性
inspect.isdatadescriptor(object)
# 是否为 getset descriptor
inspect.isgetsetdescriptor(object)
# 是否为member descriptor
inspect.ismemberdescriptor(object)

import pandas as pd
from inspect import signature

# 可调用检测
callable(pd.Series) # True
# 定义一个签名对象
sig = signature(pd.Series)

sig.parameters # 参数
'''
mappingproxy({'data': <Parameter "data=None">,
              'index': <Parameter "index=None">,
              'dtype': <Parameter "dtype=None">,
              'name': <Parameter "name=None">,
              'copy': <Parameter "copy=False">,
              'fastpath': <Parameter "fastpath=False">})
'''
str(sig) # 转为字符查看
# '(data=None, index=None, dtype=None,
# name=None, copy=False, fastpath=False)'

# 指定参数的 Parameter 对象字符串
sig.parameters['copy'].__str__()
# 'copy=False'

# 指定参数的注解
sig.parameters['data'].annotation
# inspect._empty

# 以下是 <Parameter "xxx"> 参数对象的属性
# 没有默认值时
sig.parameters['copy'].empty # inspect._empty
# 参数名称
sig.parameters['copy'].name # 'copy'
# 默认值
sig.parameters['copy'].default # False
# 参数注解
sig.parameters['copy'].annotation # inspect._empty
# 参数的类型
sig.parameters['copy'].kind
# <_ParameterKind.POSITIONAL_OR_KEYWORD: 1>

# 参数的类型有以下几种
'''
POSITIONAL_ONLY	只能作为位置参数
POSITIONAL_OR_KEYWORD	位置参数或关键字参数
VAR_POSITIONAL	*args，传入后会以元组的形式展现
KEYWORD_ONLY	只能作为关键字参数
VAR_KEYWORD	**kwargs，传入会以字典的形式展现
'''

# 绑定
res = sig.bind(data=0, name='hello')
res
# <BoundArguments (data=0, index=None, dtype=None,
# name='hello', copy=False, fastpath=False)>

res.arguments # 参数
'''
OrderedDict([('data', 0),
             ('index', None),
             ('dtype', None),
             ('name', 'hello'),
             ('copy', False),
             ('fastpath', False)])
'''

res.args # 位置参数值构成的元组
# (0,)
# res.kwargs # 关键字参数值构成
{'name': 'hello'}
res.signature # 签名对象
# <Signature (data=None, index=None, dtype=None,
# name=None, copy=False, fastpath=False)>
res.apply_defaults() # 为缺少的参数设置默认值
'''
将 BoundArguments 中没有专门设置的 argument 设置为默认参数:
- *args的默认值为空元组。
- **kwargs的默认值为空字典。
'''

# 绑定
ba = sig.bind(data=[1,2,3,4])
# 应用到函数
pd.Series(*ba.args, **ba.kwargs)
'''
0    1
1    2
2    3
3    4
dtype: int64
'''