| # Copyright 2016 Julien Danjou | |
| # Copyright 2016 Joshua Harlow | |
| # Copyright 2013-2014 Ray Holder | |
| # | |
| # Licensed under the Apache License, Version 2.0 (the "License"); | |
| # you may not use this file except in compliance with the License. | |
| # You may obtain a copy of the License at | |
| # | |
| # http://www.apache.org/licenses/LICENSE-2.0 | |
| # | |
| # Unless required by applicable law or agreed to in writing, software | |
| # distributed under the License is distributed on an "AS IS" BASIS, | |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
| # See the License for the specific language governing permissions and | |
| # limitations under the License. | |
| import sys | |
| import typing | |
| # sys.maxsize: | |
| # An integer giving the maximum value a variable of type Py_ssize_t can take. | |
| MAX_WAIT = sys.maxsize / 2 | |
| def find_ordinal(pos_num: int) -> str: | |
| # See: https://en.wikipedia.org/wiki/English_numerals#Ordinal_numbers | |
| if pos_num == 0: | |
| return "th" | |
| elif pos_num == 1: | |
| return "st" | |
| elif pos_num == 2: | |
| return "nd" | |
| elif pos_num == 3: | |
| return "rd" | |
| elif 4 <= pos_num <= 20: | |
| return "th" | |
| else: | |
| return find_ordinal(pos_num % 10) | |
| def to_ordinal(pos_num: int) -> str: | |
| return f"{pos_num}{find_ordinal(pos_num)}" | |
| def get_callback_name(cb: typing.Callable[..., typing.Any]) -> str: | |
| """Get a callback fully-qualified name. | |
| If no name can be produced ``repr(cb)`` is called and returned. | |
| """ | |
| segments = [] | |
| try: | |
| segments.append(cb.__qualname__) | |
| except AttributeError: | |
| try: | |
| segments.append(cb.__name__) | |
| except AttributeError: | |
| pass | |
| if not segments: | |
| return repr(cb) | |
| else: | |
| try: | |
| # When running under sphinx it appears this can be none? | |
| if cb.__module__: | |
| segments.insert(0, cb.__module__) | |
| except AttributeError: | |
| pass | |
| return ".".join(segments) | |