1#----------------------------------------------------------------------------- 2# Copyright (c) 2012 - 2021, Anaconda, Inc., and Bokeh Contributors. 3# All rights reserved. 4# 5# The full license is in the file LICENSE.txt, distributed with this software. 6#----------------------------------------------------------------------------- 7''' Provide Bokeh-specific warning subclasses. 8 9The primary use of these subclasses to to force them to be unconditionally 10displayed to users by default. 11 12''' 13 14#----------------------------------------------------------------------------- 15# Boilerplate 16#----------------------------------------------------------------------------- 17import logging # isort:skip 18log = logging.getLogger(__name__) 19 20#----------------------------------------------------------------------------- 21# Imports 22#----------------------------------------------------------------------------- 23 24#----------------------------------------------------------------------------- 25# Globals and constants 26#----------------------------------------------------------------------------- 27 28__all__ = ( 29 'BokehDeprecationWarning', 30 'BokehUserWarning', 31) 32 33#----------------------------------------------------------------------------- 34# General API 35#----------------------------------------------------------------------------- 36 37class BokehDeprecationWarning(DeprecationWarning): 38 ''' A Bokeh-specific ``DeprecationWarning`` subclass. 39 40 Used to selectively filter Bokeh deprecations for unconditional display. 41 42 ''' 43 44class BokehUserWarning(UserWarning): 45 ''' A Bokeh-specific ``UserWarning`` subclass. 46 47 Used to selectively filter Bokeh warnings for unconditional display. 48 49 ''' 50 51#----------------------------------------------------------------------------- 52# Dev API 53#----------------------------------------------------------------------------- 54 55#----------------------------------------------------------------------------- 56# Private API 57#----------------------------------------------------------------------------- 58 59#----------------------------------------------------------------------------- 60# Code 61#----------------------------------------------------------------------------- 62