1#!/usr/bin/env python3 2# 3# Copyright (c) 2020, The OpenThread Authors. 4# All rights reserved. 5# 6# Redistribution and use in source and binary forms, with or without 7# modification, are permitted provided that the following conditions are met: 8# 1. Redistributions of source code must retain the above copyright 9# notice, this list of conditions and the following disclaimer. 10# 2. Redistributions in binary form must reproduce the above copyright 11# notice, this list of conditions and the following disclaimer in the 12# documentation and/or other materials provided with the distribution. 13# 3. Neither the name of the copyright holder nor the 14# names of its contributors may be used to endorse or promote products 15# derived from this software without specific prior written permission. 16# 17# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 18# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE 21# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27# POSSIBILITY OF SUCH DAMAGE. 28# 29import functools 30from typing import Union, Collection, Any, Pattern 31 32 33def match_line(line: str, expect_line: Union[str, Pattern, Collection[Any]]) -> bool: 34 """Checks if a line is expected (matched by one of the given patterns).""" 35 if isinstance(expect_line, Pattern): 36 match = expect_line.match(line) 37 elif isinstance(expect_line, str): 38 match = (line == expect_line) 39 else: 40 match = any(match_line(line, x) for x in expect_line) 41 42 return match 43 44 45def cached(func): 46 """Decorator cached makes the function to cache its result and return it in duplicate calls.""" 47 prop_name = '__cached_' + func.__name__ 48 49 @functools.wraps(func) 50 def _cached_func(self): 51 try: 52 return getattr(self, prop_name) 53 except AttributeError: 54 val = func(self) 55 setattr(self, prop_name, val) 56 return val 57 58 return _cached_func 59 60 61def constant_property(func): 62 """A constant property is a property that only evaluated once.""" 63 return property(cached(func)) 64