Coverage for /pythoncovmergedfiles/medio/medio/usr/local/lib/python3.8/site-packages/jedi/api/keywords.py: 34%

1import pydoc 

2from contextlib import suppress 

3from typing import Dict, Optional 

4 

5from jedi.inference.names import AbstractArbitraryName 

6 

7try: 

8 from pydoc_data import topics 

9 pydoc_topics: Optional[Dict[str, str]] = topics.topics 

10except ImportError: 

11 # Python 3.6.8 embeddable does not have pydoc_data. 

12 pydoc_topics = None 

13 

14 

15class KeywordName(AbstractArbitraryName): 

16 api_type = 'keyword' 

17 

18 def py__doc__(self): 

19 return imitate_pydoc(self.string_name) 

20 

21 

22def imitate_pydoc(string): 

23 """ 

24 It's not possible to get the pydoc's without starting the annoying pager 

25 stuff. 

26 """ 

27 if pydoc_topics is None: 

28 return '' 

29 

30 h = pydoc.help 

31 with suppress(KeyError): 

32 # try to access symbols 

33 string = h.symbols[string] 

34 string, _, related = string.partition(' ') 

35 

36 def get_target(s): 

37 return h.topics.get(s, h.keywords.get(s)) 

38 

39 while isinstance(string, str): 

40 string = get_target(string) 

41 

42 try: 

43 # is a tuple now 

44 label, related = string 

45 except TypeError: 

46 return '' 

47 

48 try: 

49 return pydoc_topics[label].strip() if pydoc_topics else '' 

50 except KeyError: 

51 return ''