A buffer of pending messages.
| 753 | |
| 754 | |
| 755 | class Messagebuffer(Evictable): |
| 756 | """A buffer of pending messages.""" |
| 757 | |
| 758 | Empty = Empty |
| 759 | |
| 760 | def __init__(self, maxsize, iterable=None, deque=deque): |
| 761 | # type: (int, Iterable, Any) -> None |
| 762 | self.maxsize = maxsize |
| 763 | self.data = deque(iterable or []) |
| 764 | self._append = self.data.append |
| 765 | self._pop = self.data.popleft |
| 766 | self._len = self.data.__len__ |
| 767 | self._extend = self.data.extend |
| 768 | |
| 769 | def put(self, item): |
| 770 | # type: (Any) -> None |
| 771 | self._append(item) |
| 772 | self.maxsize and self._evict() |
| 773 | |
| 774 | def extend(self, it): |
| 775 | # type: (Iterable) -> None |
| 776 | self._extend(it) |
| 777 | self.maxsize and self._evict() |
| 778 | |
| 779 | def take(self, *default): |
| 780 | # type: (*Any) -> Any |
| 781 | try: |
| 782 | return self._pop() |
| 783 | except IndexError: |
| 784 | if default: |
| 785 | return default[0] |
| 786 | raise self.Empty() |
| 787 | |
| 788 | def _pop_to_evict(self): |
| 789 | # type: () -> None |
| 790 | return self.take() |
| 791 | |
| 792 | def __repr__(self): |
| 793 | # type: () -> str |
| 794 | return f'<{type(self).__name__}: {len(self)}/{self.maxsize}>' |
| 795 | |
| 796 | def __iter__(self): |
| 797 | # type: () -> Iterable |
| 798 | while 1: |
| 799 | try: |
| 800 | yield self._pop() |
| 801 | except IndexError: |
| 802 | break |
| 803 | |
| 804 | def __len__(self): |
| 805 | # type: () -> int |
| 806 | return self._len() |
| 807 | |
| 808 | def __contains__(self, item) -> bool: |
| 809 | return item in self.data |
| 810 | |
| 811 | def __reversed__(self): |
| 812 | # type: () -> Iterable |
no outgoing calls