Merge pull request #450 from palazzem/deprecation-warnings

[core] add Deprecation system with documentation

Author: Emanuele Palazzetti

ddtrace/bootstrap/sitecustomize.py

@@ -6,7 +6,7 @@
 import os
 import logging
 
-from ddtrace.util import asbool
+from ddtrace.utils.formats import asbool
 
 
 debug = os.environ.get("DATADOG_TRACE_DEBUG")

ddtrace/contrib/__init__.py

@@ -1 +1 @@
-from .util import func_name, module_name, require_modules  # noqa
+from ..utils.importlib import func_name, module_name, require_modules  # noqa

ddtrace/contrib/aiobotocore/__init__.py

@@ -18,7 +18,7 @@
     # This query generates a trace
     lambda_client.list_functions()
 """
-from ..util import require_modules
+from ...utils.importlib import require_modules
 
 
 required_modules = ['aiobotocore.client']

ddtrace/contrib/aiobotocore/patch.py

@@ -2,13 +2,13 @@
 import wrapt
 import aiobotocore.client
 
-from ddtrace import Pin
-from ddtrace.util import deep_getattr, unwrap
-
 from aiobotocore.endpoint import ClientResponseContentProxy
 
+from ...pin import Pin
 from ...ext import http, aws
 from ...compat import PYTHON_VERSION_INFO
+from ...utils.formats import deep_getattr
+from ...utils.wrappers import unwrap
 
 
 ARGS_NAME = ('action', 'params', 'path', 'verb')

ddtrace/contrib/aiohttp/__init__.py

@@ -44,7 +44,7 @@ async def home_handler(request):
         ctx = request['datadog_context']
         # do something with the tracing Context
 """
-from ..util import require_modules
+from ...utils.importlib import require_modules
 
 required_modules = ['aiohttp']
 

ddtrace/contrib/aiohttp/patch.py

@@ -1,7 +1,7 @@
 import wrapt
 
 from ...pin import Pin
-from ddtrace.util import unwrap
+from ...utils.wrappers import unwrap
 
 
 try:

ddtrace/contrib/aiopg/__init__.py

@@ -15,7 +15,7 @@
     # Use a pin to specify metadata related to this connection
     Pin.override(db, service='postgres-users')
 """
-from ..util import require_modules
+from ...utils.importlib import require_modules
 
 
 required_modules = ['aiopg']

ddtrace/contrib/aiopg/connection.py

@@ -5,8 +5,7 @@
 
 from .. import dbapi
 from ...ext import sql
-
-from ddtrace import Pin
+from ...pin import Pin
 
 
 class AIOTracedCursor(wrapt.ObjectProxy):

ddtrace/contrib/aiopg/patch.py

@@ -8,7 +8,7 @@
 from .connection import AIOTracedConnection
 from ..psycopg.patch import _patch_extensions, \
     _unpatch_extensions, patch_conn as psycppg_patch_conn
-from ...util import unwrap as _u
+from ...utils.wrappers import unwrap as _u
 
 
 def patch():

ddtrace/contrib/asyncio/__init__.py

@@ -39,7 +39,7 @@ async def some_work():
 wrappers without changing your code. In that case, the patch method **must be
 called before** importing stdlib functions.
 """
-from ..util import require_modules
+from ...utils.importlib import require_modules
 
 
 required_modules = ['asyncio']