BENCHMARK_KEYS |
BINARY_OPERATORS |
DEFAULT_EXCLUDE |
DEFAULT_IGNORE |
DOCSTRING_REGEX |
E225NOT_KEYWORDS |
ERRORCODE_REGEX |
EXTRANEOUS_WHITESPACE_REGEX |
INDENT_REGEX |
MAX_LINE_LENGTH |
OPERATORS |
RAISE_COMMA_REGEX |
SELFTEST_REGEX |
SKIP_TOKENS |
UNARY_OPERATORS |
WHITESPACE |
WHITESPACE_AROUND_NAMED_PARAMETER_REGEX |
WHITESPACE_AROUND_OPERATOR_REGEX |
__version__ |
args |
options |
Checker | Load a Python source file, tokenize it, check coding style. |
_main | Parse options and run checks on Python source. |
blank_lines | Separate top-level function and class definitions with two blank lines. |
compound_statements | Compound statements (multiple statements on the same line) are generally discouraged. |
excluded | Check if options.exclude contains a pattern that matches filename. |
expand_indent | Return the amount of indentation. |
extraneous_whitespace | Avoid extraneous whitespace in the following situations: |
filename_match | Check if options.filename contains a pattern that matches filename. |
find_checks | Find all globally visible functions where the first argument name starts with argument_name. |
get_count | Return the total count of errors and warnings. |
get_error_statistics | Get error statistics. |
get_statistics | Get statistics for message codes that start with the prefix. |
get_warning_statistics | Get warning statistics. |
ignore_code | Check if options.ignore contains a prefix of the error code. |
imports_on_separate_lines | Imports should usually be on separate lines. |
indentation | Use 4 spaces per indentation level. |
input_dir | Check all Python source files in this directory and all subdirectories. |
input_file | Run all checks on a Python source file. |
maximum_line_length | Limit all lines to a maximum of 79 characters. |
message | Print a message. |
missing_newline | JCR: The last line should have a newline. |
missing_whitespace | JCR: Each comma, semicolon or colon should be followed by whitespace. |
missing_whitespace_around_operator | - 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). |
mute_string | Replace contents with 'xxx' to prevent syntax matching. |
print_benchmark | Print benchmark numbers. |
print_statistics | Print overall statistics (number of errors and warnings). |
process_options | Process options passed either via arglist or via command line args. |
python_3000_backticks | Backticks are removed in Python 3000. |
python_3000_has_key | The {}.has_key() method will be removed in the future version of Python. |
python_3000_not_equal | != can also be written <>, but this is an obsolete usage kept for backwards compatibility only. |
python_3000_raise_comma | When raising an exception, use "raise ValueError('message')" instead of the older form "raise ValueError, 'message'". |
readlines | |
readlines | |
reset_counters | |
run_tests | Run all the tests from a file. |
selftest | Test all check functions with test cases in docstrings. |
tabs_obsolete | For new projects, spaces-only are strongly recommended over tabs. |
tabs_or_spaces | Never mix tabs and spaces. |
trailing_blank_lines | JCR: Trailing blank lines are superfluous. |
trailing_whitespace | JCR: Trailing whitespace is superfluous. |
whitespace_around_comma | Avoid extraneous whitespace in the following situations: |
whitespace_around_named_parameter_equals | Don't use spaces around the '=' sign when used to indicate a keyword argument or a default parameter value. |
whitespace_around_operator | Avoid extraneous whitespace in the following situations: |
whitespace_before_inline_comment | Separate inline comments by at least two spaces. |
whitespace_before_parameters | Avoid extraneous whitespace in the following situations: |
Load a Python source file, tokenize it, check coding style.
None |
None |
Checker | |
build_tokens_line | Build a logical line from tokens. |
check_all | Run all checks on the input file. |
check_logical | Build a line from tokens and run all logical checks on it. |
check_physical | Run all physical checks on a raw input line. |
readline | Get the next line from the input buffer. |
readline_check_physical | Check and return the next physical line. |
report_error | Report an error, according to options. |
run_check | Run a check plugin. |
None |
Build a logical line from tokens.
Run all checks on the input file.
Build a line from tokens and run all logical checks on it.
Run all physical checks on a raw input line.
Get the next line from the input buffer.
Check and return the next physical line. This method can be used to feed tokenize.generate_tokens.
Report an error, according to options.
Run a check plugin.
Parse options and run checks on Python source.
Separate top-level function and class definitions with two blank lines.
Method definitions inside a class are separated by a single blank line.
Extra blank lines may be used (sparingly) to separate groups of related functions. Blank lines may be omitted between a bunch of related one-liners (e.g. a set of dummy implementations).
Use blank lines in functions, sparingly, to indicate logical sections.
Okay: def a():\n pass\n\n\ndef b():\n pass Okay: def a():\n pass\n\n\n# Foo\n# Bar\n\ndef b():\n pass
E301: class Foo:\n b = 0\n def bar():\n pass E302: def a():\n pass\n\ndef b(n):\n pass E303: def a():\n pass\n\n\n\ndef b(n):\n pass E303: def a():\n\n\n\n pass E304: @decorator\n\ndef a():\n pass
Compound statements (multiple statements on the same line) are generally discouraged.
While sometimes it's okay to put an if/for/while with a small body on the same line, never do this for multi-clause statements. Also avoid folding such long lines!
Okay: if foo == 'blah':\n do_blah_thing() Okay: do_one() Okay: do_two() Okay: do_three()
E701: if foo == 'blah': do_blah_thing() E701: for x in lst: total += x E701: while t < 10: t = delay() E701: if foo == 'blah': do_blah_thing() E701: else: do_non_blah_thing() E701: try: something() E701: finally: cleanup() E701: if foo == 'blah': one(); two(); three()
E702: do_one(); do_two(); do_three()
Check if options.exclude contains a pattern that matches filename.
Return the amount of indentation. Tabs are expanded to the next multiple of 8.
>>> expand_indent(' ') 4 >>> expand_indent('\\t') 8 >>> expand_indent(' \\t') 8 >>> expand_indent(' \\t') 8 >>> expand_indent(' \\t') 16
Avoid extraneous whitespace in the following situations:
- Immediately inside parentheses, brackets or braces.
- Immediately before a comma, semicolon, or colon.
Okay: spam(ham[1], {eggs: 2}) E201: spam( ham[1], {eggs: 2}) E201: spam(ham[ 1], {eggs: 2}) E201: spam(ham[1], { eggs: 2}) E202: spam(ham[1], {eggs: 2} ) E202: spam(ham[1 ], {eggs: 2}) E202: spam(ham[1], {eggs: 2 })
E203: if x == 4: print x, y; x, y = y , x E203: if x == 4: print x, y ; x, y = y, x E203: if x == 4 : print x, y; x, y = y, x
Check if options.filename contains a pattern that matches filename. If options.filename is unspecified, this always returns True.
Find all globally visible functions where the first argument name starts with argument_name.
Return the total count of errors and warnings.
Get error statistics.
Get statistics for message codes that start with the prefix.
prefix='' matches all errors and warnings prefix='E' matches all errors prefix='W' matches all warnings prefix='E4' matches all errors that have to do with imports
Get warning statistics.
Check if options.ignore contains a prefix of the error code. If options.select contains a prefix of the error code, do not ignore it.
Imports should usually be on separate lines.
Okay: import os\nimport sys E401: import sys, os
Okay: from subprocess import Popen, PIPE Okay: from myclas import MyClass Okay: from foo.bar.yourclass import YourClass Okay: import myclass Okay: import foo.bar.yourclass
Use 4 spaces per indentation level.
For really old code that you don't want to mess up, you can continue to use 8-space tabs.
Okay: a = 1 Okay: if a == 0:\n a = 1 E111: a = 1
Okay: for item in items:\n pass E112: for item in items:\npass
Okay: a = 1\nb = 2 E113: a = 1\n b = 2
Check all Python source files in this directory and all subdirectories.
Run all checks on a Python source file.
Limit all lines to a maximum of 79 characters.
There are still many devices around that are limited to 80 character lines; plus, limiting windows to 80 characters makes it possible to have several windows side-by-side. The default wrapping on such devices looks ugly. Therefore, please limit all lines to a maximum of 79 characters. For flowing long blocks of text (docstrings or comments), limiting the length to 72 characters is recommended.
Print a message.
JCR: The last line should have a newline.
JCR: Each comma, semicolon or colon should be followed by whitespace.
Okay: [a, b] Okay: (3,) Okay: a[1:4] Okay: a[:4] Okay: a[1:] Okay: a[1:4:2] E231: ['a','b'] E231: foo(bar,baz)
- 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).
- Use spaces around arithmetic operators.
Okay: i = i + 1 Okay: submitted += 1 Okay: x = x * 2 - 1 Okay: hypot2 = x * x + y * y Okay: c = (a + b) * (a - b) Okay: foo(bar, key='word', *args, **kwargs) Okay: baz(**kwargs) Okay: negative = -1 Okay: spam(-1) Okay: alpha[:-i] Okay: if not -5 < x < +5:\n pass Okay: lambda *args, **kw: (args, kw)
E225: i=i+1 E225: submitted +=1 E225: x = x*2 - 1 E225: hypot2 = x*x + y*y E225: c = (a+b) * (a-b) E225: c = alpha -4 E225: z = x **y
Replace contents with 'xxx' to prevent syntax matching.
>>> mute_string('"abc"') '"xxx"' >>> mute_string("'''abc'''") "'''xxx'''" >>> mute_string("r'abc'") "r'xxx'"
Print benchmark numbers.
Print overall statistics (number of errors and warnings).
Process options passed either via arglist or via command line args.
Backticks are removed in Python 3000. Use repr() instead.
The {}.has_key() method will be removed in the future version of Python. Use the 'in' operation instead, like: d = {"a": 1, "b": 2} if "b" in d: print d["b"]
!= can also be written <>, but this is an obsolete usage kept for backwards compatibility only. New code should always use !=. The older syntax is removed in Python 3000.
When raising an exception, use "raise ValueError('message')" instead of the older form "raise ValueError, 'message'".
The paren-using form is preferred because when the exception arguments are long or include string formatting, you don't need to use line continuation characters thanks to the containing parentheses. The older form will be removed in Python 3000.
Run all the tests from a file.
A test file can provide many tests. Each test starts with a declaration. This declaration is a single line starting with '#:'. It declares codes of expected failures, separated by spaces or 'Okay' if no failure is expected. If the file does not contain such declaration, it should pass all tests. If the declaration is empty, following lines are not checked, until next declaration.
Examples:
* Only E224 and W701 are expected: #: E224 W701 * Following example is conform: #: Okay * Don't check these lines: #:
Test all check functions with test cases in docstrings.
For new projects, spaces-only are strongly recommended over tabs. Most editors have features that make this easy to do.
Okay: if True:\n return W191: if True:\n\treturn
Never mix tabs and spaces.
The most popular way of indenting Python is with spaces only. The second-most popular way is with tabs only. Code indented with a mixture of tabs and spaces should be converted to using spaces exclusively. When invoking the Python command line interpreter with the -t option, it issues warnings about code that illegally mixes tabs and spaces. When using -tt these warnings become errors. These options are highly recommended!
Okay: if a == 0:\n a = 1\n b = 1 E101: if a == 0:\n a = 1\n\tb = 1
JCR: Trailing blank lines are superfluous.
Okay: spam(1) W391: spam(1)\n
JCR: Trailing whitespace is superfluous. FBM: Except when it occurs as part of a blank line (i.e. the line is nothing but whitespace). According to Python docs[1] a line with only whitespace is considered a blank line, and is to be ignored. However, matching a blank line to its indentation level avoids mistakenly terminating a multi-line statement (e.g. class declaration) when pasting code into the standard Python interpreter.
[1] http://docs.python.org/reference/lexical_analysis.html#blank-lines
The warning returned varies on whether the line itself is blank, for easier filtering for those who want to indent their blank lines.
Okay: spam(1) W291: spam(1)\s W293: class Foo(object):\n \n bang = 12
Avoid extraneous whitespace in the following situations:
- More than one space around an assignment (or other) operator to align it with another.
JCR: This should also be applied around comma etc. Note: these checks are disabled by default
Okay: a = (1, 2) E241: a = (1, 2) E242: a = (1,\t2)
Don't use spaces around the '=' sign when used to indicate a keyword argument or a default parameter value.
Okay: def complex(real, imag=0.0): Okay: return magic(r=real, i=imag) Okay: boolean(a == b) Okay: boolean(a != b) Okay: boolean(a <= b) Okay: boolean(a >= b)
E251: def complex(real, imag = 0.0): E251: return magic(r = real, i = imag)
Avoid extraneous whitespace in the following situations:
- More than one space around an assignment (or other) operator to align it with another.
Okay: a = 12 + 3 E221: a = 4 + 5 E222: a = 4 + 5 E223: a = 4\t+ 5 E224: a = 4 +\t5
Separate inline comments by at least two spaces.
An inline comment is a comment on the same line as a statement. Inline comments should be separated by at least two spaces from the statement. They should start with a # and a single space.
Okay: x = x + 1 # Increment x Okay: x = x + 1 # Increment x E261: x = x + 1 # Increment x E262: x = x + 1 #Increment x E262: x = x + 1 # Increment x
Avoid extraneous whitespace in the following situations:
- Immediately before the open parenthesis that starts the argument list of a function call.
- Immediately before the open parenthesis that starts an indexing or slicing.
Okay: spam(1) E211: spam (1)
Okay: dict['key'] = list[index] E211: dict ['key'] = list[index] E211: dict['key'] = list [index]