测试开发技术网站

[TOC]

![](https://redrose2100.oss-cn-hangzhou.aliyuncs.com/img/7cd47362-951c-11ee-986a-0242ac110004.png)

在应用中，add_hookspecs的应用代码如下，即将MySpec类作为参数传递给add_hookspecs方法。
```python
pm.add_hookspecs(MySpec)
```
add_hookspecs方法的定义如下，因此这里形参module_or_class即是MySpec类，因此这里的for循环，相当于是遍历MySpec类的方法和属性。从最外层的for循环和与for循环同层级的if语句可以看出，for循环就是通过对传进来的MySpec类的方法和属性进行遍历，对于符合要求的放入names列表，最后判断如果names为空，即没有找到符合要求的方法或属性，则抛出一个异常，而到底什么样的才是符合要求的，则需继续分析spec_opts变量获取到的值。
```python
    def add_hookspecs(self, module_or_class):
        """add new hook specifications defined in the given  ``module_or_class``.
        Functions are recognized if they have been decorated accordingly."""
        names = []
        for name in dir(module_or_class):
            spec_opts = self.parse_hookspec_opts(module_or_class, name)
            if spec_opts is not None:
                hc = getattr(self.hook, name, None)
                if hc is None:
                    hc = _HookCaller(name, self._hookexec, module_or_class, spec_opts)
                    setattr(self.hook, name, hc)
                else:
                    # plugins registered this hook without knowing the spec
                    hc.set_specification(module_or_class, spec_opts)
                    for hookfunction in hc.get_hookimpls():
                        self._verify_hook(hc, hookfunction)
                names.append(name)

if not names:
            raise ValueError(
                f"did not find any {self.project_name!r} hooks in {module_or_class!r}"
            )
```
spec_opts变量是通过parse_hookspec_opts方法来获取值的，而此方法的实现如下，这里看出来，首先是根据方法或属性名获取到方法或属性对象，然后将该对象的myproject_spec属性的值返回，通过前面解析HookspecMarker类的时候我们知道，在定义MySpec类中的myhook方法是使用了一个装饰器，而此装饰器就是增加myproject_spec属性的。至此就得到了对应，因此，parse_hookspec_opts方法作用就很明显了，即获取对象的myproject_spec属性的值，如果没有此属性，则返回None
```python
    def parse_hookspec_opts(self, module_or_class, name):
        method = getattr(module_or_class, name)
        return getattr(method, self.project_name + "_spec", None)
```
再返回到add_hookspecs方法，这里可以看到，如果spec_opts是None的话，直接跳过了，只有spec_opts不是None的时候才进行进一步的处理，换句话说就是MySpec的所有的方法和属性中，只有被hookspec装饰器装饰了的函数，才进行进一步处理，而在前面也已经分析过，MySpec类中myhook方法使用了装饰器后，就拥有了myproject_spec属性，属性值是一个字典。而且字典中拥有firstresult，historic，warn_on_impl三个key，下面hc变量通过从self.hook对象中取myhook属性，在PluginManager类初始化的时候，我们知道，self.hook被初始化为_HookRelay类的一个实例，但是此类没有定义任何属性和方法，因此这里的hc显然为None，接下来可以看到当hc为None时，hc则给初始化为_HookCaller类的一个实例，_HookCaller类的初始化实现代码如下，那么可以看到，这里的name就是注册的接口名myhook，这里的_hookexec就是PluginManager类中的_inner_hookexec也就是_multicall函数，而specmodule_or_class则是传递进来的MySpec类，显然不是None，以你次又继续调用specification方法。
```python
class _HookCaller:
    def __init__(self, name, hook_execute, specmodule_or_class=None, spec_opts=None):
        self.name = name
        self._wrappers = []
        self._nonwrappers = []
        self._hookexec = hook_execute
        self._call_history = None
        self.spec = None
        if specmodule_or_class is not None:
            assert spec_opts is not None
            self.set_specification(specmodule_or_class, spec_opts)
```
set_specification方法定义代码如下，这里相当于是给_HookCaller类的spec属性赋值了一个HookSpec类的实例化对象，而且判断spec_opts中historic是否为True，如果为True，则将_HookCaller类的_call_history属性初始化为空列表。
```python
    def set_specification(self, specmodule_or_class, spec_opts):
        assert not self.has_spec()
        self.spec = HookSpec(specmodule_or_class, self.name, spec_opts)
        if spec_opts.get("historic"):
            self._call_history = []
```
HookSpec类的定义如下，这里可以理解为一个原子类型的类了，即此类中namespace是MySpec类，name则是定义的接口名myhook，function则是myhook方法对象，opts则是包含firstresult，historic，warn_on_impl三个key字典，argnames和kwargnames则是myhook函数的参数，warn_on_impl则是opts中的warn_on_impl属性值。
```python
class HookSpec:
    def __init__(self, namespace, name, opts):
        self.namespace = namespace
        self.function = function = getattr(namespace, name)
        self.name = name
        self.argnames, self.kwargnames = varnames(function)
        self.opts = opts
        self.warn_on_impl = opts.get("warn_on_impl")
```
再回到add_hookspecs方法中，即此时hc已经赋值了，即hc是_HookCaller类的一个实例对象，然后下面一行代码怎是self.hook设置一个属性和值了，即是给_HookRelay类的实例对象self.hook设置属性myhook，值为hc对象。
```python
setattr(self.hook, name, hc)
```
当然如果hc不为空，则直接更新属性了。
至此，add_hookspecs方法就分析完成了。

测试开发技术网站

博客