mirror of
https://github.com/kennethreitz/requests.git
synced 2026-06-05 22:50:18 +00:00
Michael Komitee
d0285fac42
Hooks sometimes have to send requests (e.g. when responding to a 401 during authentication). All keyword arguments should be passed along when hooks are dispatched so that if a user wanted to use a timeout, stream, specify a cert location with the verify flag, etc, their specification can be followed.
46 lines
820 B
Python
46 lines
820 B
Python
# -*- coding: utf-8 -*-
|
|
|
|
"""
|
|
requests.hooks
|
|
~~~~~~~~~~~~~~
|
|
|
|
This module provides the capabilities for the Requests hooks system.
|
|
|
|
Available hooks:
|
|
|
|
``response``:
|
|
The response generated from a Request.
|
|
|
|
"""
|
|
|
|
|
|
HOOKS = ['response']
|
|
|
|
|
|
def default_hooks():
|
|
hooks = {}
|
|
for event in HOOKS:
|
|
hooks[event] = []
|
|
return hooks
|
|
|
|
# TODO: response is the only one
|
|
|
|
|
|
def dispatch_hook(key, hooks, hook_data, **kwargs):
|
|
"""Dispatches a hook dictionary on a given piece of data."""
|
|
|
|
hooks = hooks or dict()
|
|
|
|
if key in hooks:
|
|
hooks = hooks.get(key)
|
|
|
|
if hasattr(hooks, '__call__'):
|
|
hooks = [hooks]
|
|
|
|
for hook in hooks:
|
|
_hook_data = hook(hook_data, **kwargs)
|
|
if _hook_data is not None:
|
|
hook_data = _hook_data
|
|
|
|
return hook_data
|