logger: Use sphinx.util.logger

Do not use warnings.warn anymore since they yield obnoxiously formatted
warnings, instead, always use sphinx.util.logger (or logging if outside
a sphinx context).

Signed-off-by: Jorge Marques <jorge.marques@analog.com>

adi_doctools/__init__.py

@@ -1,7 +1,6 @@
 from os import path, getenv
 from packaging.version import Version
 
-from sphinx.util import logging
 from sphinx.util.osutil import SEP
 
 from .theme import (navigation_tree, get_pygments_theme,
@@ -15,8 +14,6 @@
 
 __version__ = "0.3.49"
 
-logger = logging.getLogger(__name__)
-
 
 def get_navigation_tree(app, context, pagename):
     # The navigation tree, generated from the sphinx-provided ToC tree.

adi_doctools/directive/hdl.py

@@ -6,9 +6,9 @@
 from os import pardir, makedirs
 from math import ceil
 from lxml import etree
+from sphinx.util import logging
 
 from .node import node_div
-from .common import logger
 from .common import directive_base
 from .common import parse_rst
 from .string import string_hdl
@@ -17,6 +17,8 @@
 from ..parser.hdl import parse_hdl_build_status
 from ..writer.hdl_component import hdl_component
 
+logger = logging.getLogger(__name__)
+
 
 log = {
     'signal': "{lib}/component.xml: Signal {signal} defined in the hdl-interfaces directive does not exist in the IP-XACT!",  # noqa: E501