DataDog · mabdinur · Feb 3, 2025 · Jan 27, 2025 · Jan 27, 2025 · Jan 27, 2025
@@ -1,73 +1,3 @@
-from ddtrace._trace import trace_handlers  # noqa:F401
-from ddtrace.internal.utils.deprecations import DDTraceDeprecationWarning
-from ddtrace.internal.utils.importlib import func_name  # noqa:F401
-from ddtrace.internal.utils.importlib import module_name  # noqa:F401
-from ddtrace.internal.utils.importlib import require_modules  # noqa:F401
-from ddtrace.vendor.debtcollector import deprecate
-
-
-def __getattr__(name):
-    if name in (
-        "aiohttp",
-        "asgi",
-        "bottle",
-        "celery",
-        "cherrypy",
-        "falcon",
-        "flask_cache",
-        "pylibmc",
-        "pyramid",
-        "requests",
-        "sqlalchemy",
-        "wsgi",
-        "trace_utils",
-        "internal",
-    ):
-        # following packages/modules are not deprecated and will not be removed in 3.0
-        pass
-    elif name in ("trace_handlers", "func_name", "module_name", "require_modules"):
-        # the following attributes are exposed in ddtrace.contrib.__init__ and should be
-        # removed in v3.0
-        deprecate(
-            ("ddtrace.contrib.%s is deprecated" % name),
-            category=DDTraceDeprecationWarning,
-            removal_version="3.0.0",
-        )
-    elif name in ("aiobotocore", "httplib", "kombu", "snowflake", "sqlalchemy", "tornado", "urllib3"):
-        # following integrations are not enabled by default and require a unique deprecation message
-        deprecate(
-            f"ddtrace.contrib.{name} is deprecated",
-            message="Avoid using this package directly. "
-            f"Set DD_TRACE_{name.upper()}_ENABLED=true and use ``ddtrace.auto`` or the "
-            "``ddtrace-run`` command to enable and configure this integration.",
-            category=DDTraceDeprecationWarning,
-            removal_version="3.0.0",
-        )
-    elif name in ("redis_utils", "trace_utils_redis", "trace_utils_async"):
-        deprecate(
-            f"The ddtrace.contrib.{name} module is deprecated",
-            message="Import from ``ddtrace.contrib.trace_utils`` instead.",
-            category=DDTraceDeprecationWarning,
-            removal_version="3.0.0",
-        )
-    elif name == "flask_login":
-        deprecate(
-            """The flask_login integration is deprecated and will be deleted.
-        We recommend customers to switch to manual instrumentation.
-        https://docs.datadoghq.com/security/application_security/threats/add-user-info/?tab=loginsuccess&code-lang=python#adding-business-logic-information-login-success-login-failure-any-business-logic-to-traces
-        """,
-            message="",
-            category=DDTraceDeprecationWarning,
-        )
-    else:
-        deprecate(
-            f"ddtrace.contrib.{name} is deprecated",
-            message="Avoid using this package directly. "
-            f"Use ``import ddtrace.auto`` or the ``ddtrace-run`` command to enable and configure {name}.",
-            category=DDTraceDeprecationWarning,
-            removal_version="3.0.0",
-        )
-
-    if name in globals():
-        return globals()[name]
-    raise AttributeError("%s has no attribute %s", __name__, name)
+# Importing trace handlers has the side effect of registering integration level
+# handlers. This is necessary to use the Core API in integrations.
+from ddtrace._trace import trace_handlers as _  # noqa: F401
@@ -25,16 +25,3 @@
     Default: ``False``
 
 """
-
-
-# Required to allow users to import from  `ddtrace.contrib.aiobotocore.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-
-from ddtrace.contrib.internal.aiobotocore.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.aiobotocore.patch import patch  # noqa: F401
@@ -0,0 +1,15 @@
+"""
+The ``aiohttp_jinja2`` integration adds tracing of template rendering.
+
+
+Enabling
+~~~~~~~~
+
+The integration is enabled automatically when using
+:ref:`ddtrace-run<ddtracerun>` or :ref:`import ddtrace.auto<ddtraceauto>`.
+
+Or use :func:`patch()<ddtrace.patch>` to manually enable the integration::
+
+    from ddtrace import patch
+    patch(aiohttp_jinja2=True)
+"""
@@ -35,16 +35,3 @@
     cur = await conn.cursor()
     await cur.execute("SELECT 6*7 AS the_answer;")
 """
-
-
-# Required to allow users to import from  `ddtrace.contrib.aiohttp.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-from ddtrace.contrib.internal.aiomysql.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.aiomysql.patch import patch  # noqa: F401
-from ddtrace.contrib.internal.aiomysql.patch import unpatch  # noqa: F401
@@ -16,15 +16,3 @@
     # Use a pin to specify metadata related to this connection
     Pin.override(db, service='postgres-users')
 """
-
-
-# Required to allow users to import from  `ddtrace.contrib.aiohttp.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-from ddtrace.contrib.internal.aiopg.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.aiopg.patch import patch  # noqa: F401
@@ -60,14 +60,3 @@
     myaioredis = aioredis.Aioredis()
     Pin.override(myaioredis, service="myaioredis")
 """
-import warnings as _w  # noqa: E402
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    # Required to allow users to import from  `ddtrace.contrib.aioredis.patch` directly
-    from . import patch as _  # noqa: I001,F401
-
-from ddtrace.contrib.internal.aioredis.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.aioredis.patch import patch  # noqa: F401
-from ddtrace.contrib.internal.aioredis.patch import unpatch  # noqa: F401
@@ -21,16 +21,3 @@
 
 .. __: https://www.algolia.com
 """
-
-
-# Required to allow users to import from  `ddtrace.contrib.algoliasearch.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-from ddtrace.contrib.internal.algoliasearch.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.algoliasearch.patch import patch  # noqa: F401
-from ddtrace.contrib.internal.algoliasearch.patch import unpatch  # noqa: F401
@@ -81,16 +81,3 @@
 
     Pin.override(anthropic, service="my-anthropic-service")
 """  # noqa: E501
-
-
-# Required to allow users to import from  `ddtrace.contrib.anthropic.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-from ddtrace.contrib.internal.anthropic.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.anthropic.patch import patch  # noqa: F401
-from ddtrace.contrib.internal.anthropic.patch import unpatch  # noqa: F401
@@ -65,15 +65,3 @@
     async def example():
         await client.get("my-key")
 """
-
-
-# Required to allow users to import from  `ddtrace.contrib.aredis.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-from ddtrace.contrib.internal.aredis.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.aredis.patch import patch  # noqa: F401
@@ -0,0 +1,4 @@
+"""
+This integration provides context management for tracing the execution flow
+of concurrent execution of ``asyncio.Task``.
+"""
@@ -43,16 +43,3 @@
     conn = asyncpg.connect("postgres://localhost:5432")
     Pin.override(conn, service="custom-service")
 """
-
-
-# Required to allow users to import from  `ddtrace.contrib.asyncpg.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-from ddtrace.contrib.internal.asyncpg.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.asyncpg.patch import patch  # noqa: F401
-from ddtrace.contrib.internal.asyncpg.patch import unpatch  # noqa: F401
@@ -15,6 +15,3 @@
 ~~~~~~~~~~~~~
 
 """
-
-from ..internal.avro.patch import get_version  # noqa: F401
-from ..internal.avro.patch import patch  # noqa: F401
@@ -38,7 +38,3 @@
 For additional configuration refer to
 `Instrumenting Python Serverless Applications by Datadog <https://docs.datadoghq.com/serverless/installation/python>`_.
 """
-
-from ddtrace.contrib.internal.aws_lambda.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.aws_lambda.patch import patch  # noqa: F401
-from ddtrace.contrib.internal.aws_lambda.patch import unpatch  # noqa: F401
@@ -0,0 +1,25 @@
+"""
+The azure_functions integration traces all http requests to your Azure Function app.
+
+Enabling
+~~~~~~~~
+
+Use :func:`patch()<ddtrace.patch>` to manually enable the integration::
+
+    from ddtrace import patch
+    patch(azure_functions=True)
+
+
+Global Configuration
+~~~~~~~~~~~~~~~~~~~~
+
+.. py:data:: ddtrace.config.azure_functions["service"]
+
+   The service name reported by default for azure_functions instances.
+
+   This option can also be set with the ``DD_SERVICE`` environment
+   variable.
+
+   Default: ``"azure_functions"``
+
+"""
@@ -27,15 +27,3 @@
     Default: ``False``
 
 """
-
-
-# Required to allow users to import from  `ddtrace.contrib.boto.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-from ddtrace.contrib.internal.boto.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.boto.patch import patch  # noqa: F401
@@ -151,16 +151,3 @@
     Default: ``True``
 
 """
-
-
-# Required to allow users to import from  `ddtrace.contrib.botocore.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-from ddtrace.contrib.internal.botocore.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.botocore.patch import patch  # noqa: F401
-from ddtrace.contrib.internal.botocore.patch import patch_submodules  # noqa: F401
@@ -22,16 +22,3 @@
     session = cluster.connect("my_keyspace")
     session.execute("select id from my_table limit 10;")
 """
-
-
-# Required to allow users to import from  `ddtrace.contrib.cassandra.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-
-from ddtrace.contrib.internal.cassandra.patch import patch  # noqa: F401
-from ddtrace.contrib.internal.cassandra.session import get_version  # noqa: F401
@@ -19,17 +19,3 @@
     # Use a pin to specify metadata related to this client
     Pin.override(client, service='consul-kv')
 """
-
-
-# Required to allow users to import from  `ddtrace.contrib.consul.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-
-from ddtrace.contrib.internal.consul.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.consul.patch import patch  # noqa: F401
-from ddtrace.contrib.internal.consul.patch import unpatch  # noqa: F401
@@ -0,0 +1,17 @@
+"""
+The Coverage.py integration traces test code coverage when using `pytest` or `unittest`.
+
+
+Enabling
+~~~~~~~~
+
+The Coverage.py integration is enabled automatically when using
+:ref:`ddtrace-run<ddtracerun>` or :ref:`import ddtrace.auto<ddtraceauto>`.
+
+Alternately, use :func:`patch()<ddtrace.patch>` to manually enable the integration::
+
+    from ddtrace import patch
+    patch(coverage=True)
+
+Note: Coverage.py instrumentation is only enabled if `pytest` or `unittest` instrumentation is enabled.
+"""
@@ -200,18 +200,3 @@
 
 .. __: https://www.djangoproject.com/
 """  # noqa: E501
-
-
-# Required to allow users to import from  `ddtrace.contrib.django.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-
-from ddtrace.contrib.internal.django.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.django.patch import patch  # noqa: F401
-from ddtrace.contrib.internal.django.patch import patch as _patch  # noqa: F401
-from ddtrace.contrib.internal.django.patch import unpatch  # noqa: F401
@@ -36,17 +36,3 @@ def hello(name):
 
 .. __: https://dogpilecache.sqlalchemy.org/
 """
-
-
-# Required to allow users to import from  `ddtrace.contrib.dogpile_cache.patch` directly
-import warnings as _w
-
-
-with _w.catch_warnings():
-    _w.simplefilter("ignore", DeprecationWarning)
-    from . import patch as _  # noqa: F401, I001
-
-
-from ddtrace.contrib.internal.dogpile_cache.patch import get_version  # noqa: F401
-from ddtrace.contrib.internal.dogpile_cache.patch import patch  # noqa: F401
-from ddtrace.contrib.internal.dogpile_cache.patch import unpatch  # noqa: F401