Documentation/Source/eric5.Plugins.CheckerPlugins.Pep8.pep8.html

Fri, 07 Mar 2014 19:15:46 +0100

author
Detlev Offenbach <detlev@die-offenbachs.de>
date
Fri, 07 Mar 2014 19:15:46 +0100
changeset 3342
f8cd11fa94ed
parent 2923
01ac1f364b38
permissions
-rw-r--r--

Fixed an issue in the Mercurial status dialog causing the Add button menu to have largefiles entries enabled even when the extension is not active.

2387
2d119e79ab54 Regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2386
diff changeset
1 <!DOCTYPE html>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
2 <html><head>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
3 <title>eric5.Plugins.CheckerPlugins.Pep8.pep8</title>
2387
2d119e79ab54 Regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2386
diff changeset
4 <meta charset="UTF-8">
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
5 <style>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
6 body {
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
7 background: #EDECE6;
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
8 margin: 0em 1em 10em 1em;
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
9 color: black;
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
10 }
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
11
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
12 h1 { color: white; background: #85774A; }
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
13 h2 { color: white; background: #85774A; }
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
14 h3 { color: white; background: #9D936E; }
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
15 h4 { color: white; background: #9D936E; }
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
16
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
17 a { color: #BA6D36; }
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
18
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
19 </style>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
20 </head>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
21 <body><a NAME="top" ID="top"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
22 <h1>eric5.Plugins.CheckerPlugins.Pep8.pep8</h1>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
23
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
24 <h3>Global Attributes</h3>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
25 <table>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
26 <tr><td>ARITHMETIC_OP</td></tr><tr><td>BENCHMARK_KEYS</td></tr><tr><td>COMMENT_WITH_NL</td></tr><tr><td>COMPARE_SINGLETON_REGEX</td></tr><tr><td>COMPARE_TYPE_REGEX</td></tr><tr><td>DEFAULT_EXCLUDE</td></tr><tr><td>DEFAULT_IGNORE</td></tr><tr><td>DOCSTRING_REGEX</td></tr><tr><td>ERRORCODE_REGEX</td></tr><tr><td>EXTRANEOUS_WHITESPACE_REGEX</td></tr><tr><td>HUNK_REGEX</td></tr><tr><td>INDENT_REGEX</td></tr><tr><td>KEYWORDS</td></tr><tr><td>KEYWORD_REGEX</td></tr><tr><td>LAMBDA_REGEX</td></tr><tr><td>MAX_LINE_LENGTH</td></tr><tr><td>OPERATOR_REGEX</td></tr><tr><td>PROJECT_CONFIG</td></tr><tr><td>PyCF_ONLY_AST</td></tr><tr><td>RAISE_COMMA_REGEX</td></tr><tr><td>REPORT_FORMAT</td></tr><tr><td>RERAISE_COMMA_REGEX</td></tr><tr><td>SINGLETONS</td></tr><tr><td>SKIP_TOKENS</td></tr><tr><td>TESTSUITE_PATH</td></tr><tr><td>UNARY_OPERATORS</td></tr><tr><td>WHITESPACE</td></tr><tr><td>WHITESPACE_AFTER_COMMA_REGEX</td></tr><tr><td>WS_NEEDED_OPERATORS</td></tr><tr><td>WS_OPTIONAL_OPERATORS</td></tr><tr><td>__version__</td></tr><tr><td>_checks</td></tr><tr><td>noqa</td></tr><tr><td>pep8_messages</td></tr><tr><td>pep8_messages_sample_args</td></tr>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
27 </table>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
28 <h3>Classes</h3>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
29 <table>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
30 <tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
31 <td><a href="#BaseReport">BaseReport</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
32 <td>Collect the results of the checks.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
33 </tr><tr>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
34 <td><a href="#Checker">Checker</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
35 <td>Load a Python source file, tokenize it, check coding style.</td>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
36 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
37 <td><a href="#DiffReport">DiffReport</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
38 <td>Collect and print the results for the changed lines only.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
39 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
40 <td><a href="#FileReport">FileReport</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
41 <td>Collect the results of the checks and print only the filenames.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
42 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
43 <td><a href="#StandardReport">StandardReport</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
44 <td>Collect and print the results of the checks.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
45 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
46 <td><a href="#StyleGuide">StyleGuide</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
47 <td>Initialize a PEP-8 instance with few options.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
48 </tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
49 </table>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
50 <h3>Functions</h3>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
51 <table>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
52 <tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
53 <td><a href="#_add_check">_add_check</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
54 <td></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
55 </tr><tr>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
56 <td><a href="#_main">_main</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
57 <td>Parse options and run checks on Python source.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
58 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
59 <td><a href="#blank_lines">blank_lines</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
60 <td>Separate top-level function and class definitions with two blank lines.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
61 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
62 <td><a href="#comparison_to_singleton">comparison_to_singleton</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
63 <td>Comparisons to singletons like None should always be done with "is" or "is not", never the equality operators.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
64 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
65 <td><a href="#comparison_type">comparison_type</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
66 <td>Object type comparisons should always use isinstance() instead of comparing types directly.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
67 </tr><tr>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
68 <td><a href="#compound_statements">compound_statements</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
69 <td>Compound statements (multiple statements on the same line) are generally discouraged.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
70 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
71 <td><a href="#continued_indentation">continued_indentation</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
72 <td>Continuation lines should align wrapped elements either vertically using Python's implicit line joining inside parentheses, brackets and braces, or using a hanging indent.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
73 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
74 <td><a href="#expand_indent">expand_indent</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
75 <td>Return the amount of indentation.</td>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
76 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
77 <td><a href="#explicit_line_join">explicit_line_join</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
78 <td>Avoid explicit line join between brackets.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
79 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
80 <td><a href="#extraneous_whitespace">extraneous_whitespace</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
81 <td>Avoid extraneous whitespace in the following situations:</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
82 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
83 <td><a href="#filename_match">filename_match</a></td>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
84 <td>Check if patterns contains a pattern that matches filename.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
85 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
86 <td><a href="#getMessage">getMessage</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
87 <td>Function to get a translated and formatted message for a given code.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
88 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
89 <td><a href="#get_parser">get_parser</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
90 <td></td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
91 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
92 <td><a href="#imports_on_separate_lines">imports_on_separate_lines</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
93 <td>Imports should usually be on separate lines.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
94 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
95 <td><a href="#indentation">indentation</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
96 <td>Use 4 spaces per indentation level.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
97 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
98 <td><a href="#init_checks_registry">init_checks_registry</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
99 <td>Register all globally visible functions where the first argument name is 'physical_line' or 'logical_line'.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
100 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
101 <td><a href="#maximum_line_length">maximum_line_length</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
102 <td>Limit all lines to a maximum of 79 characters.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
103 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
104 <td><a href="#missing_newline">missing_newline</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
105 <td>JCR: The last line should have a newline.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
106 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
107 <td><a href="#missing_whitespace">missing_whitespace</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
108 <td>JCR: Each comma, semicolon or colon should be followed by whitespace.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
109 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
110 <td><a href="#missing_whitespace_around_operator">missing_whitespace_around_operator</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
111 <td>- Always surround these binary operators with a single space on either side: assignment (=), augmented assignment (+=, -= etc.), comparisons (==, <, >, !=, <>, <=, >=, in, not in, is, is not), Booleans (and, or, not).</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
112 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
113 <td><a href="#mute_string">mute_string</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
114 <td>Replace contents with 'xxx' to prevent syntax matching.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
115 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
116 <td><a href="#parse_udiff">parse_udiff</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
117 <td>Return a dictionary of matching lines.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
118 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
119 <td><a href="#process_options">process_options</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
120 <td>Process options passed either via arglist or via command line args.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
121 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
122 <td><a href="#python_3000_backticks">python_3000_backticks</a></td>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
123 <td>Backticks are removed in Python 3.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
124 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
125 <td><a href="#python_3000_has_key">python_3000_has_key</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
126 <td>The {}.has_key() method is removed in the Python 3.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
127 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
128 <td><a href="#python_3000_not_equal">python_3000_not_equal</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
129 <td>!= can also be written <>, but this is an obsolete usage kept for backwards compatibility only.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
130 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
131 <td><a href="#python_3000_raise_comma">python_3000_raise_comma</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
132 <td>When raising an exception, use "raise ValueError('message')" instead of the older form "raise ValueError, 'message'".</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
133 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
134 <td><a href="#read_config">read_config</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
135 <td>Read both user configuration and local configuration.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
136 </tr><tr>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
137 <td><a href="#readlines">readlines</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
138 <td></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
139 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
140 <td><a href="#readlines_1">readlines</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
141 <td></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
142 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
143 <td><a href="#register_check">register_check</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
144 <td>Register a new check object.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
145 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
146 <td><a href="#stdin_get_value">stdin_get_value</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
147 <td></td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
148 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
149 <td><a href="#tabs_obsolete">tabs_obsolete</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
150 <td>For new projects, spaces-only are strongly recommended over tabs.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
151 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
152 <td><a href="#tabs_or_spaces">tabs_or_spaces</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
153 <td>Never mix tabs and spaces.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
154 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
155 <td><a href="#trailing_blank_lines">trailing_blank_lines</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
156 <td>JCR: Trailing blank lines are superfluous.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
157 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
158 <td><a href="#trailing_whitespace">trailing_whitespace</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
159 <td>JCR: Trailing whitespace is superfluous.</td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
160 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
161 <td><a href="#whitespace_around_comma">whitespace_around_comma</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
162 <td>Avoid extraneous whitespace in the following situations:</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
163 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
164 <td><a href="#whitespace_around_keywords">whitespace_around_keywords</a></td>
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
165 <td>Avoid extraneous whitespace around keywords.</td>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
166 </tr><tr>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
167 <td><a href="#whitespace_around_named_parameter_equals">whitespace_around_named_parameter_equals</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
168 <td>Don't use spaces around the '=' sign when used to indicate a keyword argument or a default parameter value.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
169 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
170 <td><a href="#whitespace_around_operator">whitespace_around_operator</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
171 <td>Avoid extraneous whitespace in the following situations:</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
172 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
173 <td><a href="#whitespace_before_inline_comment">whitespace_before_inline_comment</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
174 <td>Separate inline comments by at least two spaces.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
175 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
176 <td><a href="#whitespace_before_parameters">whitespace_before_parameters</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
177 <td>Avoid extraneous whitespace in the following situations:</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
178 </tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
179 </table>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
180 <hr /><hr />
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
181 <a NAME="BaseReport" ID="BaseReport"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
182 <h2>BaseReport</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
183 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
184 Collect the results of the checks.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
185 </p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
186 <h3>Derived from</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
187 object
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
188 <h3>Class Attributes</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
189 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
190 <tr><td>print_filename</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
191 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
192 <h3>Class Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
193 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
194 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
195 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
196 <h3>Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
197 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
198 <tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
199 <td><a href="#BaseReport.__init__">BaseReport</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
200 <td></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
201 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
202 <td><a href="#BaseReport.error">error</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
203 <td>Report an error, according to options.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
204 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
205 <td><a href="#BaseReport.error_args">error_args</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
206 <td>Report an error, according to options.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
207 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
208 <td><a href="#BaseReport.get_count">get_count</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
209 <td>Return the total count of errors and warnings.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
210 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
211 <td><a href="#BaseReport.get_file_results">get_file_results</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
212 <td>Return the count of errors and warnings for this file.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
213 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
214 <td><a href="#BaseReport.get_statistics">get_statistics</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
215 <td>Get statistics for message codes that start with the prefix.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
216 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
217 <td><a href="#BaseReport.increment_logical_line">increment_logical_line</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
218 <td>Signal a new logical line.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
219 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
220 <td><a href="#BaseReport.init_file">init_file</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
221 <td>Signal a new file.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
222 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
223 <td><a href="#BaseReport.print_benchmark">print_benchmark</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
224 <td>Print benchmark numbers.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
225 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
226 <td><a href="#BaseReport.print_statistics">print_statistics</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
227 <td>Print overall statistics (number of errors and warnings).</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
228 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
229 <td><a href="#BaseReport.start">start</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
230 <td>Start the timer.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
231 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
232 <td><a href="#BaseReport.stop">stop</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
233 <td>Stop the timer.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
234 </tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
235 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
236 <h3>Static Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
237 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
238 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
239 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
240 <a NAME="BaseReport.__init__" ID="BaseReport.__init__"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
241 <h4>BaseReport (Constructor)</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
242 <b>BaseReport</b>(<i>options</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
243 <a NAME="BaseReport.error" ID="BaseReport.error"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
244 <h4>BaseReport.error</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
245 <b>error</b>(<i>line_number, offset, text, check</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
246 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
247 Report an error, according to options.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
248 </p><a NAME="BaseReport.error_args" ID="BaseReport.error_args"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
249 <h4>BaseReport.error_args</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
250 <b>error_args</b>(<i>line_number, offset, code, check, *args</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
251 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
252 Report an error, according to options.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
253 </p><a NAME="BaseReport.get_count" ID="BaseReport.get_count"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
254 <h4>BaseReport.get_count</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
255 <b>get_count</b>(<i>prefix=''</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
256 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
257 Return the total count of errors and warnings.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
258 </p><a NAME="BaseReport.get_file_results" ID="BaseReport.get_file_results"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
259 <h4>BaseReport.get_file_results</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
260 <b>get_file_results</b>(<i></i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
261 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
262 Return the count of errors and warnings for this file.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
263 </p><a NAME="BaseReport.get_statistics" ID="BaseReport.get_statistics"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
264 <h4>BaseReport.get_statistics</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
265 <b>get_statistics</b>(<i>prefix=''</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
266 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
267 Get statistics for message codes that start with the prefix.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
268 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
269 prefix='' matches all errors and warnings
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
270 prefix='E' matches all errors
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
271 prefix='W' matches all warnings
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
272 prefix='E4' matches all errors that have to do with imports
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
273 </p><a NAME="BaseReport.increment_logical_line" ID="BaseReport.increment_logical_line"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
274 <h4>BaseReport.increment_logical_line</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
275 <b>increment_logical_line</b>(<i></i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
276 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
277 Signal a new logical line.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
278 </p><a NAME="BaseReport.init_file" ID="BaseReport.init_file"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
279 <h4>BaseReport.init_file</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
280 <b>init_file</b>(<i>filename, lines, expected, line_offset</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
281 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
282 Signal a new file.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
283 </p><a NAME="BaseReport.print_benchmark" ID="BaseReport.print_benchmark"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
284 <h4>BaseReport.print_benchmark</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
285 <b>print_benchmark</b>(<i></i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
286 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
287 Print benchmark numbers.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
288 </p><a NAME="BaseReport.print_statistics" ID="BaseReport.print_statistics"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
289 <h4>BaseReport.print_statistics</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
290 <b>print_statistics</b>(<i>prefix=''</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
291 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
292 Print overall statistics (number of errors and warnings).
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
293 </p><a NAME="BaseReport.start" ID="BaseReport.start"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
294 <h4>BaseReport.start</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
295 <b>start</b>(<i></i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
296 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
297 Start the timer.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
298 </p><a NAME="BaseReport.stop" ID="BaseReport.stop"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
299 <h4>BaseReport.stop</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
300 <b>stop</b>(<i></i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
301 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
302 Stop the timer.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
303 </p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
304 <div align="right"><a href="#top">Up</a></div>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
305 <hr /><hr />
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
306 <a NAME="Checker" ID="Checker"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
307 <h2>Checker</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
308 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
309 Load a Python source file, tokenize it, check coding style.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
310 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
311 <h3>Derived from</h3>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
312 object
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
313 <h3>Class Attributes</h3>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
314 <table>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
315 <tr><td>None</td></tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
316 </table>
1228
7afaf2fca55b Updated source docu with new soutce documentor.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 832
diff changeset
317 <h3>Class Methods</h3>
7afaf2fca55b Updated source docu with new soutce documentor.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 832
diff changeset
318 <table>
7afaf2fca55b Updated source docu with new soutce documentor.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 832
diff changeset
319 <tr><td>None</td></tr>
7afaf2fca55b Updated source docu with new soutce documentor.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 832
diff changeset
320 </table>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
321 <h3>Methods</h3>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
322 <table>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
323 <tr>
1229
a8207dc73672 Fixed an issue in the source documentor and regenerated the source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 1228
diff changeset
324 <td><a href="#Checker.__init__">Checker</a></td>
a8207dc73672 Fixed an issue in the source documentor and regenerated the source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 1228
diff changeset
325 <td></td>
a8207dc73672 Fixed an issue in the source documentor and regenerated the source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 1228
diff changeset
326 </tr><tr>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
327 <td><a href="#Checker.build_tokens_line">build_tokens_line</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
328 <td>Build a logical line from tokens.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
329 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
330 <td><a href="#Checker.check_all">check_all</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
331 <td>Run all checks on the input file.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
332 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
333 <td><a href="#Checker.check_ast">check_ast</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
334 <td></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
335 </tr><tr>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
336 <td><a href="#Checker.check_logical">check_logical</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
337 <td>Build a line from tokens and run all logical checks on it.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
338 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
339 <td><a href="#Checker.check_physical">check_physical</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
340 <td>Run all physical checks on a raw input line.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
341 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
342 <td><a href="#Checker.generate_tokens">generate_tokens</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
343 <td></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
344 </tr><tr>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
345 <td><a href="#Checker.readline">readline</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
346 <td>Get the next line from the input buffer.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
347 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
348 <td><a href="#Checker.readline_check_physical">readline_check_physical</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
349 <td>Check and return the next physical line.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
350 </tr><tr>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
351 <td><a href="#Checker.report_invalid_syntax">report_invalid_syntax</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
352 <td></td>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
353 </tr><tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
354 <td><a href="#Checker.run_check">run_check</a></td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
355 <td>Run a check plugin.</td>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
356 </tr>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
357 </table>
1228
7afaf2fca55b Updated source docu with new soutce documentor.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 832
diff changeset
358 <h3>Static Methods</h3>
7afaf2fca55b Updated source docu with new soutce documentor.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 832
diff changeset
359 <table>
7afaf2fca55b Updated source docu with new soutce documentor.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 832
diff changeset
360 <tr><td>None</td></tr>
7afaf2fca55b Updated source docu with new soutce documentor.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 832
diff changeset
361 </table>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
362 <a NAME="Checker.__init__" ID="Checker.__init__"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
363 <h4>Checker (Constructor)</h4>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
364 <b>Checker</b>(<i>filename=None, lines=None, options=None, report=None, **kwargs</i>)
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
365 <a NAME="Checker.build_tokens_line" ID="Checker.build_tokens_line"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
366 <h4>Checker.build_tokens_line</h4>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
367 <b>build_tokens_line</b>(<i></i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
368 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
369 Build a logical line from tokens.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
370 </p><a NAME="Checker.check_all" ID="Checker.check_all"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
371 <h4>Checker.check_all</h4>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
372 <b>check_all</b>(<i>expected=None, line_offset=0</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
373 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
374 Run all checks on the input file.
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
375 </p><a NAME="Checker.check_ast" ID="Checker.check_ast"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
376 <h4>Checker.check_ast</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
377 <b>check_ast</b>(<i></i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
378 <a NAME="Checker.check_logical" ID="Checker.check_logical"></a>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
379 <h4>Checker.check_logical</h4>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
380 <b>check_logical</b>(<i></i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
381 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
382 Build a line from tokens and run all logical checks on it.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
383 </p><a NAME="Checker.check_physical" ID="Checker.check_physical"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
384 <h4>Checker.check_physical</h4>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
385 <b>check_physical</b>(<i>line</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
386 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
387 Run all physical checks on a raw input line.
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
388 </p><a NAME="Checker.generate_tokens" ID="Checker.generate_tokens"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
389 <h4>Checker.generate_tokens</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
390 <b>generate_tokens</b>(<i></i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
391 <a NAME="Checker.readline" ID="Checker.readline"></a>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
392 <h4>Checker.readline</h4>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
393 <b>readline</b>(<i></i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
394 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
395 Get the next line from the input buffer.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
396 </p><a NAME="Checker.readline_check_physical" ID="Checker.readline_check_physical"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
397 <h4>Checker.readline_check_physical</h4>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
398 <b>readline_check_physical</b>(<i></i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
399 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
400 Check and return the next physical line. This method can be
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
401 used to feed tokenize.generate_tokens.
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
402 </p><a NAME="Checker.report_invalid_syntax" ID="Checker.report_invalid_syntax"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
403 <h4>Checker.report_invalid_syntax</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
404 <b>report_invalid_syntax</b>(<i></i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
405 <a NAME="Checker.run_check" ID="Checker.run_check"></a>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
406 <h4>Checker.run_check</h4>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
407 <b>run_check</b>(<i>check, argument_names</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
408 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
409 Run a check plugin.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
410 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
411 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
412 <hr /><hr />
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
413 <a NAME="DiffReport" ID="DiffReport"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
414 <h2>DiffReport</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
415 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
416 Collect and print the results for the changed lines only.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
417 </p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
418 <h3>Derived from</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
419 StandardReport
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
420 <h3>Class Attributes</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
421 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
422 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
423 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
424 <h3>Class Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
425 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
426 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
427 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
428 <h3>Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
429 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
430 <tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
431 <td><a href="#DiffReport.__init__">DiffReport</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
432 <td></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
433 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
434 <td><a href="#DiffReport.error">error</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
435 <td></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
436 </tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
437 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
438 <h3>Static Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
439 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
440 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
441 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
442 <a NAME="DiffReport.__init__" ID="DiffReport.__init__"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
443 <h4>DiffReport (Constructor)</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
444 <b>DiffReport</b>(<i>options</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
445 <a NAME="DiffReport.error" ID="DiffReport.error"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
446 <h4>DiffReport.error</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
447 <b>error</b>(<i>line_number, offset, text, check</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
448
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
449 <div align="right"><a href="#top">Up</a></div>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
450 <hr /><hr />
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
451 <a NAME="FileReport" ID="FileReport"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
452 <h2>FileReport</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
453 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
454 Collect the results of the checks and print only the filenames.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
455 </p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
456 <h3>Derived from</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
457 BaseReport
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
458 <h3>Class Attributes</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
459 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
460 <tr><td>print_filename</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
461 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
462 <h3>Class Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
463 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
464 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
465 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
466 <h3>Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
467 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
468 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
469 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
470 <h3>Static Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
471 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
472 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
473 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
474
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
475 <div align="right"><a href="#top">Up</a></div>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
476 <hr /><hr />
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
477 <a NAME="StandardReport" ID="StandardReport"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
478 <h2>StandardReport</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
479 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
480 Collect and print the results of the checks.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
481 </p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
482 <h3>Derived from</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
483 BaseReport
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
484 <h3>Class Attributes</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
485 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
486 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
487 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
488 <h3>Class Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
489 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
490 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
491 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
492 <h3>Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
493 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
494 <tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
495 <td><a href="#StandardReport.__init__">StandardReport</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
496 <td></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
497 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
498 <td><a href="#StandardReport.error">error</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
499 <td>Report an error, according to options.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
500 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
501 <td><a href="#StandardReport.error_args">error_args</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
502 <td>Report an error, according to options.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
503 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
504 <td><a href="#StandardReport.get_file_results">get_file_results</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
505 <td>Print the result and return the overall count for this file.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
506 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
507 <td><a href="#StandardReport.init_file">init_file</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
508 <td>Signal a new file.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
509 </tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
510 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
511 <h3>Static Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
512 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
513 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
514 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
515 <a NAME="StandardReport.__init__" ID="StandardReport.__init__"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
516 <h4>StandardReport (Constructor)</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
517 <b>StandardReport</b>(<i>options</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
518 <a NAME="StandardReport.error" ID="StandardReport.error"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
519 <h4>StandardReport.error</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
520 <b>error</b>(<i>line_number, offset, text, check</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
521 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
522 Report an error, according to options.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
523 </p><a NAME="StandardReport.error_args" ID="StandardReport.error_args"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
524 <h4>StandardReport.error_args</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
525 <b>error_args</b>(<i>line_number, offset, code, check, *args</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
526 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
527 Report an error, according to options.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
528 </p><a NAME="StandardReport.get_file_results" ID="StandardReport.get_file_results"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
529 <h4>StandardReport.get_file_results</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
530 <b>get_file_results</b>(<i></i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
531 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
532 Print the result and return the overall count for this file.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
533 </p><a NAME="StandardReport.init_file" ID="StandardReport.init_file"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
534 <h4>StandardReport.init_file</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
535 <b>init_file</b>(<i>filename, lines, expected, line_offset</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
536 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
537 Signal a new file.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
538 </p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
539 <div align="right"><a href="#top">Up</a></div>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
540 <hr /><hr />
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
541 <a NAME="StyleGuide" ID="StyleGuide"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
542 <h2>StyleGuide</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
543 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
544 Initialize a PEP-8 instance with few options.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
545 </p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
546 <h3>Derived from</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
547 object
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
548 <h3>Class Attributes</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
549 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
550 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
551 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
552 <h3>Class Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
553 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
554 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
555 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
556 <h3>Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
557 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
558 <tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
559 <td><a href="#StyleGuide.__init__">StyleGuide</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
560 <td></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
561 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
562 <td><a href="#StyleGuide.check_files">check_files</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
563 <td>Run all checks on the paths.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
564 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
565 <td><a href="#StyleGuide.excluded">excluded</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
566 <td>Check if options.exclude contains a pattern that matches filename.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
567 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
568 <td><a href="#StyleGuide.get_checks">get_checks</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
569 <td>Find all globally visible functions where the first argument name starts with argument_name and which contain selected tests.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
570 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
571 <td><a href="#StyleGuide.ignore_code">ignore_code</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
572 <td>Check if the error code should be ignored.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
573 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
574 <td><a href="#StyleGuide.init_report">init_report</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
575 <td>Initialize the report instance.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
576 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
577 <td><a href="#StyleGuide.input_dir">input_dir</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
578 <td>Check all files in this directory and all subdirectories.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
579 </tr><tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
580 <td><a href="#StyleGuide.input_file">input_file</a></td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
581 <td>Run all checks on a Python source file.</td>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
582 </tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
583 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
584 <h3>Static Methods</h3>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
585 <table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
586 <tr><td>None</td></tr>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
587 </table>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
588 <a NAME="StyleGuide.__init__" ID="StyleGuide.__init__"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
589 <h4>StyleGuide (Constructor)</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
590 <b>StyleGuide</b>(<i>*args, **kwargs</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
591 <a NAME="StyleGuide.check_files" ID="StyleGuide.check_files"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
592 <h4>StyleGuide.check_files</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
593 <b>check_files</b>(<i>paths=None</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
594 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
595 Run all checks on the paths.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
596 </p><a NAME="StyleGuide.excluded" ID="StyleGuide.excluded"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
597 <h4>StyleGuide.excluded</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
598 <b>excluded</b>(<i>filename, parent=None</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
599 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
600 Check if options.exclude contains a pattern that matches filename.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
601 </p><a NAME="StyleGuide.get_checks" ID="StyleGuide.get_checks"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
602 <h4>StyleGuide.get_checks</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
603 <b>get_checks</b>(<i>argument_name</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
604 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
605 Find all globally visible functions where the first argument name
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
606 starts with argument_name and which contain selected tests.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
607 </p><a NAME="StyleGuide.ignore_code" ID="StyleGuide.ignore_code"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
608 <h4>StyleGuide.ignore_code</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
609 <b>ignore_code</b>(<i>code</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
610 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
611 Check if the error code should be ignored.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
612 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
613 If 'options.select' contains a prefix of the error code,
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
614 return False. Else, if 'options.ignore' contains a prefix of
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
615 the error code, return True.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
616 </p><a NAME="StyleGuide.init_report" ID="StyleGuide.init_report"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
617 <h4>StyleGuide.init_report</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
618 <b>init_report</b>(<i>reporter=None</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
619 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
620 Initialize the report instance.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
621 </p><a NAME="StyleGuide.input_dir" ID="StyleGuide.input_dir"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
622 <h4>StyleGuide.input_dir</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
623 <b>input_dir</b>(<i>dirname</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
624 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
625 Check all files in this directory and all subdirectories.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
626 </p><a NAME="StyleGuide.input_file" ID="StyleGuide.input_file"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
627 <h4>StyleGuide.input_file</h4>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
628 <b>input_file</b>(<i>filename, lines=None, expected=None, line_offset=0</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
629 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
630 Run all checks on a Python source file.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
631 </p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
632 <div align="right"><a href="#top">Up</a></div>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
633 <hr /><hr />
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
634 <a NAME="_add_check" ID="_add_check"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
635 <h2>_add_check</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
636 <b>_add_check</b>(<i>check, kind, codes, args</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
637
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
638 <div align="right"><a href="#top">Up</a></div>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
639 <hr /><hr />
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
640 <a NAME="_main" ID="_main"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
641 <h2>_main</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
642 <b>_main</b>(<i></i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
643 <p>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
644 Parse options and run checks on Python source.
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
645 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
646 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
647 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
648 <a NAME="blank_lines" ID="blank_lines"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
649 <h2>blank_lines</h2>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
650 <b>blank_lines</b>(<i>logical_line, blank_lines, indent_level, line_number, previous_logical, previous_indent_level</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
651 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
652 Separate top-level function and class definitions with two blank lines.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
653 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
654 Method definitions inside a class are separated by a single blank line.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
655 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
656 Extra blank lines may be used (sparingly) to separate groups of related
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
657 functions. Blank lines may be omitted between a bunch of related
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
658 one-liners (e.g. a set of dummy implementations).
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
659 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
660 Use blank lines in functions, sparingly, to indicate logical sections.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
661 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
662 Okay: def a():\n pass\n\n\ndef b():\n pass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
663 Okay: def a():\n pass\n\n\n# Foo\n# Bar\n\ndef b():\n pass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
664 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
665 E301: class Foo:\n b = 0\n def bar():\n pass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
666 E302: def a():\n pass\n\ndef b(n):\n pass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
667 E303: def a():\n pass\n\n\n\ndef b(n):\n pass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
668 E303: def a():\n\n\n\n pass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
669 E304: @decorator\n\ndef a():\n pass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
670 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
671 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
672 <hr /><hr />
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
673 <a NAME="comparison_to_singleton" ID="comparison_to_singleton"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
674 <h2>comparison_to_singleton</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
675 <b>comparison_to_singleton</b>(<i>logical_line, noqa</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
676 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
677 Comparisons to singletons like None should always be done
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
678 with "is" or "is not", never the equality operators.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
679 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
680 Okay: if arg is not None:
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
681 E711: if arg != None:
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
682 E712: if arg == True:
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
683 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
684 Also, beware of writing if x when you really mean if x is not None --
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
685 e.g. when testing whether a variable or argument that defaults to None was
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
686 set to some other value. The other value might have a type (such as a
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
687 container) that could be false in a boolean context!
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
688 </p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
689 <div align="right"><a href="#top">Up</a></div>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
690 <hr /><hr />
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
691 <a NAME="comparison_type" ID="comparison_type"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
692 <h2>comparison_type</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
693 <b>comparison_type</b>(<i>logical_line</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
694 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
695 Object type comparisons should always use isinstance() instead of
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
696 comparing types directly.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
697 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
698 Okay: if isinstance(obj, int):
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
699 E721: if type(obj) is type(1):
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
700 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
701 When checking if an object is a string, keep in mind that it might be a
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
702 unicode string too! In Python 2.3, str and unicode have a common base
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
703 class, basestring, so you can do:
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
704 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
705 Okay: if isinstance(obj, basestring):
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
706 Okay: if type(a1) is type(b1):
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
707 </p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
708 <div align="right"><a href="#top">Up</a></div>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
709 <hr /><hr />
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
710 <a NAME="compound_statements" ID="compound_statements"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
711 <h2>compound_statements</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
712 <b>compound_statements</b>(<i>logical_line</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
713 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
714 Compound statements (multiple statements on the same line) are
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
715 generally discouraged.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
716 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
717 While sometimes it's okay to put an if/for/while with a small body
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
718 on the same line, never do this for multi-clause statements. Also
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
719 avoid folding such long lines!
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
720 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
721 Okay: if foo == 'blah':\n do_blah_thing()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
722 Okay: do_one()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
723 Okay: do_two()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
724 Okay: do_three()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
725 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
726 E701: if foo == 'blah': do_blah_thing()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
727 E701: for x in lst: total += x
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
728 E701: while t < 10: t = delay()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
729 E701: if foo == 'blah': do_blah_thing()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
730 E701: else: do_non_blah_thing()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
731 E701: try: something()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
732 E701: finally: cleanup()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
733 E701: if foo == 'blah': one(); two(); three()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
734 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
735 E702: do_one(); do_two(); do_three()
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
736 E703: do_four(); # useless semicolon
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
737 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
738 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
739 <hr /><hr />
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
740 <a NAME="continued_indentation" ID="continued_indentation"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
741 <h2>continued_indentation</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
742 <b>continued_indentation</b>(<i>logical_line, tokens, indent_level, hang_closing, noqa, verbose</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
743 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
744 Continuation lines should align wrapped elements either vertically using
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
745 Python's implicit line joining inside parentheses, brackets and braces, or
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
746 using a hanging indent.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
747 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
748 When using a hanging indent the following considerations should be applied:
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
749 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
750 - there should be no arguments on the first line, and
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
751 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
752 - further indentation should be used to clearly distinguish itself as a
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
753 continuation line.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
754 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
755 Okay: a = (\n)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
756 E123: a = (\n )
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
757 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
758 Okay: a = (\n 42)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
759 E121: a = (\n 42)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
760 E122: a = (\n42)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
761 E123: a = (\n 42\n )
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
762 E124: a = (24,\n 42\n)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
763 E125: if (a or\n b):\n pass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
764 E126: a = (\n 42)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
765 E127: a = (24,\n 42)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
766 E128: a = (24,\n 42)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
767 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
768 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
769 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
770 <a NAME="expand_indent" ID="expand_indent"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
771 <h2>expand_indent</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
772 <b>expand_indent</b>(<i>line</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
773 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
774 Return the amount of indentation.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
775 Tabs are expanded to the next multiple of 8.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
776 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
777 >>> expand_indent(' ')
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
778 4
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
779 >>> expand_indent('\t')
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
780 8
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
781 >>> expand_indent(' \t')
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
782 8
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
783 >>> expand_indent(' \t')
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
784 8
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
785 >>> expand_indent(' \t')
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
786 16
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
787 </p>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
788 <div align="right"><a href="#top">Up</a></div>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
789 <hr /><hr />
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
790 <a NAME="explicit_line_join" ID="explicit_line_join"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
791 <h2>explicit_line_join</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
792 <b>explicit_line_join</b>(<i>logical_line, tokens</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
793 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
794 Avoid explicit line join between brackets.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
795 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
796 The preferred way of wrapping long lines is by using Python's implied line
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
797 continuation inside parentheses, brackets and braces. Long lines can be
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
798 broken over multiple lines by wrapping expressions in parentheses. These
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
799 should be used in preference to using a backslash for line continuation.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
800 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
801 E502: aaa = [123, \\n 123]
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
802 E502: aaa = ("bbb " \\n "ccc")
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
803 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
804 Okay: aaa = [123,\n 123]
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
805 Okay: aaa = ("bbb "\n "ccc")
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
806 Okay: aaa = "bbb " \\n "ccc"
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
807 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
808 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
809 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
810 <a NAME="extraneous_whitespace" ID="extraneous_whitespace"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
811 <h2>extraneous_whitespace</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
812 <b>extraneous_whitespace</b>(<i>logical_line</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
813 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
814 Avoid extraneous whitespace in the following situations:
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
815 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
816 - Immediately inside parentheses, brackets or braces.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
817 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
818 - Immediately before a comma, semicolon, or colon.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
819 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
820 Okay: spam(ham[1], {eggs: 2})
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
821 E201: spam( ham[1], {eggs: 2})
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
822 E201: spam(ham[ 1], {eggs: 2})
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
823 E201: spam(ham[1], { eggs: 2})
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
824 E202: spam(ham[1], {eggs: 2} )
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
825 E202: spam(ham[1 ], {eggs: 2})
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
826 E202: spam(ham[1], {eggs: 2 })
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
827 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
828 E203: if x == 4: print x, y; x, y = y , x
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
829 E203: if x == 4: print x, y ; x, y = y, x
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
830 E203: if x == 4 : print x, y; x, y = y, x
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
831 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
832 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
833 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
834 <a NAME="filename_match" ID="filename_match"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
835 <h2>filename_match</h2>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
836 <b>filename_match</b>(<i>filename, patterns, default=True</i>)
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
837 <p>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
838 Check if patterns contains a pattern that matches filename.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
839 If patterns is unspecified, this always returns True.
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
840 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
841 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
842 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
843 <a NAME="getMessage" ID="getMessage"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
844 <h2>getMessage</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
845 <b>getMessage</b>(<i>code, *args</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
846 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
847 Function to get a translated and formatted message for a given code.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
848 </p><dl>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
849 <dt><i>code</i></dt>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
850 <dd>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
851 message code (string)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
852 </dd><dt><i>args</i></dt>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
853 <dd>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
854 arguments for a formatted message (list)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
855 </dd>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
856 </dl><dl>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
857 <dt>Returns:</dt>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
858 <dd>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
859 translated and formatted message (string)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
860 </dd>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
861 </dl>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
862 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
863 <hr /><hr />
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
864 <a NAME="get_parser" ID="get_parser"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
865 <h2>get_parser</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
866 <b>get_parser</b>(<i>prog='pep8', version=__version__</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
867
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
868 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
869 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
870 <a NAME="imports_on_separate_lines" ID="imports_on_separate_lines"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
871 <h2>imports_on_separate_lines</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
872 <b>imports_on_separate_lines</b>(<i>logical_line</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
873 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
874 Imports should usually be on separate lines.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
875 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
876 Okay: import os\nimport sys
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
877 E401: import sys, os
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
878 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
879 Okay: from subprocess import Popen, PIPE
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
880 Okay: from myclas import MyClass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
881 Okay: from foo.bar.yourclass import YourClass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
882 Okay: import myclass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
883 Okay: import foo.bar.yourclass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
884 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
885 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
886 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
887 <a NAME="indentation" ID="indentation"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
888 <h2>indentation</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
889 <b>indentation</b>(<i>logical_line, previous_logical, indent_char, indent_level, previous_indent_level</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
890 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
891 Use 4 spaces per indentation level.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
892 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
893 For really old code that you don't want to mess up, you can continue to
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
894 use 8-space tabs.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
895 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
896 Okay: a = 1
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
897 Okay: if a == 0:\n a = 1
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
898 E111: a = 1
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
899 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
900 Okay: for item in items:\n pass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
901 E112: for item in items:\npass
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
902 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
903 Okay: a = 1\nb = 2
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
904 E113: a = 1\n b = 2
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
905 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
906 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
907 <hr /><hr />
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
908 <a NAME="init_checks_registry" ID="init_checks_registry"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
909 <h2>init_checks_registry</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
910 <b>init_checks_registry</b>(<i></i>)
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
911 <p>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
912 Register all globally visible functions where the first argument name
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
913 is 'physical_line' or 'logical_line'.
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
914 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
915 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
916 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
917 <a NAME="maximum_line_length" ID="maximum_line_length"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
918 <h2>maximum_line_length</h2>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
919 <b>maximum_line_length</b>(<i>physical_line, max_line_length</i>)
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
920 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
921 Limit all lines to a maximum of 79 characters.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
922 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
923 There are still many devices around that are limited to 80 character
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
924 lines; plus, limiting windows to 80 characters makes it possible to have
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
925 several windows side-by-side. The default wrapping on such devices looks
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
926 ugly. Therefore, please limit all lines to a maximum of 79 characters.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
927 For flowing long blocks of text (docstrings or comments), limiting the
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
928 length to 72 characters is recommended.
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
929 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
930 Reports error E501.
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
931 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
932 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
933 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
934 <a NAME="missing_newline" ID="missing_newline"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
935 <h2>missing_newline</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
936 <b>missing_newline</b>(<i>physical_line</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
937 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
938 JCR: The last line should have a newline.
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
939 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
940 Reports warning W292.
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
941 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
942 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
943 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
944 <a NAME="missing_whitespace" ID="missing_whitespace"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
945 <h2>missing_whitespace</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
946 <b>missing_whitespace</b>(<i>logical_line</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
947 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
948 JCR: Each comma, semicolon or colon should be followed by whitespace.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
949 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
950 Okay: [a, b]
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
951 Okay: (3,)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
952 Okay: a[1:4]
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
953 Okay: a[:4]
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
954 Okay: a[1:]
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
955 Okay: a[1:4:2]
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
956 E231: ['a','b']
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
957 E231: foo(bar,baz)
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
958 E231: [{'a':'b'}]
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
959 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
960 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
961 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
962 <a NAME="missing_whitespace_around_operator" ID="missing_whitespace_around_operator"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
963 <h2>missing_whitespace_around_operator</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
964 <b>missing_whitespace_around_operator</b>(<i>logical_line, tokens</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
965 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
966 - Always surround these binary operators with a single space on
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
967 either side: assignment (=), augmented assignment (+=, -= etc.),
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
968 comparisons (==, <, >, !=, <>, <=, >=, in, not in, is, is not),
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
969 Booleans (and, or, not).
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
970 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
971 - Use spaces around arithmetic operators.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
972 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
973 Okay: i = i + 1
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
974 Okay: submitted += 1
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
975 Okay: x = x * 2 - 1
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
976 Okay: hypot2 = x * x + y * y
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
977 Okay: c = (a + b) * (a - b)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
978 Okay: foo(bar, key='word', *args, **kwargs)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
979 Okay: alpha[:-i]
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
980 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
981 E225: i=i+1
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
982 E225: submitted +=1
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
983 E225: x = x /2 - 1
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
984 E225: z = x **y
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
985 E226: c = (a+b) * (a-b)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
986 E226: hypot2 = x*x + y*y
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
987 E227: c = a|b
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
988 E228: msg = fmt%(errno, errmsg)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
989 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
990 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
991 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
992 <a NAME="mute_string" ID="mute_string"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
993 <h2>mute_string</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
994 <b>mute_string</b>(<i>text</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
995 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
996 Replace contents with 'xxx' to prevent syntax matching.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
997 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
998 >>> mute_string('"abc"')
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
999 '"xxx"'
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1000 >>> mute_string("'''abc'''")
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1001 "'''xxx'''"
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1002 >>> mute_string("r'abc'")
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1003 "r'xxx'"
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1004 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1005 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1006 <hr /><hr />
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1007 <a NAME="parse_udiff" ID="parse_udiff"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1008 <h2>parse_udiff</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1009 <b>parse_udiff</b>(<i>diff, patterns=None, parent='.'</i>)
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1010 <p>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1011 Return a dictionary of matching lines.
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1012 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1013 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1014 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1015 <a NAME="process_options" ID="process_options"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1016 <h2>process_options</h2>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1017 <b>process_options</b>(<i>arglist=None, parse_argv=False, config_file=None, parser=None</i>)
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1018 <p>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1019 Process options passed either via arglist or via command line args.
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1020 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1021 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1022 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1023 <a NAME="python_3000_backticks" ID="python_3000_backticks"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1024 <h2>python_3000_backticks</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1025 <b>python_3000_backticks</b>(<i>logical_line</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1026 <p>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1027 Backticks are removed in Python 3.
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1028 Use repr() instead.
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1029 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1030 Okay: val = repr(1 + 2)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1031 W604: val = `1 + 2`
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1032 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1033 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1034 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1035 <a NAME="python_3000_has_key" ID="python_3000_has_key"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1036 <h2>python_3000_has_key</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1037 <b>python_3000_has_key</b>(<i>logical_line</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1038 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1039 The {}.has_key() method is removed in the Python 3.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1040 Use the 'in' operation instead.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1041 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1042 Okay: if "alph" in d:\n print d["alph"]
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1043 W601: assert d.has_key('alph')
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1044 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1045 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1046 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1047 <a NAME="python_3000_not_equal" ID="python_3000_not_equal"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1048 <h2>python_3000_not_equal</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1049 <b>python_3000_not_equal</b>(<i>logical_line</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1050 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1051 != can also be written <>, but this is an obsolete usage kept for
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1052 backwards compatibility only. New code should always use !=.
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1053 The older syntax is removed in Python 3.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1054 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1055 Okay: if a != 'no':
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1056 W603: if a <> 'no':
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1057 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1058 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1059 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1060 <a NAME="python_3000_raise_comma" ID="python_3000_raise_comma"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1061 <h2>python_3000_raise_comma</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1062 <b>python_3000_raise_comma</b>(<i>logical_line</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1063 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1064 When raising an exception, use "raise ValueError('message')"
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1065 instead of the older form "raise ValueError, 'message'".
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1066 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1067 The paren-using form is preferred because when the exception arguments
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1068 are long or include string formatting, you don't need to use line
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1069 continuation characters thanks to the containing parentheses. The older
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1070 form is removed in Python 3.
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1071 </p><p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1072 Okay: raise DummyError("Message")
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1073 W602: raise DummyError, "Message"
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1074 </p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1075 <div align="right"><a href="#top">Up</a></div>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1076 <hr /><hr />
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1077 <a NAME="read_config" ID="read_config"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1078 <h2>read_config</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1079 <b>read_config</b>(<i>options, args, arglist, parser</i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1080 <p>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1081 Read both user configuration and local configuration.
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1082 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1083 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1084 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1085 <a NAME="readlines" ID="readlines"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1086 <h2>readlines</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1087 <b>readlines</b>(<i>filename</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1088
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1089 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1090 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1091 <a NAME="readlines_1" ID="readlines_1"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1092 <h2>readlines</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1093 <b>readlines</b>(<i>filename</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1094
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1095 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1096 <hr /><hr />
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1097 <a NAME="register_check" ID="register_check"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1098 <h2>register_check</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1099 <b>register_check</b>(<i>check, codes=None</i>)
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1100 <p>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1101 Register a new check object.
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1102 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1103 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1104 <hr /><hr />
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1105 <a NAME="stdin_get_value" ID="stdin_get_value"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1106 <h2>stdin_get_value</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1107 <b>stdin_get_value</b>(<i></i>)
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1108
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1109 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1110 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1111 <a NAME="tabs_obsolete" ID="tabs_obsolete"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1112 <h2>tabs_obsolete</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1113 <b>tabs_obsolete</b>(<i>physical_line</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1114 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1115 For new projects, spaces-only are strongly recommended over tabs. Most
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1116 editors have features that make this easy to do.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1117 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1118 Okay: if True:\n return
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1119 W191: if True:\n\treturn
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1120 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1121 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1122 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1123 <a NAME="tabs_or_spaces" ID="tabs_or_spaces"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1124 <h2>tabs_or_spaces</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1125 <b>tabs_or_spaces</b>(<i>physical_line, indent_char</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1126 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1127 Never mix tabs and spaces.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1128 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1129 The most popular way of indenting Python is with spaces only. The
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1130 second-most popular way is with tabs only. Code indented with a mixture
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1131 of tabs and spaces should be converted to using spaces exclusively. When
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1132 invoking the Python command line interpreter with the -t option, it issues
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1133 warnings about code that illegally mixes tabs and spaces. When using -tt
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1134 these warnings become errors. These options are highly recommended!
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1135 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1136 Okay: if a == 0:\n a = 1\n b = 1
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1137 E101: if a == 0:\n a = 1\n\tb = 1
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1138 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1139 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1140 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1141 <a NAME="trailing_blank_lines" ID="trailing_blank_lines"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1142 <h2>trailing_blank_lines</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1143 <b>trailing_blank_lines</b>(<i>physical_line, lines, line_number</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1144 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1145 JCR: Trailing blank lines are superfluous.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1146 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1147 Okay: spam(1)
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1148 W391: spam(1)\n
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1149 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1150 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1151 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1152 <a NAME="trailing_whitespace" ID="trailing_whitespace"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1153 <h2>trailing_whitespace</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1154 <b>trailing_whitespace</b>(<i>physical_line</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1155 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1156 JCR: Trailing whitespace is superfluous.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1157 FBM: Except when it occurs as part of a blank line (i.e. the line is
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1158 nothing but whitespace). According to Python docs[1] a line with only
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1159 whitespace is considered a blank line, and is to be ignored. However,
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1160 matching a blank line to its indentation level avoids mistakenly
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1161 terminating a multi-line statement (e.g. class declaration) when
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1162 pasting code into the standard Python interpreter.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1163 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1164 [1] http://docs.python.org/reference/lexical_analysis.html#blank-lines
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1165 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1166 The warning returned varies on whether the line itself is blank, for easier
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1167 filtering for those who want to indent their blank lines.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1168 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1169 Okay: spam(1)\n#
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1170 W291: spam(1) \n#
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1171 W293: class Foo(object):\n \n bang = 12
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1172 </p>
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1173 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1174 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1175 <a NAME="whitespace_around_comma" ID="whitespace_around_comma"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1176 <h2>whitespace_around_comma</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1177 <b>whitespace_around_comma</b>(<i>logical_line</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1178 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1179 Avoid extraneous whitespace in the following situations:
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1180 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1181 - More than one space around an assignment (or other) operator to
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1182 align it with another.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1183 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1184 JCR: This should also be applied around comma etc.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1185 Note: these checks are disabled by default
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1186 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1187 Okay: a = (1, 2)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1188 E241: a = (1, 2)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1189 E242: a = (1,\t2)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1190 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1191 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1192 <hr /><hr />
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1193 <a NAME="whitespace_around_keywords" ID="whitespace_around_keywords"></a>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1194 <h2>whitespace_around_keywords</h2>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1195 <b>whitespace_around_keywords</b>(<i>logical_line</i>)
2923
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1196 <p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1197 Avoid extraneous whitespace around keywords.
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1198 </p><p>
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1199 Okay: True and False
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1200 E271: True and False
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1201 E272: True and False
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1202 E273: True and\tFalse
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1203 E274: True\tand False
01ac1f364b38 Started extending the PEP-8 fixer to correct PEP-257 issues as well.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2867
diff changeset
1204 </p>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1205 <div align="right"><a href="#top">Up</a></div>
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1206 <hr /><hr />
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1207 <a NAME="whitespace_around_named_parameter_equals" ID="whitespace_around_named_parameter_equals"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1208 <h2>whitespace_around_named_parameter_equals</h2>
2867
eb325d7f7335 Updated translations and regenerated source docu.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 2387
diff changeset
1209 <b>whitespace_around_named_parameter_equals</b>(<i>logical_line, tokens</i>)
832
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1210 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1211 Don't use spaces around the '=' sign when used to indicate a
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1212 keyword argument or a default parameter value.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1213 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1214 Okay: def complex(real, imag=0.0):
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1215 Okay: return magic(r=real, i=imag)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1216 Okay: boolean(a == b)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1217 Okay: boolean(a != b)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1218 Okay: boolean(a <= b)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1219 Okay: boolean(a >= b)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1220 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1221 E251: def complex(real, imag = 0.0):
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1222 E251: return magic(r = real, i = imag)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1223 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1224 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1225 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1226 <a NAME="whitespace_around_operator" ID="whitespace_around_operator"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1227 <h2>whitespace_around_operator</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1228 <b>whitespace_around_operator</b>(<i>logical_line</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1229 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1230 Avoid extraneous whitespace in the following situations:
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1231 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1232 - More than one space around an assignment (or other) operator to
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1233 align it with another.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1234 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1235 Okay: a = 12 + 3
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1236 E221: a = 4 + 5
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1237 E222: a = 4 + 5
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1238 E223: a = 4\t+ 5
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1239 E224: a = 4 +\t5
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1240 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1241 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1242 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1243 <a NAME="whitespace_before_inline_comment" ID="whitespace_before_inline_comment"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1244 <h2>whitespace_before_inline_comment</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1245 <b>whitespace_before_inline_comment</b>(<i>logical_line, tokens</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1246 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1247 Separate inline comments by at least two spaces.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1248 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1249 An inline comment is a comment on the same line as a statement. Inline
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1250 comments should be separated by at least two spaces from the statement.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1251 They should start with a # and a single space.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1252 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1253 Okay: x = x + 1 # Increment x
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1254 Okay: x = x + 1 # Increment x
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1255 E261: x = x + 1 # Increment x
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1256 E262: x = x + 1 #Increment x
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1257 E262: x = x + 1 # Increment x
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1258 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1259 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1260 <hr /><hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1261 <a NAME="whitespace_before_parameters" ID="whitespace_before_parameters"></a>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1262 <h2>whitespace_before_parameters</h2>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1263 <b>whitespace_before_parameters</b>(<i>logical_line, tokens</i>)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1264 <p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1265 Avoid extraneous whitespace in the following situations:
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1266 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1267 - Immediately before the open parenthesis that starts the argument
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1268 list of a function call.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1269 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1270 - Immediately before the open parenthesis that starts an indexing or
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1271 slicing.
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1272 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1273 Okay: spam(1)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1274 E211: spam (1)
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1275 </p><p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1276 Okay: dict['key'] = list[index]
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1277 E211: dict ['key'] = list[index]
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1278 E211: dict['key'] = list [index]
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1279 </p>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1280 <div align="right"><a href="#top">Up</a></div>
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1281 <hr />
eb5ff61f927b Added a checker for PEP 8 compliance.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1282 </body></html>

eric ide

mercurial