1 files changed, 51 insertions, 0 deletions
diff --git a/venv/lib/python3.11/site-packages/litestar/utils/warnings.py b/venv/lib/python3.11/site-packages/litestar/utils/warnings.py
new file mode 100644
index 0000000..e20484b
--- /dev/null
+++ b/venv/lib/python3.11/site-packages/litestar/utils/warnings.py
@@ -0,0 +1,51 @@
+import os
+import warnings
+
+from litestar.exceptions import LitestarWarning
+from litestar.types import AnyCallable, AnyGenerator
+
+
+def warn_implicit_sync_to_thread(source: AnyCallable, stacklevel: int = 2) -> None:
+    if os.getenv("LITESTAR_WARN_IMPLICIT_SYNC_TO_THREAD") == "0":
+        return
+
+    warnings.warn(
+        f"Use of a synchronous callable {source} without setting sync_to_thread is "
+        "discouraged since synchronous callables can block the main thread if they "
+        "perform blocking operations. If the callable is guaranteed to be non-blocking, "
+        "you can set sync_to_thread=False to skip this warning, or set the environment"
+        "variable LITESTAR_WARN_IMPLICIT_SYNC_TO_THREAD=0 to disable warnings of this "
+        "type entirely.",
+        category=LitestarWarning,
+        stacklevel=stacklevel,
+    )
+
+
+def warn_sync_to_thread_with_async_callable(source: AnyCallable, stacklevel: int = 2) -> None:
+    if os.getenv("LITESTAR_WARN_SYNC_TO_THREAD_WITH_ASYNC") == "0":
+        return
+
+    warnings.warn(
+        f"Use of an asynchronous callable {source} with sync_to_thread; sync_to_thread "
+        "has no effect on async callable. You can disable this warning by setting "
+        "LITESTAR_WARN_SYNC_TO_THREAD_WITH_ASYNC=0",
+        category=LitestarWarning,
+        stacklevel=stacklevel,
+    )
+
+
+def warn_sync_to_thread_with_generator(source: AnyGenerator, stacklevel: int = 2) -> None:
+    if os.getenv("LITESTAR_WARN_SYNC_TO_THREAD_WITH_GENERATOR") == "0":
+        return
+
+    warnings.warn(
+        f"Use of generator {source} with sync_to_thread; sync_to_thread has no effect "
+        "on generators. You can disable this warning by setting "
+        "LITESTAR_WARN_SYNC_TO_THREAD_WITH_GENERATOR=0",
+        category=LitestarWarning,
+        stacklevel=stacklevel,
+    )
+
+
+def warn_pdb_on_exception(stacklevel: int = 2) -> None:
+    warnings.warn("Python Debugger on exception enabled", category=LitestarWarning, stacklevel=stacklevel)