mirror of
https://github.com/thegeeklab/ansible-later.git
synced 2024-11-23 13:20:41 +00:00
84 lines
2.2 KiB
Plaintext
84 lines
2.2 KiB
Plaintext
Metadata-Version: 2.1
|
|
Name: flake8-blind-except
|
|
Version: 0.1.1
|
|
Summary: A flake8 extension that checks for blind except: statements
|
|
Home-page: https://github.com/elijahandrews/flake8-blind-except
|
|
Author: Elijah Andrews
|
|
Author-email: elijahcandrews@gmail.com
|
|
License: MIT
|
|
Keywords: flake8 except exception
|
|
Platform: UNKNOWN
|
|
Requires-Dist: setuptools
|
|
|
|
flake8-blind-except
|
|
===================
|
|
|
|
A flake8 extension that checks for blind, catch-all ``except:`` statements.
|
|
|
|
Using ``except`` without explicitly specifying which exceptions to catch is generally considered bad practice, since it catches system signals like ``SIGINT``. You probably want to handle system interrupts differently than exceptions occuring in your code.
|
|
|
|
It's also usually better style to have many small ``try``-``except`` blocks catching specific exceptions instead of a giant ``try:`` block with a catch-all ``except:`` at the bottom. It's also nicer to your fellow programmers to be a bit more specific about what exceptions they can expect in specific parts of the code, and what the proper course of action is when they occur.
|
|
|
|
An example of code that will fail this check is:
|
|
|
|
.. code-block:: python
|
|
|
|
try:
|
|
something_scary()
|
|
except:
|
|
everybody_panic()
|
|
|
|
However, the following code is valid:
|
|
|
|
.. code-block:: python
|
|
|
|
try:
|
|
something_terrifying()
|
|
except TerrifyingException:
|
|
dont_panic()
|
|
|
|
Installation
|
|
------------
|
|
|
|
If you don't already have it, install ``flake8``::
|
|
|
|
$ pip install flake8
|
|
|
|
Then, install the extension::
|
|
|
|
$ pip install flake8-blind-except
|
|
|
|
Usage
|
|
-----
|
|
|
|
Run the following to verify that the plugin has been installed correctly::
|
|
|
|
$ flake8 --version
|
|
2.0 (pep8: 1.4.6, flake8-blind-except: 0.1.0, pyflakes: 0.7.3)
|
|
|
|
Now, when you run ``flake8``, the plugin will automatically be used.
|
|
|
|
When a blind except is found, ``flake8`` will output::
|
|
|
|
B901 blind except: statement
|
|
|
|
|
|
|
|
Changes
|
|
------
|
|
|
|
0.1.1 - 2016-06-27
|
|
``````````````````
|
|
* ``pep8`` was renamed to ``pycodestyle`` in its 2.0 release. Compatibility update for this change
|
|
|
|
0.1.0 - 2014-02-07
|
|
``````````````````
|
|
* Initial release
|
|
|
|
Notes
|
|
-----
|
|
|
|
I've tested this package with flake8 2.6.2 and Python 2.7.3. It is untested (but likely compatible) with other software versions.
|
|
|
|
|