diff -r 1779dc278077 -r 391d6b7b1eff eric6/Documentation/Source/eric6.DebugClients.Python.FlexCompleter.html --- a/eric6/Documentation/Source/eric6.DebugClients.Python.FlexCompleter.html Wed Sep 25 19:40:31 2019 +0200 +++ b/eric6/Documentation/Source/eric6.DebugClients.Python.FlexCompleter.html Wed Sep 25 19:42:44 2019 +0200 @@ -18,32 +18,42 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>eric6.DebugClients.Python.FlexCompleter</h1> + <p> Word completion for the eric6 shell. -</p><p> +</p> +<p> <h4>NOTE for eric6 variant</h4> -</p><p> +</p> +<p> This version is a re-implementation of rlcompleter as found in the Python3 library. It is modified to work with the eric6 debug clients. -</p><p> +</p> +<p> <h4>Original rlcompleter documentation</h4> -</p><p> +</p> +<p> This requires the latest extension to the readline module. The completer completes keywords, built-ins and globals in a selectable namespace (which defaults to __main__); when completing NAME.NAME..., it evaluates (!) the expression up to the last dot and completes its attributes. -</p><p> +</p> +<p> It's very cool to do "import sys" type "sys.", hit the completion key (twice), and see the list of names defined by the sys module! -</p><p> +</p> +<p> Tip: to use the tab key as the completion key, call -</p><p> +</p> +<p> readline.parse_and_bind("tab: complete") -</p><p> +</p> +<p> <b>Notes</b>: <ul> <li> @@ -68,162 +78,213 @@ </ul> </p> <h3>Global Attributes</h3> + <table> <tr><td>__all__</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#Completer">Completer</a></td> <td>Class implementing the command line completer object.</td> </tr> </table> <h3>Functions</h3> + <table> + <tr> <td><a href="#get_class_members">get_class_members</a></td> <td>Module function to retrieve the class members.</td> </tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="Completer" ID="Completer"></a> <h2>Completer</h2> + <p> Class implementing the command line completer object. </p> <h3>Derived from</h3> object <h3>Class Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Class Methods</h3> + <table> <tr><td>None</td></tr> </table> <h3>Methods</h3> + <table> + <tr> <td><a href="#Completer.__init__">Completer</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#Completer._callable_postfix">_callable_postfix</a></td> <td>Protected method to check for a callable.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Completer.attr_matches">attr_matches</a></td> <td>Public method to compute matches when text contains a dot.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Completer.complete">complete</a></td> <td>Public method to return the next possible completion for 'text'.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Completer.global_matches">global_matches</a></td> <td>Public method to compute matches when text is a simple name.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="Completer.__init__" ID="Completer.__init__"></a> <h4>Completer (Constructor)</h4> <b>Completer</b>(<i>namespace=None</i>) + <p> Constructor -</p><p> +</p> +<p> Completer([namespace]) -> completer instance. -</p><p> +</p> +<p> If unspecified, the default namespace where completions are performed is __main__ (technically, __main__.__dict__). Namespaces should be given as dictionaries. -</p><p> +</p> +<p> Completer instances should be used as the completion mechanism of readline via the set_completer() call: -</p><p> +</p> +<p> readline.set_completer(Completer(my_namespace).complete) -</p><dl> +</p> +<dl> + <dt><i>namespace</i></dt> <dd> The namespace for the completer. </dd> -</dl><dl> +</dl> +<dl> + <dt>Raises <b>TypeError</b>:</dt> <dd> raised to indicate a wrong data structure of the namespace object </dd> -</dl><a NAME="Completer._callable_postfix" ID="Completer._callable_postfix"></a> +</dl> +<a NAME="Completer._callable_postfix" ID="Completer._callable_postfix"></a> <h4>Completer._callable_postfix</h4> <b>_callable_postfix</b>(<i>val, word</i>) + <p> Protected method to check for a callable. -</p><dl> +</p> +<dl> + <dt><i>val</i></dt> <dd> value to check (object) -</dd><dt><i>word</i></dt> +</dd> +<dt><i>word</i></dt> <dd> word to ammend (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> ammended word (string) </dd> -</dl><a NAME="Completer.attr_matches" ID="Completer.attr_matches"></a> +</dl> +<a NAME="Completer.attr_matches" ID="Completer.attr_matches"></a> <h4>Completer.attr_matches</h4> <b>attr_matches</b>(<i>text</i>) + <p> Public method to compute matches when text contains a dot. -</p><p> +</p> +<p> Assuming the text is of the form NAME.NAME....[NAME], and is evaluatable in self.namespace, it will be evaluated and its attributes (as revealed by dir()) are used as possible completions. (For class instances, class members are are also considered.) -</p><p> +</p> +<p> <b>WARNING</b>: this can still invoke arbitrary C code, if an object with a __getattr__ hook is evaluated. -</p><dl> +</p> +<dl> + <dt><i>text</i></dt> <dd> The text to be completed. (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> A list of all matches. </dd> -</dl><a NAME="Completer.complete" ID="Completer.complete"></a> +</dl> +<a NAME="Completer.complete" ID="Completer.complete"></a> <h4>Completer.complete</h4> <b>complete</b>(<i>text, state</i>) + <p> Public method to return the next possible completion for 'text'. -</p><p> +</p> +<p> This is called successively with state == 0, 1, 2, ... until it returns None. The completion should begin with 'text'. -</p><dl> +</p> +<dl> + <dt><i>text</i></dt> <dd> The text to be completed. (string) -</dd><dt><i>state</i></dt> +</dd> +<dt><i>state</i></dt> <dd> The state of the completion. (integer) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> The possible completions as a list of strings. </dd> -</dl><a NAME="Completer.global_matches" ID="Completer.global_matches"></a> +</dl> +<a NAME="Completer.global_matches" ID="Completer.global_matches"></a> <h4>Completer.global_matches</h4> <b>global_matches</b>(<i>text</i>) + <p> Public method to compute matches when text is a simple name. -</p><dl> +</p> +<dl> + <dt><i>text</i></dt> <dd> The text to be completed. (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> A list of all keywords, built-in functions and names currently @@ -231,18 +292,23 @@ </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="get_class_members" ID="get_class_members"></a> <h2>get_class_members</h2> <b>get_class_members</b>(<i>klass</i>) + <p> Module function to retrieve the class members. -</p><dl> +</p> +<dl> + <dt><i>klass</i></dt> <dd> The class object to be analysed. </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> A list of all names defined in the class.