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