diff options
| author | Ian Cordasco <graffatcolmingov@gmail.com> | 2016-10-25 11:57:24 -0500 |
|---|---|---|
| committer | Ian Cordasco <graffatcolmingov@gmail.com> | 2016-10-25 11:57:24 -0500 |
| commit | 91a1ce47d6cf2a0161546fec7268cc42fece89c5 (patch) | |
| tree | 24749677e08541aefbec386728ada0d3fd706417 /docs/source/plugin-development | |
| parent | a90c94ab2281737c038bcdca873c6f07239eee59 (diff) | |
| parent | 9cf8603e9494420ebd1a48bea33b31d4979525d7 (diff) | |
| download | flake8-91a1ce47d6cf2a0161546fec7268cc42fece89c5.tar.gz | |
Merge branch 'file-tokens' of xzise/flake8
Diffstat (limited to 'docs/source/plugin-development')
| -rw-r--r-- | docs/source/plugin-development/plugin-parameters.rst | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/docs/source/plugin-development/plugin-parameters.rst b/docs/source/plugin-development/plugin-parameters.rst index fd644bc..729f9c5 100644 --- a/docs/source/plugin-development/plugin-parameters.rst +++ b/docs/source/plugin-development/plugin-parameters.rst @@ -40,25 +40,25 @@ a file, a plugin can ask for any of the following: - :attr:`~flake8.processor.FileProcessor.previous_logical` - :attr:`~flake8.processor.FileProcessor.tokens` -Some properties are set once per file being processed: +Some properties are set once per file for plugins which iterate itself over +the data instead of being called on each physical or logical line. - :attr:`~flake8.processor.FileProcessor.filename` +- :attr:`~flake8.processor.FileProcessor.file_tokens` - :attr:`~flake8.processor.FileProcessor.lines` - :attr:`~flake8.processor.FileProcessor.max_line_length` - :attr:`~flake8.processor.FileProcessor.total_lines` - :attr:`~flake8.processor.FileProcessor.verbose` These parameters can also be supplied to plugins working on each line -separately. Additionally, plugins called once per file can also accept ``tree`` -which is not supplied as a parameter of -:class:`~flake8.processor.FileProcessor`, which will be a parsed abstract -syntax tree. It is used by plugins like PyFlakes and McCabe. - -When the plugin is run depends on the first parameter, not counting ``self``. -It can be either ``physical_line``, ``logical_line`` or ``tree``. If the -parameter is ``tree``, it is run once per file, otherwise once per physical -line or logical line respectively. If the plugin is using neither of them it -won't be run at all. +separately. + +Plugins that depend on ``physical_line`` or ``logical_line`` are run on each +physical or logical line once. These parameters should be the first in the +list of arguments (with the exception of ``self``). Plugins that need an AST +(e.g., PyFlakes and McCabe) should depend on ``tree``. These plugins will run +once per file. The parameters listed above can be combined with +``physical_line``, ``logical_line``, and ``tree``. Registering Options |