semvec/pypi-packages huggingface dataset:
flake8-raise 0.0.5
A flake8 plugin that finds that finds improvements for raise statements.
License: MIT
Requires Python: >=3.5

============
flake8-raise
============

A `flake8 <https://flake8.readthedocs.io/>`_ plugin that finds improvements for
raise statements.

Installation
------------

Install using ``pip``:

.. code-block:: sh

    $ pip install flake8-raise

When installed, the plugin will automatically be used by ``flake8``. To check
it is installed correctly, run ``flake8 --version`` and look in the list of
installed plugins:

.. code-block:: sh

    $ flake8 --version
    3.7.9 (flake8-raise: 0.0.5, mccabe: 0.6.1, pycodestyle: 2.5.0, pyflakes: 2.1.1) CPython 3.8.1 on Linux

Rules
-----

==== ====
Code Rule
==== ====
R100 ``raise`` in ``except`` handler without ``from``
R101 use bare ``raise`` in ``except`` handler
R102 unnecessary parentheses on raised exception
==== ====

Examples
--------

R100 ``raise`` in ``except`` handler without ``from``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code-block:: py

    try:
        foo["bar"]
    except KeyError:
        raise MyException

Will result in the error:

.. code-block:: text

    R100 raise in except handler without from.

To fix, change to:

.. code-block:: py

    try:
        foo['bar']
    except KeyError as e:
        raise MyException from e

R101 use bare ``raise`` in ``except`` handler
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code-block:: py

    try:
        foo["bar"]
    except KeyError as e:
        raise e

Will result in the error:

.. code-block:: text

    R101 Use bare raise in except handler.

To fix, change to:

.. code-block:: py

    try:
        foo['bar']
    except KeyError:
        raise

R102 unnecessary parentheses on raised exception
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code-block:: py

    raise TypeError()

Will result in the error:

.. code-block:: text

    R102 unnecessary parentheses on raised exception

To fix, change to:

.. code-block:: py

    raise TypeError