1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
|
""" warning message if version is 2.20 or above (technically, there's no version above 2.20.0) """
import sys
import warnings
from . import __version__
MAJOR_VERSION_WARNING = """\
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! You're seeing this warning because you've upgraded the Python package 'cloudflare' to version !!
!! 2.20.* via an automated upgrade without version pinning. Version 2.20.0 exists to catch any !!
!! of these upgrades before Cloudflare releases a new major release under the release number 3.x. !!
!! !!
!! Should you determine that you need to revert this upgrade and pin to v2.19.* it is recommended !!
!! you do the following: pip install --upgrade cloudflare==2.19.* or equivilant. !!
!! !!
!! Or you can upgrade to v3.x. NOTE: Release 3.x will not be code-compatible or call-compatible !!
!! with previous releases. To see more about upgrading to next major version, please see: !!
!! https://github.com/cloudflare/python-cloudflare/discussions/191 !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\
"""
def warning_2_20():
""" warning_2_20 """
if __version__ < '2.20.0':
return None
return MAJOR_VERSION_WARNING
#def print_warning_2_20(warning):
# """ print_warning_2_20 """
# # boring stderr message printing - however, warn_ form is prefered
# print(warning, file=sys.stderr)
# pass
def warn_warning_2_20(warning):
""" warn_warning_2_20 """
# force these warnings to be shown (even if -Wd isn't used on python command line)
warnings.simplefilter('always', PendingDeprecationWarning)
# stacklevel=4 cleanly upstacks the calls in cloudflare.py (and hence should chanhge if cloudflare.py changes)
warnings.warn(warning, PendingDeprecationWarning, stacklevel=4)
def indent_warning_2_20(warning):
""" indent_warning_2_20 """
return ''.join(['\n ' + v for v in warning.split('\n')])
|