semvec/pypi-packages huggingface dataset:
filter-certwarning 1.0.1
Decorators for filtering InsecureRequestWarnings in requests and urllib3 apps
License: BSD-2-Clause
Requires Python: >=3.5
Keywords: certwarning,urllib3,certificate,warnings

filter-certwarning
==================

Decorators for filtering InsecureRequestWarnings in `requests` and other `urllib3`-based Python 3 modules

**NOTE:** tested only for Python3.

When developing applications/modules using the ``requests`` module (or using ``urllib3`` directly), it is
sometimes useful to disable certificate validation, or to permit consumers/users to do so. However, doing
so makes *each request* issue an InsecureRequestWarning, which is a lot of noise.

**filter-certwarning** provides two decorators to make this behavior more reasonable.

- ``@filter_certwarning.warnonce`` causes the warning to be issued only warnonce, the first time the decorated
  function is called

- ``@filter_certwarning.silent`` is an alias for ``@filter_certwarning('ignore')``, and causes the warning to be
  entirely suppressed for that function call

Examples:
    A requests-based app with verification off that issues the warning only warnonce::

        import requests
        import filter_certwarning

        ...

        @filter_certwarning.warnonce
        sub get_data():
            # the next line will fire an InsecureRequestWarning the first time this
            # function is called, but subsequent calls to this function will be silent
            resp = requests.get('https://localhost/status', verify=False)

    The following supresses the warning entirely. **This is not recommended unless you've given a lot of thought
    to the security implications and trade-offs.**::

        import requests
        import filter_certwarning

        ...

        @filter_certwarning.silent
        sub get_data():
            # the next line will fire an InsecureRequestWarning the first time this
            # function is called, but subsequent calls to this function will be silent
            resp = requests.get('https://localhost/status', verify=False)


Installing
----------

To install::

    pip install filter-certwarning