eric6/Documentation/Source/eric6.Plugins.CheckerPlugins.Tabnanny.Tabnanny.html

changeset 7273
391d6b7b1eff
parent 6942
2602857055c5
--- a/eric6/Documentation/Source/eric6.Plugins.CheckerPlugins.Tabnanny.Tabnanny.html	Wed Sep 25 19:40:31 2019 +0200
+++ b/eric6/Documentation/Source/eric6.Plugins.CheckerPlugins.Tabnanny.Tabnanny.html	Wed Sep 25 19:42:44 2019 +0200
@@ -18,304 +18,398 @@
 
 </style>
 </head>
-<body><a NAME="top" ID="top"></a>
+<body>
+<a NAME="top" ID="top"></a>
 <h1>eric6.Plugins.CheckerPlugins.Tabnanny.Tabnanny</h1>
+
 <p>
 The Tab Nanny despises ambiguous indentation.  She knows no mercy.
-</p><p>
+</p>
+<p>
 tabnanny -- Detection of ambiguous indentation
-</p><p>
+</p>
+<p>
 For the time being this module is intended to be called as a script.
 However it is possible to import it into an IDE and use the function
 check() described below.
-</p><p>
+</p>
+<p>
 Warning: The API provided by this module is likely to change in future
 releases; such changes may not be backward compatible.
-</p><p>
+</p>
+<p>
 This is a modified version to make the original tabnanny better suitable
 for being called from within the eric6 IDE.
-</p><dl>
+</p>
+<dl>
+
 <dt>Raises <b>ValueError</b>:</dt>
 <dd>
 The tokenize module is too old.
 </dd>
 </dl>
 <h3>Global Attributes</h3>
+
 <table>
 <tr><td>__all__</td></tr><tr><td>__version__</td></tr>
 </table>
 <h3>Classes</h3>
+
 <table>
+
 <tr>
 <td><a href="#NannyNag">NannyNag</a></td>
 <td>Class implementing an exception for indentation issues.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#Whitespace">Whitespace</a></td>
 <td>Class implementing the whitespace checker.</td>
 </tr>
 </table>
 <h3>Functions</h3>
+
 <table>
+
 <tr>
 <td><a href="#__check">__check</a></td>
 <td>Private function to check one Python source file for whitespace related problems.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#batchCheck">batchCheck</a></td>
 <td>Module function to check a batch of files for whitespace related problems.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#check">check</a></td>
 <td>Private function to check one Python source file for whitespace related problems.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#format_witnesses">format_witnesses</a></td>
 <td>Function to format the witnesses as a readable string.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#initBatchService">initBatchService</a></td>
 <td>Initialize the batch service and return the entry point.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#initService">initService</a></td>
 <td>Initialize the service and return the entry point.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#process_tokens">process_tokens</a></td>
 <td>Function processing all tokens generated by a tokenizer run.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#worker">worker</a></td>
 <td>Module function acting as the parallel worker for the style check.</td>
 </tr>
 </table>
-<hr /><hr />
+<hr />
+<hr />
 <a NAME="NannyNag" ID="NannyNag"></a>
 <h2>NannyNag</h2>
+
 <p>
     Class implementing an exception for indentation issues.
-</p><p>
+</p>
+<p>
     Raised by tokeneater() if detecting an ambiguous indent.
     Captured and handled in check().
 </p>
 <h3>Derived from</h3>
 Exception
 <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="#NannyNag.__init__">NannyNag</a></td>
 <td>Constructor</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#NannyNag.get_line">get_line</a></td>
 <td>Public method to retrieve the offending line.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#NannyNag.get_lineno">get_lineno</a></td>
 <td>Public method to retrieve the line number.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#NannyNag.get_msg">get_msg</a></td>
 <td>Public method to retrieve the message.</td>
 </tr>
 </table>
 <h3>Static Methods</h3>
+
 <table>
 <tr><td>None</td></tr>
 </table>
+
 <a NAME="NannyNag.__init__" ID="NannyNag.__init__"></a>
 <h4>NannyNag (Constructor)</h4>
 <b>NannyNag</b>(<i>lineno, msg, line</i>)
+
 <p>
         Constructor
-</p><dl>
+</p>
+<dl>
+
 <dt><i>lineno</i></dt>
 <dd>
 Line number of the ambiguous indent.
-</dd><dt><i>msg</i></dt>
+</dd>
+<dt><i>msg</i></dt>
 <dd>
 Descriptive message assigned to this problem.
-</dd><dt><i>line</i></dt>
+</dd>
+<dt><i>line</i></dt>
 <dd>
 The offending source line.
 </dd>
-</dl><a NAME="NannyNag.get_line" ID="NannyNag.get_line"></a>
+</dl>
+<a NAME="NannyNag.get_line" ID="NannyNag.get_line"></a>
 <h4>NannyNag.get_line</h4>
 <b>get_line</b>(<i></i>)
+
 <p>
         Public method to retrieve the offending line.
-</p><dl>
+</p>
+<dl>
 <dt>Returns:</dt>
 <dd>
 The line of code (string)
 </dd>
-</dl><a NAME="NannyNag.get_lineno" ID="NannyNag.get_lineno"></a>
+</dl>
+<a NAME="NannyNag.get_lineno" ID="NannyNag.get_lineno"></a>
 <h4>NannyNag.get_lineno</h4>
 <b>get_lineno</b>(<i></i>)
+
 <p>
         Public method to retrieve the line number.
-</p><dl>
+</p>
+<dl>
 <dt>Returns:</dt>
 <dd>
 The line number (integer)
 </dd>
-</dl><a NAME="NannyNag.get_msg" ID="NannyNag.get_msg"></a>
+</dl>
+<a NAME="NannyNag.get_msg" ID="NannyNag.get_msg"></a>
 <h4>NannyNag.get_msg</h4>
 <b>get_msg</b>(<i></i>)
+
 <p>
         Public method to retrieve the message.
-</p><dl>
+</p>
+<dl>
 <dt>Returns:</dt>
 <dd>
 The error message (string)
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
 <a NAME="Whitespace" ID="Whitespace"></a>
 <h2>Whitespace</h2>
+
 <p>
     Class implementing the whitespace checker.
 </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="#Whitespace.__init__">Whitespace</a></td>
 <td>Constructor</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#Whitespace.equal">equal</a></td>
 <td>Public method to compare the indentation levels of two Whitespace objects for equality.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#Whitespace.indent_level">indent_level</a></td>
 <td>Public method to determine the indentation level.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#Whitespace.less">less</a></td>
 <td>Public method to compare the indentation level against another Whitespace objects to be smaller.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#Whitespace.longest_run_of_spaces">longest_run_of_spaces</a></td>
 <td>Public method to calculate the length of longest contiguous run of spaces.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#Whitespace.not_equal_witness">not_equal_witness</a></td>
 <td>Public method to calculate a tuple of witnessing tab size.</td>
-</tr><tr>
+</tr>
+<tr>
 <td><a href="#Whitespace.not_less_witness">not_less_witness</a></td>
 <td>Public method to calculate a tuple of witnessing tab size.</td>
 </tr>
 </table>
 <h3>Static Methods</h3>
+
 <table>
 <tr><td>None</td></tr>
 </table>
+
 <a NAME="Whitespace.__init__" ID="Whitespace.__init__"></a>
 <h4>Whitespace (Constructor)</h4>
 <b>Whitespace</b>(<i>ws</i>)
+
 <p>
         Constructor
-</p><dl>
+</p>
+<dl>
+
 <dt><i>ws</i></dt>
 <dd>
 The string to be checked.
 </dd>
-</dl><a NAME="Whitespace.equal" ID="Whitespace.equal"></a>
+</dl>
+<a NAME="Whitespace.equal" ID="Whitespace.equal"></a>
 <h4>Whitespace.equal</h4>
 <b>equal</b>(<i>other</i>)
+
 <p>
         Public method to compare the indentation levels of two Whitespace
         objects for equality.
-</p><dl>
+</p>
+<dl>
+
 <dt><i>other</i></dt>
 <dd>
 Whitespace object to compare against.
 </dd>
-</dl><dl>
+</dl>
+<dl>
 <dt>Returns:</dt>
 <dd>
 True, if we compare equal against the other Whitespace object.
 </dd>
-</dl><a NAME="Whitespace.indent_level" ID="Whitespace.indent_level"></a>
+</dl>
+<a NAME="Whitespace.indent_level" ID="Whitespace.indent_level"></a>
 <h4>Whitespace.indent_level</h4>
 <b>indent_level</b>(<i>tabsize</i>)
+
 <p>
         Public method to determine the indentation level.
-</p><dl>
+</p>
+<dl>
+
 <dt><i>tabsize</i></dt>
 <dd>
 The length of a tab stop. (integer)
 </dd>
-</dl><dl>
+</dl>
+<dl>
 <dt>Returns:</dt>
 <dd>
 indentation level (integer)
 </dd>
-</dl><a NAME="Whitespace.less" ID="Whitespace.less"></a>
+</dl>
+<a NAME="Whitespace.less" ID="Whitespace.less"></a>
 <h4>Whitespace.less</h4>
 <b>less</b>(<i>other</i>)
+
 <p>
         Public method to compare the indentation level against another
         Whitespace objects to be smaller.
-</p><dl>
+</p>
+<dl>
+
 <dt><i>other</i></dt>
 <dd>
 Whitespace object to compare against.
 </dd>
-</dl><dl>
+</dl>
+<dl>
 <dt>Returns:</dt>
 <dd>
 True, if we compare less against the other Whitespace object.
 </dd>
-</dl><a NAME="Whitespace.longest_run_of_spaces" ID="Whitespace.longest_run_of_spaces"></a>
+</dl>
+<a NAME="Whitespace.longest_run_of_spaces" ID="Whitespace.longest_run_of_spaces"></a>
 <h4>Whitespace.longest_run_of_spaces</h4>
 <b>longest_run_of_spaces</b>(<i></i>)
+
 <p>
         Public method to calculate the length of longest contiguous run of
         spaces.
-</p><dl>
+</p>
+<dl>
 <dt>Returns:</dt>
 <dd>
 The length of longest contiguous run of spaces (whether or not
             preceding a tab)
 </dd>
-</dl><a NAME="Whitespace.not_equal_witness" ID="Whitespace.not_equal_witness"></a>
+</dl>
+<a NAME="Whitespace.not_equal_witness" ID="Whitespace.not_equal_witness"></a>
 <h4>Whitespace.not_equal_witness</h4>
 <b>not_equal_witness</b>(<i>other</i>)
+
 <p>
         Public method to calculate a tuple of witnessing tab size.
-</p><p>
+</p>
+<p>
         Intended to be used after not self.equal(other) is known, in which
         case it will return at least one witnessing tab size.
-</p><dl>
+</p>
+<dl>
+
 <dt><i>other</i></dt>
 <dd>
 Whitespace object to calculate against.
 </dd>
-</dl><dl>
+</dl>
+<dl>
 <dt>Returns:</dt>
 <dd>
 A list of tuples (ts, i1, i2) such that
             i1 == self.indent_level(ts) != other.indent_level(ts) == i2.
 </dd>
-</dl><a NAME="Whitespace.not_less_witness" ID="Whitespace.not_less_witness"></a>
+</dl>
+<a NAME="Whitespace.not_less_witness" ID="Whitespace.not_less_witness"></a>
 <h4>Whitespace.not_less_witness</h4>
 <b>not_less_witness</b>(<i>other</i>)
+
 <p>
         Public method to calculate a tuple of witnessing tab size.
-</p><p>
+</p>
+<p>
         Intended to be used after not self.less(other is known, in which
         case it will return at least one witnessing tab size.
-</p><dl>
+</p>
+<dl>
+
 <dt><i>other</i></dt>
 <dd>
 Whitespace object to calculate against.
 </dd>
-</dl><dl>
+</dl>
+<dl>
 <dt>Returns:</dt>
 <dd>
 A list of tuples (ts, i1, i2) such that
@@ -323,22 +417,28 @@
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
 <a NAME="__check" ID="__check"></a>
 <h2>__check</h2>
 <b>__check</b>(<i>file, text=""</i>)
+
 <p>
     Private function to check one Python source file for whitespace related
     problems.
-</p><dl>
+</p>
+<dl>
+
 <dt><i>file</i></dt>
 <dd>
 source filename (string)
-</dd><dt><i>text</i></dt>
+</dd>
+<dt><i>text</i></dt>
 <dd>
 source text (string)
 </dd>
-</dl><dl>
+</dl>
+<dl>
 <dt>Returns:</dt>
 <dd>
 A tuple indicating status (True = an error was found), the
@@ -348,47 +448,61 @@
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
 <a NAME="batchCheck" ID="batchCheck"></a>
 <h2>batchCheck</h2>
 <b>batchCheck</b>(<i>argumentsList, send, fx, cancelled, maxProcesses=0</i>)
+
 <p>
     Module function to check a batch of files for whitespace related problems.
-</p><dl>
+</p>
+<dl>
+
 <dt><i>argumentsList</i> (list)</dt>
 <dd>
 list of arguments tuples as given for check
-</dd><dt><i>send</i> (func)</dt>
+</dd>
+<dt><i>send</i> (func)</dt>
 <dd>
 reference to send function
-</dd><dt><i>fx</i> (str)</dt>
+</dd>
+<dt><i>fx</i> (str)</dt>
 <dd>
 registered service name
-</dd><dt><i>cancelled</i> (func)</dt>
+</dd>
+<dt><i>cancelled</i> (func)</dt>
 <dd>
 reference to function checking for a cancellation
-</dd><dt><i>maxProcesses</i> (int)</dt>
+</dd>
+<dt><i>maxProcesses</i> (int)</dt>
 <dd>
 number of processes to be used
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
 <a NAME="check" ID="check"></a>
 <h2>check</h2>
 <b>check</b>(<i>file, text=""</i>)
+
 <p>
     Private function to check one Python source file for whitespace related
     problems.
-</p><dl>
+</p>
+<dl>
+
 <dt><i>file</i></dt>
 <dd>
 source filename (string)
-</dd><dt><i>text</i></dt>
+</dd>
+<dt><i>text</i></dt>
 <dd>
 source text (string)
 </dd>
-</dl><dl>
+</dl>
+<dl>
 <dt>Returns:</dt>
 <dd>
 A tuple indicating status (True = an error was found), the
@@ -398,79 +512,101 @@
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
 <a NAME="format_witnesses" ID="format_witnesses"></a>
 <h2>format_witnesses</h2>
 <b>format_witnesses</b>(<i>w</i>)
+
 <p>
     Function to format the witnesses as a readable string.
-</p><dl>
+</p>
+<dl>
+
 <dt><i>w</i></dt>
 <dd>
 A list of witnesses
 </dd>
-</dl><dl>
+</dl>
+<dl>
 <dt>Returns:</dt>
 <dd>
 A formated string of the witnesses.
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
 <a NAME="initBatchService" ID="initBatchService"></a>
 <h2>initBatchService</h2>
 <b>initBatchService</b>(<i></i>)
+
 <p>
     Initialize the batch service and return the entry point.
-</p><dl>
+</p>
+<dl>
 <dt>Returns:</dt>
 <dd>
 the entry point for the background client (function)
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
 <a NAME="initService" ID="initService"></a>
 <h2>initService</h2>
 <b>initService</b>(<i></i>)
+
 <p>
     Initialize the service and return the entry point.
-</p><dl>
+</p>
+<dl>
 <dt>Returns:</dt>
 <dd>
 the entry point for the background client (function)
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
 <a NAME="process_tokens" ID="process_tokens"></a>
 <h2>process_tokens</h2>
 <b>process_tokens</b>(<i>tokens</i>)
+
 <p>
     Function processing all tokens generated by a tokenizer run.
-</p><dl>
+</p>
+<dl>
+
 <dt><i>tokens</i></dt>
 <dd>
 list of tokens
 </dd>
-</dl><dl>
+</dl>
+<dl>
+
 <dt>Raises <b>NannyNag</b>:</dt>
 <dd>
 raised to indicate an indentation error
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
 <a NAME="worker" ID="worker"></a>
 <h2>worker</h2>
 <b>worker</b>(<i>inputQueue, outputQueue</i>)
+
 <p>
     Module function acting as the parallel worker for the style check.
-</p><dl>
+</p>
+<dl>
+
 <dt><i>inputQueue</i></dt>
 <dd>
 input queue (multiprocessing.Queue)
-</dd><dt><i>outputQueue</i></dt>
+</dd>
+<dt><i>outputQueue</i></dt>
 <dd>
 output queue (multiprocessing.Queue)
 </dd>

eric ide

mercurial