Documentation/Source/eric6.QScintilla.SpellChecker.html

<!DOCTYPE html>
<html><head>
<title>eric6.QScintilla.SpellChecker</title>
<meta charset="UTF-8">
<style>
body {
    background: #EDECE6;
    margin: 0em 1em 10em 1em;
    color: black;
}

h1 { color: white; background: #85774A; }
h2 { color: white; background: #85774A; }
h3 { color: white; background: #9D936E; }
h4 { color: white; background: #9D936E; }
    
a { color: #BA6D36; }

</style>
</head>
<body><a NAME="top" ID="top"></a>
<h1>eric6.QScintilla.SpellChecker</h1>
<p>
Module implementing the spell checker for the editor component.
</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 />
<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>
<td><a href="#SpellChecker.getAvailableLanguages">getAvailableLanguages</a></td>
<td>Class method to get all available languages.</td>
</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>
<td><a href="#SpellChecker.getUserDictionaryPath">getUserDictionaryPath</a></td>
<td>Class method to get the path name of a user dictionary file.</td>
</tr><tr>
<td><a href="#SpellChecker.isAvailable">isAvailable</a></td>
<td>Class method to check, if spellchecking is available.</td>
</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>
<td><a href="#SpellChecker.__checkDocumentPart">__checkDocumentPart</a></td>
<td>Private method to check some part of the document.</td>
</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>
<td><a href="#SpellChecker.__incrementalCheck">__incrementalCheck</a></td>
<td>Private method to check the document incrementally.</td>
</tr><tr>
<td><a href="#SpellChecker.__iter__">__iter__</a></td>
<td>Special method to create an iterator.</td>
</tr><tr>
<td><a href="#SpellChecker.__next__">__next__</a></td>
<td>Special method to advance to the next error.</td>
</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>
<td><a href="#SpellChecker.checkCurrentPage">checkCurrentPage</a></td>
<td>Public method to check the currently visible page.</td>
</tr><tr>
<td><a href="#SpellChecker.checkDocument">checkDocument</a></td>
<td>Public method to check the complete document.</td>
</tr><tr>
<td><a href="#SpellChecker.checkDocumentIncrementally">checkDocumentIncrementally</a></td>
<td>Public method to check the document incrementally.</td>
</tr><tr>
<td><a href="#SpellChecker.checkLines">checkLines</a></td>
<td>Public method to check some lines of text.</td>
</tr><tr>
<td><a href="#SpellChecker.checkSelection">checkSelection</a></td>
<td>Public method to check the current selection.</td>
</tr><tr>
<td><a href="#SpellChecker.checkWord">checkWord</a></td>
<td>Public method to check the word at position pos.</td>
</tr><tr>
<td><a href="#SpellChecker.clearAll">clearAll</a></td>
<td>Public method to clear all spelling markers.</td>
</tr><tr>
<td><a href="#SpellChecker.getContext">getContext</a></td>
<td>Public method to get the context of a faulty word.</td>
</tr><tr>
<td><a href="#SpellChecker.getError">getError</a></td>
<td>Public method to get information about the last error found.</td>
</tr><tr>
<td><a href="#SpellChecker.getLanguage">getLanguage</a></td>
<td>Public method to get the current language.</td>
</tr><tr>
<td><a href="#SpellChecker.getSuggestions">getSuggestions</a></td>
<td>Public method to get suggestions for the given word.</td>
</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>
<td><a href="#SpellChecker.initCheck">initCheck</a></td>
<td>Public method to initialize a spell check.</td>
</tr><tr>
<td><a href="#SpellChecker.next">next</a></td>
<td>Public method to advance to the next error.</td>
</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>
<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>
<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>
<td><a href="#SpellChecker.setLanguage">setLanguage</a></td>
<td>Public method to set the current language.</td>
</tr><tr>
<td><a href="#SpellChecker.setMinimumWordSize">setMinimumWordSize</a></td>
<td>Public method to set the minimum word size.</td>
</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>
<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>
name of the personal/project word list (string)
</dd><dt><i>pel=</i></dt>
<dd>
name of the personal/project exclude list (string)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
reference to the dictionary (enchant.Dict)
</dd>
</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>
<dt>Returns:</dt>
<dd>
list of available languages (list of strings)
</dd>
</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>
<dt><i>isException</i></dt>
<dd>
flag indicating to return the name of the default
            exception dictionary (boolean)
</dd>
</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>
<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>
<dt><i>isException</i></dt>
<dd>
flag indicating to return the name of the user
            exception dictionary (boolean)
</dd>
</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>
<h4>SpellChecker.isAvailable (class method)</h4>
<b>isAvailable</b>(<i></i>)
<p>
        Class method to check, if spellchecking is available.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating availability (boolean)
</dd>
</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>
<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>
<h4>SpellChecker (Constructor)</h4>
<b>SpellChecker</b>(<i>editor, indicator, defaultLanguage=None, checkRegion=None</i>)
<p>
        Constructor
</p><dl>
<dt><i>editor</i></dt>
<dd>
reference to the editor object (QScintilla.Editor)
</dd><dt><i>indicator</i></dt>
<dd>
spell checking indicator
</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>
reference to a function to check for a valid
            region
</dd>
</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>
<dt><i>startPos</i></dt>
<dd>
position to start at (integer)
</dd><dt><i>endPos</i></dt>
<dd>
position to end at (integer)
</dd>
</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>
<dt><i>pos</i></dt>
<dd>
position to start word extraction (integer)
</dd><dt><i>endPosition</i></dt>
<dd>
position to stop word extraction (integer)
</dd>
</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>
<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>
<h4>SpellChecker.__iter__</h4>
<b>__iter__</b>(<i></i>)
<p>
        Special method to create an iterator.
</p><dl>
<dt>Returns:</dt>
<dd>
self
</dd>
</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>
<dt>Returns:</dt>
<dd>
self
</dd>
</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>
<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>
<dt><i>word</i></dt>
<dd>
word to add (string)
</dd>
</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>
<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>
<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>
<h4>SpellChecker.checkLines</h4>
<b>checkLines</b>(<i>firstLine, lastLine</i>)
<p>
        Public method to check some lines of text.
</p><dl>
<dt><i>firstLine</i></dt>
<dd>
line number of first line to check (integer)
</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>
<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>
<h4>SpellChecker.checkWord</h4>
<b>checkWord</b>(<i>pos, atEnd=False</i>)
<p>
        Public method to check the word at position pos.
</p><dl>
<dt><i>pos</i></dt>
<dd>
position to check at (integer)
</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>
<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>
<h4>SpellChecker.getContext</h4>
<b>getContext</b>(<i>wordStart, wordEnd</i>)
<p>
        Public method to get the context of a faulty word.
</p><dl>
<dt><i>wordStart</i></dt>
<dd>
the starting position of the word (integer)
</dd><dt><i>wordEnd</i></dt>
<dd>
the ending position of the word (integer)
</dd>
</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>
<h4>SpellChecker.getError</h4>
<b>getError</b>(<i></i>)
<p>
        Public method to get information about the last error found.
</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>
<h4>SpellChecker.getLanguage</h4>
<b>getLanguage</b>(<i></i>)
<p>
        Public method to get the current language.
</p><dl>
<dt>Returns:</dt>
<dd>
current language in language locale format (string)
</dd>
</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>
<dt><i>word</i></dt>
<dd>
word to get suggestions for (string)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
list of suggestions (list of strings)
</dd>
</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>
<dt><i>word</i></dt>
<dd>
word to be ignored (string)
</dd>
</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>
<dt><i>startPos</i></dt>
<dd>
position to start at (integer)
</dd><dt><i>endPos</i></dt>
<dd>
position to end at (integer)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating successful initialization (boolean)
</dd>
</dl><a NAME="SpellChecker.next" ID="SpellChecker.next"></a>
<h4>SpellChecker.next</h4>
<b>next</b>(<i></i>)
<p>
            Public method to advance to the next error.
</p><dl>
<dt>Returns:</dt>
<dd>
self
</dd>
</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>
<dt><i>word</i></dt>
<dd>
word to add (string)
</dd>
</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>
<dt><i>replacement</i></dt>
<dd>
replacement string (string)
</dd>
</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>
<dt><i>replacement</i></dt>
<dd>
replacement string (string)
</dd>
</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>
<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>
name of the personal/project word list (string)
</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>
<h4>SpellChecker.setMinimumWordSize</h4>
<b>setMinimumWordSize</b>(<i>size</i>)
<p>
        Public method to set the minimum word size.
</p><dl>
<dt><i>size</i></dt>
<dd>
minimum word size (integer)
</dd>
</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>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>