Reinstate VERSION and deprecate

Author: hugovk

src/humanize/__init__.py

@@ -1,5 +1,8 @@
 """Main package for humanize."""
 
+import sys
+import warnings
+
 from humanize.filesize import naturalsize
 from humanize.i18n import activate, deactivate, thousands_separator
 from humanize.number import (
@@ -29,6 +32,25 @@
 __version__ = importlib_metadata.version(__name__)
 
 
+if sys.version_info >= (3, 7):
+    # This technique isn't available for 3.6 but we don't need to warn for 3.6
+    # because we'll drop 3.6 at the same time as removing this
+    def __getattr__(name):
+        if name == "VERSION":
+            warnings.warn(
+                "VERSION is deprecated and will be removed in humanize 4.0. "
+                "Use __version__ instead, available since humanize 1.0 (Feb 2020).",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            return __version__
+        raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
+
+
+else:
+    VERSION = __version__
+
+
 __all__ = [
     "__version__",
     "activate",

tests/test_humanize.py

@@ -0,0 +1,16 @@
+"""Other tests."""
+import sys
+
+import pytest
+
+import humanize
+
+
+def test_version():
+    if sys.version_info >= (3, 7):
+        with pytest.warns(DeprecationWarning):
+            VERSION = humanize.VERSION
+    else:
+        VERSION = humanize.VERSION
+
+    assert VERSION == humanize.__version__

tests/test_i18n.py

@@ -1,3 +1,4 @@
+"""Internationalisation tests."""
 import datetime as dt
 import importlib