Source Code for Module prompt.help

  1  ############################################################################### 
  2  #                                                                             # 
  3  # Copyright (C) 2003-2012 Edward d'Auvergne                                   # 
  4  #                                                                             # 
  5  # This file is part of the program relax.                                     # 
  6  #                                                                             # 
  7  # relax is free software; you can redistribute it and/or modify               # 
  8  # it under the terms of the GNU General Public License as published by        # 
  9  # the Free Software Foundation; either version 2 of the License, or           # 
 10  # (at your option) any later version.                                         # 
 11  #                                                                             # 
 12  # relax is distributed in the hope that it will be useful,                    # 
 13  # but WITHOUT ANY WARRANTY; without even the implied warranty of              # 
 14  # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               # 
 15  # GNU General Public License for more details.                                # 
 16  #                                                                             # 
 17  # You should have received a copy of the GNU General Public License           # 
 18  # along with relax; if not, write to the Free Software                        # 
 19  # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA   # 
 20  #                                                                             # 
 21  ############################################################################### 
 22   
 23  # Module docstring. 
 24  """The prompt UI help system.""" 
 25   
 26  # Python module imports. 
 27  import pydoc 
 28  import sys 
 29  from textwrap import wrap 
 30   
 31  # relax module imports. 
 32  from status import Status; status = Status() 
 33   
 34   
 35  # Generic string printed out for function classes. 
 36  ################################################## 
 37   
 38  relax_class_help = "This is a python class which contains user functions.  To list these functions, either place a period at the end of class name and hit the tab key, or type 'dir(class_name)'." 
 39   
 40   
 41  # Helper classes. 
 42  ################# 
 43   
 44 -class _Helper: 
 45      text = """\ 
 46  For assistance in using a function, simply type 'help(function)'.  All functions can be viewed by hitting the [TAB] key.  In addition to functions, if 'help(object)' is typed, the help for the python object is returned.  This system is similar to the help function built into the python interpreter, which has been renamed to help_python, with the interactive component removed.  For the interactive python help system, type 'help_python()'. 
 47      """ 
 48   
 49 -    def __repr__(self): 
 50          """String representation of the object. 
 51   
 52          @return:    The help description. 
 53          @rtype:     str 
 54          """ 
 55   
 56          # Wrap the text. 
 57          string = '' 
 58          for line in wrap(self.text, status.text_width): 
 59              string += line + '\n' 
 60   
 61          # Return the wrapped text. 
 62          return string 
 63   
 64   
 65 -    def __call__(self, *args, **kwds): 
 66          """Make the object executable.""" 
 67   
 68          # Catch strange callings of the object. 
 69          if len(args) != 1 or isinstance(args[0], str): 
 70              print((self.text)) 
 71              return 
 72   
 73          # Alias the object. 
 74          obj = args[0] 
 75   
 76          # Automatically create the user function docstring help text, storing it so it only needs to be built once. 
 77          if not hasattr(obj, '__relax_help__') and hasattr(obj, '_build_doc'): 
 78              obj.__relax_help__ = obj._build_doc() 
 79   
 80          # The relax help system. 
 81          if hasattr(obj, '__relax_help__'): 
 82              pydoc.pager(obj.__relax_help__) 
 83              return 
 84   
 85          # Default to the normal Python help system. 
 86          return pydoc.help(*args, **kwds) 
 87   
 88   
 89 -class _Helper_python: 
 90      text = """\ 
 91  For the interactive python help system, type 'help_python()'.  The help_python function is identical 
 92  to the help function built into the normal python interpreter. 
 93      """ 
 94   
 95   
 96 -    def __repr__(self): 
 97          return self.text 
 98   
 99   
100 -    def __call__(self, *args, **kwds): 
101          return pydoc.help(*args, **kwds) 
102