--- a/eric6/Documentation/Source/eric6.QScintilla.SpellChecker.html Wed Sep 25 19:40:31 2019 +0200 +++ b/eric6/Documentation/Source/eric6.QScintilla.SpellChecker.html Wed Sep 25 19:42:44 2019 +0200 @@ -18,528 +18,703 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>eric6.QScintilla.SpellChecker</h1> + <p> Module implementing the spell checker for the editor component. -</p><p> +</p> +<p> The spell checker is based on pyenchant. </p> <h3>Global Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#SpellChecker">SpellChecker</a></td> <td>Class implementing a pyenchant based spell checker.</td> </tr> </table> <h3>Functions</h3> + <table> <tr><td>None</td></tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="SpellChecker" ID="SpellChecker"></a> <h2>SpellChecker</h2> + <p> Class implementing a pyenchant based spell checker. </p> <h3>Derived from</h3> QObject <h3>Class Attributes</h3> + <table> <tr><td>_spelling_dict</td></tr><tr><td>_spelling_lang</td></tr> </table> <h3>Class Methods</h3> + <table> + <tr> <td><a href="#SpellChecker._getDict">_getDict</a></td> <td>Protected class method to get a new dictionary.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.getAvailableLanguages">getAvailableLanguages</a></td> <td>Class method to get all available languages.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.getDefaultPath">getDefaultPath</a></td> <td>Class method to get the default path names of the user dictionaries.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.getUserDictionaryPath">getUserDictionaryPath</a></td> <td>Class method to get the path name of a user dictionary file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.isAvailable">isAvailable</a></td> <td>Class method to check, if spellchecking is available.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.setDefaultLanguage">setDefaultLanguage</a></td> <td>Class method to set the default language.</td> </tr> </table> <h3>Methods</h3> + <table> + <tr> <td><a href="#SpellChecker.__init__">SpellChecker</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.__checkDocumentPart">__checkDocumentPart</a></td> <td>Private method to check some part of the document.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.__getNextWord">__getNextWord</a></td> <td>Private method to get the next word in the text after the given position.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.__incrementalCheck">__incrementalCheck</a></td> <td>Private method to check the document incrementally.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.__iter__">__iter__</a></td> <td>Special method to create an iterator.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.__next__">__next__</a></td> <td>Special method to advance to the next error.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.add">add</a></td> <td>Public method to add a word to the personal word list.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.checkCurrentPage">checkCurrentPage</a></td> <td>Public method to check the currently visible page.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.checkDocument">checkDocument</a></td> <td>Public method to check the complete document.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.checkDocumentIncrementally">checkDocumentIncrementally</a></td> <td>Public method to check the document incrementally.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.checkLines">checkLines</a></td> <td>Public method to check some lines of text.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.checkSelection">checkSelection</a></td> <td>Public method to check the current selection.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.checkWord">checkWord</a></td> <td>Public method to check the word at position pos.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.clearAll">clearAll</a></td> <td>Public method to clear all spelling markers.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.getContext">getContext</a></td> <td>Public method to get the context of a faulty word.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.getError">getError</a></td> <td>Public method to get information about the last error found.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.getLanguage">getLanguage</a></td> <td>Public method to get the current language.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.getSuggestions">getSuggestions</a></td> <td>Public method to get suggestions for the given word.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.ignoreAlways">ignoreAlways</a></td> <td>Public method to tell the checker, to always ignore the given word or the current word.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.initCheck">initCheck</a></td> <td>Public method to initialize a spell check.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.remove">remove</a></td> <td>Public method to add a word to the personal exclude list.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.replace">replace</a></td> <td>Public method to tell the checker to replace the current word with the replacement string.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.replaceAlways">replaceAlways</a></td> <td>Public method to tell the checker to always replace the current word with the replacement string.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.setLanguage">setLanguage</a></td> <td>Public method to set the current language.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.setMinimumWordSize">setMinimumWordSize</a></td> <td>Public method to set the minimum word size.</td> -</tr><tr> +</tr> +<tr> <td><a href="#SpellChecker.stopIncrementalCheck">stopIncrementalCheck</a></td> <td>Public method to stop an incremental check.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="SpellChecker._getDict" ID="SpellChecker._getDict"></a> <h4>SpellChecker._getDict (class method)</h4> <b>_getDict</b>(<i>lang, pwl="", pel=""</i>) + <p> Protected class method to get a new dictionary. -</p><dl> +</p> +<dl> + <dt><i>lang</i></dt> <dd> the language to be used as the default (string). The string should be in language locale format (e.g. en_US, de). -</dd><dt><i>pwl=</i></dt> +</dd> +<dt><i>pwl=</i></dt> <dd> name of the personal/project word list (string) -</dd><dt><i>pel=</i></dt> +</dd> +<dt><i>pel=</i></dt> <dd> name of the personal/project exclude list (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> reference to the dictionary (enchant.Dict) </dd> -</dl><a NAME="SpellChecker.getAvailableLanguages" ID="SpellChecker.getAvailableLanguages"></a> +</dl> +<a NAME="SpellChecker.getAvailableLanguages" ID="SpellChecker.getAvailableLanguages"></a> <h4>SpellChecker.getAvailableLanguages (class method)</h4> <b>getAvailableLanguages</b>(<i></i>) + <p> Class method to get all available languages. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> list of available languages (list of strings) </dd> -</dl><a NAME="SpellChecker.getDefaultPath" ID="SpellChecker.getDefaultPath"></a> +</dl> +<a NAME="SpellChecker.getDefaultPath" ID="SpellChecker.getDefaultPath"></a> <h4>SpellChecker.getDefaultPath (class method)</h4> <b>getDefaultPath</b>(<i>isException=False</i>) + <p> Class method to get the default path names of the user dictionaries. -</p><dl> +</p> +<dl> + <dt><i>isException</i></dt> <dd> flag indicating to return the name of the default exception dictionary (boolean) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> file name of the default user dictionary or the default user exception dictionary (string) </dd> -</dl><a NAME="SpellChecker.getUserDictionaryPath" ID="SpellChecker.getUserDictionaryPath"></a> +</dl> +<a NAME="SpellChecker.getUserDictionaryPath" ID="SpellChecker.getUserDictionaryPath"></a> <h4>SpellChecker.getUserDictionaryPath (class method)</h4> <b>getUserDictionaryPath</b>(<i>isException=False</i>) + <p> Class method to get the path name of a user dictionary file. -</p><dl> +</p> +<dl> + <dt><i>isException</i></dt> <dd> flag indicating to return the name of the user exception dictionary (boolean) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> file name of the user dictionary or the user exception dictionary (string) </dd> -</dl><a NAME="SpellChecker.isAvailable" ID="SpellChecker.isAvailable"></a> +</dl> +<a NAME="SpellChecker.isAvailable" ID="SpellChecker.isAvailable"></a> <h4>SpellChecker.isAvailable (class method)</h4> <b>isAvailable</b>(<i></i>) + <p> Class method to check, if spellchecking is available. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> flag indicating availability (boolean) </dd> -</dl><a NAME="SpellChecker.setDefaultLanguage" ID="SpellChecker.setDefaultLanguage"></a> +</dl> +<a NAME="SpellChecker.setDefaultLanguage" ID="SpellChecker.setDefaultLanguage"></a> <h4>SpellChecker.setDefaultLanguage (class method)</h4> <b>setDefaultLanguage</b>(<i>language</i>) + <p> Class method to set the default language. -</p><dl> +</p> +<dl> + <dt><i>language</i></dt> <dd> the language to be used as the default (string). The string should be in language locale format (e.g. en_US, de). </dd> -</dl><a NAME="SpellChecker.__init__" ID="SpellChecker.__init__"></a> +</dl> +<a NAME="SpellChecker.__init__" ID="SpellChecker.__init__"></a> <h4>SpellChecker (Constructor)</h4> <b>SpellChecker</b>(<i>editor, indicator, defaultLanguage=None, checkRegion=None</i>) + <p> Constructor -</p><dl> +</p> +<dl> + <dt><i>editor</i></dt> <dd> reference to the editor object (QScintilla.Editor) -</dd><dt><i>indicator</i></dt> +</dd> +<dt><i>indicator</i></dt> <dd> spell checking indicator -</dd><dt><i>defaultLanguage=</i></dt> +</dd> +<dt><i>defaultLanguage=</i></dt> <dd> the language to be used as the default (string). The string should be in language locale format (e.g. en_US, de). -</dd><dt><i>checkRegion=</i></dt> +</dd> +<dt><i>checkRegion=</i></dt> <dd> reference to a function to check for a valid region </dd> -</dl><a NAME="SpellChecker.__checkDocumentPart" ID="SpellChecker.__checkDocumentPart"></a> +</dl> +<a NAME="SpellChecker.__checkDocumentPart" ID="SpellChecker.__checkDocumentPart"></a> <h4>SpellChecker.__checkDocumentPart</h4> <b>__checkDocumentPart</b>(<i>startPos, endPos</i>) + <p> Private method to check some part of the document. -</p><dl> +</p> +<dl> + <dt><i>startPos</i></dt> <dd> position to start at (integer) -</dd><dt><i>endPos</i></dt> +</dd> +<dt><i>endPos</i></dt> <dd> position to end at (integer) </dd> -</dl><a NAME="SpellChecker.__getNextWord" ID="SpellChecker.__getNextWord"></a> +</dl> +<a NAME="SpellChecker.__getNextWord" ID="SpellChecker.__getNextWord"></a> <h4>SpellChecker.__getNextWord</h4> <b>__getNextWord</b>(<i>pos, endPosition</i>) + <p> Private method to get the next word in the text after the given position. -</p><dl> +</p> +<dl> + <dt><i>pos</i></dt> <dd> position to start word extraction (integer) -</dd><dt><i>endPosition</i></dt> +</dd> +<dt><i>endPosition</i></dt> <dd> position to stop word extraction (integer) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> tuple of three values (the extracted word (string), start position (integer), end position (integer)) </dd> -</dl><a NAME="SpellChecker.__incrementalCheck" ID="SpellChecker.__incrementalCheck"></a> +</dl> +<a NAME="SpellChecker.__incrementalCheck" ID="SpellChecker.__incrementalCheck"></a> <h4>SpellChecker.__incrementalCheck</h4> <b>__incrementalCheck</b>(<i></i>) + <p> Private method to check the document incrementally. -</p><a NAME="SpellChecker.__iter__" ID="SpellChecker.__iter__"></a> +</p> +<a NAME="SpellChecker.__iter__" ID="SpellChecker.__iter__"></a> <h4>SpellChecker.__iter__</h4> <b>__iter__</b>(<i></i>) + <p> Special method to create an iterator. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> self </dd> -</dl><a NAME="SpellChecker.__next__" ID="SpellChecker.__next__"></a> +</dl> +<a NAME="SpellChecker.__next__" ID="SpellChecker.__next__"></a> <h4>SpellChecker.__next__</h4> <b>__next__</b>(<i></i>) + <p> Special method to advance to the next error. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> self </dd> -</dl><dl> +</dl> +<dl> + <dt>Raises <b>StopIteration</b>:</dt> <dd> raised to indicate the end of the iteration </dd> -</dl><a NAME="SpellChecker.add" ID="SpellChecker.add"></a> +</dl> +<a NAME="SpellChecker.add" ID="SpellChecker.add"></a> <h4>SpellChecker.add</h4> <b>add</b>(<i>word=None</i>) + <p> Public method to add a word to the personal word list. -</p><dl> +</p> +<dl> + <dt><i>word</i></dt> <dd> word to add (string) </dd> -</dl><a NAME="SpellChecker.checkCurrentPage" ID="SpellChecker.checkCurrentPage"></a> +</dl> +<a NAME="SpellChecker.checkCurrentPage" ID="SpellChecker.checkCurrentPage"></a> <h4>SpellChecker.checkCurrentPage</h4> <b>checkCurrentPage</b>(<i></i>) + <p> Public method to check the currently visible page. -</p><a NAME="SpellChecker.checkDocument" ID="SpellChecker.checkDocument"></a> +</p> +<a NAME="SpellChecker.checkDocument" ID="SpellChecker.checkDocument"></a> <h4>SpellChecker.checkDocument</h4> <b>checkDocument</b>(<i></i>) + <p> Public method to check the complete document. -</p><a NAME="SpellChecker.checkDocumentIncrementally" ID="SpellChecker.checkDocumentIncrementally"></a> +</p> +<a NAME="SpellChecker.checkDocumentIncrementally" ID="SpellChecker.checkDocumentIncrementally"></a> <h4>SpellChecker.checkDocumentIncrementally</h4> <b>checkDocumentIncrementally</b>(<i></i>) + <p> Public method to check the document incrementally. -</p><a NAME="SpellChecker.checkLines" ID="SpellChecker.checkLines"></a> +</p> +<a NAME="SpellChecker.checkLines" ID="SpellChecker.checkLines"></a> <h4>SpellChecker.checkLines</h4> <b>checkLines</b>(<i>firstLine, lastLine</i>) + <p> Public method to check some lines of text. -</p><dl> +</p> +<dl> + <dt><i>firstLine</i></dt> <dd> line number of first line to check (integer) -</dd><dt><i>lastLine</i></dt> +</dd> +<dt><i>lastLine</i></dt> <dd> line number of last line to check (integer) </dd> -</dl><a NAME="SpellChecker.checkSelection" ID="SpellChecker.checkSelection"></a> +</dl> +<a NAME="SpellChecker.checkSelection" ID="SpellChecker.checkSelection"></a> <h4>SpellChecker.checkSelection</h4> <b>checkSelection</b>(<i></i>) + <p> Public method to check the current selection. -</p><a NAME="SpellChecker.checkWord" ID="SpellChecker.checkWord"></a> +</p> +<a NAME="SpellChecker.checkWord" ID="SpellChecker.checkWord"></a> <h4>SpellChecker.checkWord</h4> <b>checkWord</b>(<i>pos, atEnd=False</i>) + <p> Public method to check the word at position pos. -</p><dl> +</p> +<dl> + <dt><i>pos</i></dt> <dd> position to check at (integer) -</dd><dt><i>atEnd=</i></dt> +</dd> +<dt><i>atEnd=</i></dt> <dd> flag indicating the position is at the end of the word to check (boolean) </dd> -</dl><a NAME="SpellChecker.clearAll" ID="SpellChecker.clearAll"></a> +</dl> +<a NAME="SpellChecker.clearAll" ID="SpellChecker.clearAll"></a> <h4>SpellChecker.clearAll</h4> <b>clearAll</b>(<i></i>) + <p> Public method to clear all spelling markers. -</p><a NAME="SpellChecker.getContext" ID="SpellChecker.getContext"></a> +</p> +<a NAME="SpellChecker.getContext" ID="SpellChecker.getContext"></a> <h4>SpellChecker.getContext</h4> <b>getContext</b>(<i>wordStart, wordEnd</i>) + <p> Public method to get the context of a faulty word. -</p><dl> +</p> +<dl> + <dt><i>wordStart</i></dt> <dd> the starting position of the word (integer) -</dd><dt><i>wordEnd</i></dt> +</dd> +<dt><i>wordEnd</i></dt> <dd> the ending position of the word (integer) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> tuple of the leading and trailing context (string, string) </dd> -</dl><a NAME="SpellChecker.getError" ID="SpellChecker.getError"></a> +</dl> +<a NAME="SpellChecker.getError" ID="SpellChecker.getError"></a> <h4>SpellChecker.getError</h4> <b>getError</b>(<i></i>) + <p> Public method to get information about the last error found. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> tuple of last faulty word (string), starting position of the faulty word (integer) and ending position of the faulty word (integer) </dd> -</dl><a NAME="SpellChecker.getLanguage" ID="SpellChecker.getLanguage"></a> +</dl> +<a NAME="SpellChecker.getLanguage" ID="SpellChecker.getLanguage"></a> <h4>SpellChecker.getLanguage</h4> <b>getLanguage</b>(<i></i>) + <p> Public method to get the current language. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> current language in language locale format (string) </dd> -</dl><a NAME="SpellChecker.getSuggestions" ID="SpellChecker.getSuggestions"></a> +</dl> +<a NAME="SpellChecker.getSuggestions" ID="SpellChecker.getSuggestions"></a> <h4>SpellChecker.getSuggestions</h4> <b>getSuggestions</b>(<i>word</i>) + <p> Public method to get suggestions for the given word. -</p><dl> +</p> +<dl> + <dt><i>word</i></dt> <dd> word to get suggestions for (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> list of suggestions (list of strings) </dd> -</dl><a NAME="SpellChecker.ignoreAlways" ID="SpellChecker.ignoreAlways"></a> +</dl> +<a NAME="SpellChecker.ignoreAlways" ID="SpellChecker.ignoreAlways"></a> <h4>SpellChecker.ignoreAlways</h4> <b>ignoreAlways</b>(<i>word=None</i>) + <p> Public method to tell the checker, to always ignore the given word or the current word. -</p><dl> +</p> +<dl> + <dt><i>word</i></dt> <dd> word to be ignored (string) </dd> -</dl><a NAME="SpellChecker.initCheck" ID="SpellChecker.initCheck"></a> +</dl> +<a NAME="SpellChecker.initCheck" ID="SpellChecker.initCheck"></a> <h4>SpellChecker.initCheck</h4> <b>initCheck</b>(<i>startPos, endPos</i>) + <p> Public method to initialize a spell check. -</p><dl> +</p> +<dl> + <dt><i>startPos</i></dt> <dd> position to start at (integer) -</dd><dt><i>endPos</i></dt> +</dd> +<dt><i>endPos</i></dt> <dd> position to end at (integer) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> flag indicating successful initialization (boolean) </dd> -</dl><a NAME="SpellChecker.remove" ID="SpellChecker.remove"></a> +</dl> +<a NAME="SpellChecker.remove" ID="SpellChecker.remove"></a> <h4>SpellChecker.remove</h4> <b>remove</b>(<i>word</i>) + <p> Public method to add a word to the personal exclude list. -</p><dl> +</p> +<dl> + <dt><i>word</i></dt> <dd> word to add (string) </dd> -</dl><a NAME="SpellChecker.replace" ID="SpellChecker.replace"></a> +</dl> +<a NAME="SpellChecker.replace" ID="SpellChecker.replace"></a> <h4>SpellChecker.replace</h4> <b>replace</b>(<i>replacement</i>) + <p> Public method to tell the checker to replace the current word with the replacement string. -</p><dl> +</p> +<dl> + <dt><i>replacement</i></dt> <dd> replacement string (string) </dd> -</dl><a NAME="SpellChecker.replaceAlways" ID="SpellChecker.replaceAlways"></a> +</dl> +<a NAME="SpellChecker.replaceAlways" ID="SpellChecker.replaceAlways"></a> <h4>SpellChecker.replaceAlways</h4> <b>replaceAlways</b>(<i>replacement</i>) + <p> Public method to tell the checker to always replace the current word with the replacement string. -</p><dl> +</p> +<dl> + <dt><i>replacement</i></dt> <dd> replacement string (string) </dd> -</dl><a NAME="SpellChecker.setLanguage" ID="SpellChecker.setLanguage"></a> +</dl> +<a NAME="SpellChecker.setLanguage" ID="SpellChecker.setLanguage"></a> <h4>SpellChecker.setLanguage</h4> <b>setLanguage</b>(<i>language, pwl="", pel=""</i>) + <p> Public method to set the current language. -</p><dl> +</p> +<dl> + <dt><i>language</i></dt> <dd> the language to be used as the default (string). The string should be in language locale format (e.g. en_US, de). -</dd><dt><i>pwl=</i></dt> +</dd> +<dt><i>pwl=</i></dt> <dd> name of the personal/project word list (string) -</dd><dt><i>pel=</i></dt> +</dd> +<dt><i>pel=</i></dt> <dd> name of the personal/project exclude list (string) </dd> -</dl><a NAME="SpellChecker.setMinimumWordSize" ID="SpellChecker.setMinimumWordSize"></a> +</dl> +<a NAME="SpellChecker.setMinimumWordSize" ID="SpellChecker.setMinimumWordSize"></a> <h4>SpellChecker.setMinimumWordSize</h4> <b>setMinimumWordSize</b>(<i>size</i>) + <p> Public method to set the minimum word size. -</p><dl> +</p> +<dl> + <dt><i>size</i></dt> <dd> minimum word size (integer) </dd> -</dl><a NAME="SpellChecker.stopIncrementalCheck" ID="SpellChecker.stopIncrementalCheck"></a> +</dl> +<a NAME="SpellChecker.stopIncrementalCheck" ID="SpellChecker.stopIncrementalCheck"></a> <h4>SpellChecker.stopIncrementalCheck</h4> <b>stopIncrementalCheck</b>(<i></i>) + <p> Public method to stop an incremental check. </p>