flake8-executable

Very often, developers mess up the executable permissions and shebangs of Python files. For example, sometimes the executable permission was accidentally granted, sometimes it is forgotten.

This is a Flake8 plugin that ensures the executable permissions and shebangs of Python files are correctly set. Specifically, it checks the following errors:

EXE001: Shebang is present but the file is not executable.
EXE002: The file is executable but no shebang is present.
EXE003: Shebang is present but does not contain "python".
EXE004: There is whitespace before shebang.
EXE005: There are blank or comment lines before shebang.

Installation

Run:

pip install flake8-executable

Or through pre-commit with the .pre-commit-config.yaml:

repos:
-   repo: https://github.com/PyCQA/flake8
    rev: 6.0.0  # replace with the latest flake8 release
    hooks:
    -   id: flake8
        additional_dependencies:
        - flake8-executable

Usage

Normally, after flake8-executable is installed, invoking flake8 will also run this plugin. For more details, check out the Flake8 plugin page.

Copyright and License

flake8-executable is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

flake8-executable is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with flake8-executable. If not, see https://www.gnu.org/licenses/.

ValueError: not enough values to unpack (expected 4, got 3)

When I have it installed, I get:

multiprocessing.pool.RemoteTraceback:
"""
Traceback (most recent call last):
  File "/home/math/.pyenv/versions/3.8.6/lib/python3.8/multiprocessing/pool.py", line 125, in worker
    result = (True, func(*args, **kwds))
  File "/home/math/.pyenv/versions/3.8.6/lib/python3.8/site-packages/flake8/checker.py", line 676, in _run_checks
    return checker.run_checks()
  File "/home/math/.pyenv/versions/3.8.6/lib/python3.8/site-packages/flake8/checker.py", line 589, in run_checks
    self.run_ast_checks()
  File "/home/math/.pyenv/versions/3.8.6/lib/python3.8/site-packages/flake8/checker.py", line 494, in run_ast_checks
    for (line_number, offset, text, _) in runner:
ValueError: not enough values to unpack (expected 4, got 3)
"""

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/home/math/.pyenv/versions/3.8.6/bin/flake8", line 8, in <module>
    sys.exit(main())
  File "/home/math/.pyenv/versions/3.8.6/lib/python3.8/site-packages/flake8/main/cli.py", line 22, in main
    app.run(argv)
  File "/home/math/.pyenv/versions/3.8.6/lib/python3.8/site-packages/flake8/main/application.py", line 363, in run
    self._run(argv)
  File "/home/math/.pyenv/versions/3.8.6/lib/python3.8/site-packages/flake8/main/application.py", line 351, in _run
    self.run_checks()
  File "/home/math/.pyenv/versions/3.8.6/lib/python3.8/site-packages/flake8/main/application.py", line 264, in run_checks
    self.file_checker_manager.run()
  File "/home/math/.pyenv/versions/3.8.6/lib/python3.8/site-packages/flake8/checker.py", line 321, in run
    self.run_parallel()
  File "/home/math/.pyenv/versions/3.8.6/lib/python3.8/site-packages/flake8/checker.py", line 287, in run_parallel
    for ret in pool_map:
  File "/home/math/.pyenv/versions/3.8.6/lib/python3.8/multiprocessing/pool.py", line 868, in next
    raise value
ValueError: not enough values to unpack (expected 4, got 3)

with Flake8 3.8.4

xuhdev / flake8-executable Goto Github PK