Source code for grab.util.warning
import warnings
from functools import wraps
[docs]class GrabDeprecationWarning(UserWarning):
"""
Warning category used in Grab to generate
warning messages.
"""
def warn(msg, stacklevel=2):
warnings.warn(msg, category=GrabDeprecationWarning, stacklevel=stacklevel)
# from https://github.com/scrapy/scrapy/blob/master/scrapy/utils/decorator.py
def deprecated(use_instead=None):
"""This is a decorator which can be used to mark functions
as deprecated. It will result in a warning being emitted
when the function is used."""
def wrapped(func):
@wraps(func)
def new_func(*args, **kwargs):
message = "Call to deprecated function %s." % func.__name__
if use_instead:
message += " Use %s instead." % use_instead
warn(message)
return func(*args, **kwargs)
return new_func
return wrapped