【Python】笔记：接口：从协议到抽象基类

S11 接口：从协议到抽象基类

1. # random.shuffle 就地打乱
2. from random import shuffle
4. l = list(range(10))
5. shuffle(l)
6. print(l)
7. shuffle(l)
8. print(l)

复制代码

1. [0, 6, 3, 2, 4, 8, 5, 7, 1, 9]
2. [0, 5, 9, 7, 6, 2, 4, 8, 1, 3]

复制代码

猴子补丁

1. import collections
3. Card = collections.namedtuple('Card', 'rank suit')
5. class FrenchDeck:
7.     ranks = [str(n) for n in range(2, 11)] + list('JQKA')
8.     suits = 'spades diamondes clubs hearts'.split()
10.     def __init__(self):
11.         self._cards = [Card(rank, suit) for suit in self.suits
12.                                         for rank in self.ranks]
14.     def __len__(self):
15.         return len(self._cards)
17.     def __getitem__(self, position):
18.         return self._cards[position]

复制代码

1. # target: 洗牌
2. deck = FrenchDeck()
3. shuffle(deck)

复制代码

1. ---------------------------------------------------------------------------
3. TypeError                                 Traceback (most recent call last)
5. Cell In [4], line 3
6.       1 # target: 洗牌
7.       2 deck = FrenchDeck()
8. ----> 3 shuffle(deck)
11. File c:\Users\qiany\AppData\Local\Programs\Python\Python39\lib\random.py:362, in Random.shuffle(self, x, random)
12.     359     for i in reversed(range(1, len(x))):
13.     360         # pick an element in x[:i+1] with which to exchange x[i]
14.     361         j = randbelow(i + 1)
15. --> 362         x[i], x[j] = x[j], x[i]
16.     363 else:
17.     364     _warn('The *random* parameter to shuffle() has been deprecated\n'
18.     365           'since Python 3.9 and will be removed in a subsequent '
19.     366           'version.',
20.     367           DeprecationWarning, 2)
23. TypeError: 'FrenchDeck' object does not support item assignment

复制代码

1. # 打补丁
2. def set_card(deck, position, card):
3.     deck._cards[position] = card
5. FrenchDeck.__setitem__ = set_card
6. shuffle(deck)
7. print(deck[:5])

复制代码

1. [Card(rank='9', suit='spades'), Card(rank='2', suit='spades'), Card(rank='5', suit='spades'), Card(rank='Q', suit='clubs'), Card(rank='10', suit='hearts')]

复制代码

定义抽象基类的子类

1. import collections
3. Card = collections.namedtuple('Card', 'rank suit')
5. class FrenchDeck2(collections.MutableSequence):
7.     ranks = [str(n) for n in range(2, 11)] + list('JQKA')
8.     suits = 'spades diamondes clubs hearts'.split()
10.     def __init__(self):
11.         self._cards = [Card(rank, suit) for suit in self.suits
12.                                         for rank in self.ranks]
14.     def __len__(self):
15.         return len(self._cards)
17.     def __getitem__(self, position):
18.         return self._cards[position]
20.     def __setitem__(self, position, value):  # 欲实现 shuffle 须实现 __setitem__
21.         self._cards[position] = value
23.     def __delitem__(self, position):
24.         del self._cards[position]
26.     def insert(self, position, value):
27.         self._cards.insert(position, value)

复制代码

继承 MutableSequence 必须实现 __delitem__, insert
FrenchDeck2

• 从 Sequence        继承了 __contains__, __iter__, __reversed__, index, count
  
• 从 MutableSequence 继承了 append, extend, pop, remove, __iadd__
  

标准库中的抽象基类

collections.abs
第一层:

• Iterable : Sequence, Mapping, Set, Iterator     通过 __iter__ 方法支持迭代
  
• Container: Sequence, Mapping, Set                 通过 __contains__ 方法支持 in
  
• Sized    : Sequence, Mapping, Set, MappingView  通过 __len__ 方法支持 len()
  
• Callable : (None)
  
• Hashable : (None)
  

第二层:

• Sequence    : MutableSequence
  
• Mapping     : MutableMapping
  
• Set         : MutableSet, ItemsView, KeysView
  
• MappingView : ItemsView, KeysView, ValuesView
  

numbers

• Number
  
• Complex
  
• Real
  
• Rational
  
• Intergal
  

eg. 检查一个数是否为整数: isinstance(x, numbers.Integral)
isinstance(x, type)

• type 为 Intergal 检查 int, bool
  
• type 为 Real     检查 int, bool, float, fractions.Fraction, Numpy中相关对象
  

检查对象是否可以被 调用, 可用 callable()
检查对象是否可以被 散列, 可用 isinstance(obj, Hashable)

1. import numbers
3. print(1, isinstance(233, numbers.Integral))
4. print(2, isinstance(233.33, numbers.Integral))
5. print(3, isinstance(233.00, numbers.Integral))
6. print(4, isinstance(True, numbers.Integral))
7. print(5, isinstance(False, numbers.Integral))

复制代码

1. True
2. False
3. False
4. True
5. True

复制代码

定义并使用一个抽象基类

Tombola:

• 抽象方法:
  
  
  
  • load()
    
  • pick()
    
  
  
• 具体方法:
  
  
  
  • loaded()
    
  • inspect()
    
  
  

1. import abc
3. class Tombola(abc.ABC):
5.     @abc.abstractclassmethod  # 一般 abstractclassmethod 只有 文档字符串
6.     def load(self, iterable):
7.         '''可从迭代对象中添加元素'''
9.     @abc.abstractclassmethod
10.     def pick(self):
11.         '''随机删除元素并返回
12.         若果实例为空, 抛出 LookupError'''
13.    
14.     def loaded(self):  # 抽象基类可以包含具体实现方法
15.         '''是否有元素'''
16.         return bool(self.inspect())  # 抽象基类中的具体方法 只能依赖基类定义的接口（即该抽象基类中其他具体方法、抽象方法、特征）
18.     def inspect(self):
19.         '''返回一个由当前元素构成的有序元组'''
21.         items = []
22.         while True:
23.             try:
24.                 items.append(self.pick())
25.             except LookupError:
26.                 break
27.         self.load(items)
28.         return tuple(sorted(items))

复制代码

抽象方法可以有实现代码（不仅局限于文档字符串）
但即使实现了，子类 必须 覆盖抽象方法
或者用 super() 函数调用抽象方法
注: @abc.abstractmethod 和其他修饰器连用时, @abc.abstractmethod 应放在最内层

1. # 不符合 Tombola 的子类
2. class Fake(Tombola):
3.     def pick(self):
4.         return 13
6. f = Fake()

复制代码

1. ---------------------------------------------------------------------------
3. TypeError                                 Traceback (most recent call last)
5. Cell In [13], line 6
6.       3     def pick(self):
7.       4         return 13
8. ----> 6 f = Fake()
11. TypeError: Can't instantiate abstract class Fake with abstract method load

复制代码

1. # Tombola 的子类 BingoCage
3. import random
4. class BingoCage(Tombola):
6.     def __init__(self, items):
7.         self._randomizer = random.SystemRandom()  # 调用 os.random() 函数, 生成"适合加密"的随机字节序列
8.         self._items = []
9.         self.load(items)  # 委托 load 初始化
11.     def load(self, items):
12.         self._items.extend(items)
13.         self._randomizer.shuffle(self._items)  # 打乱
15.     def pick(self):
16.         try:
17.             return self._items.pop()
18.         except IndexError:
19.             raise LookupError('pick from empty BingoCage')
21.     def __call__(self):
22.         self.pick()

复制代码

1. class LotteryBlower(Tombola):
3.     def __init__(self, iterable):
4.         self._balls = list(iterable)
6.     def load(self, iterable):
7.         self._balls.extend(iterable)
9.     def pick(self):
10.         try:
11.             position = random.randrange(len(self._balls))
12.         except IndexError:
13.             raise LookupError('pick from empty LotteryBlower')
14.         return self._balls.pop(position)
16.     def loaded(self):  # 重写 loaded
17.         return bool(self._balls)
18.    
19.     def inspect(self):
20.         return tuple(sorted(self._balls))

复制代码

虚拟子类

注册虚拟子类 在抽象基类上调用 register 方法, 这样, issubclass 和 isinstance 都能识别
但 注册的类 不会从抽象基类中继承如何方法或属性

1. @Tombola.register  # 注册为 Tombola 的 虚拟子类
2. class TomboList(list):  # 继承 list
3.     def pick(self):
4.         if self:  # 是否为空
5.             position = random.randrange(len(self))
6.             return self.pop(position)
7.         else:
8.             raise LookupError('pop from empty TomboList')
10.     load = list.extend
12.     def loaded(self):
13.         return bool(self)
14.    
15.     def inspect(self):
16.         return tuple(sorted(self))

复制代码

1. print(1, issubclass(TomboList, Tombola))
3. t = TomboList(range(100))
4. print(2, isinstance(t, Tombola))
6. print(3, TomboList.__mro__)  # 按顺序列出类及其超类

复制代码

1. 1 True
2. 2 True
3. 3 (<class '__main__.TomboList'>, <class 'list'>, <class 'object'>)

复制代码

__subclasses__ 返回类的直接子类列表, 不包含虚拟子类
_abc_registry  只有抽象基类有整个属性(一个WeakSet对象)

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！