diff env/lib/python3.9/site-packages/boltons/deprutils.py @ 0:4f3585e2f14b draft default tip

"planemo upload commit 60cee0fc7c0cda8592644e1aad72851dec82c959"

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/env/lib/python3.9/site-packages/boltons/deprutils.py	Mon Mar 22 18:12:50 2021 +0000
@@ -0,0 +1,41 @@
+# -*- coding: utf-8 -*-
+
+"""
+Note that DeprecationWarnings are ignored by default in Python
+2.7/3.2+, so be sure to either un-ignore them in your code, or run
+Python with the -Wd flag.
+"""
+
+import sys
+from warnings import warn
+
+ModuleType = type(sys)
+
+# todo: only warn once
+
+
+class DeprecatableModule(ModuleType):
+    def __init__(self, module):
+        name = module.__name__
+        super(DeprecatableModule, self).__init__(name=name)
+        self.__dict__.update(module.__dict__)
+
+    def __getattribute__(self, name):
+        get_attribute = super(DeprecatableModule, self).__getattribute__
+        try:
+            depros = get_attribute('_deprecated_members')
+        except AttributeError:
+            self._deprecated_members = depros = {}
+        ret = get_attribute(name)
+        message = depros.get(name)
+        if message is not None:
+            warn(message, DeprecationWarning, stacklevel=2)
+        return ret
+
+
+def deprecate_module_member(mod_name, name, message):
+    module = sys.modules[mod_name]
+    if not isinstance(module, DeprecatableModule):
+        sys.modules[mod_name] = module = DeprecatableModule(module)
+    module._deprecated_members[name] = message
+    return