djavu-asus/elpy/rpc-venv/lib/python3.11/site-packages/jedi/api/keywords.py

   1 import pydoc
   2 from contextlib import suppress
   3 from typing import Dict, Optional
   4
   5 from jedi.inference.names import AbstractArbitraryName
   6
   7 try:
   8     from pydoc_data import topics
   9     pydoc_topics: Optional[Dict[str, str]] = topics.topics
  10 except ImportError:
  11     # Python 3.6.8 embeddable does not have pydoc_data.
  12     pydoc_topics = None
  13
  14
  15 class KeywordName(AbstractArbitraryName):
  16     api_type = 'keyword'
  17
  18     def py__doc__(self):
  19         return imitate_pydoc(self.string_name)
  20
  21
  22 def 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 ''