Warn for uppercase key usage in metadata in setup.cfg, provides compatibility. Fixes #2592

changelog.d/2592.change.rst

@@ -0,0 +1 @@
+Warned for usage of uppercase keys in :code:`metadata` in :code:`setup.cfg`, restored some compatiblity by transforming to lowercase if not. Followed the change of keys in :code:`setup.cfg` now being case-sensitive -- by :user:`melissa-kun-li`

setuptools/dist.py

@@ -599,6 +599,7 @@ def _parse_config_files(self, filenames=None):  # noqa: C901
 
                     val = parser.get(section, opt)
                     opt = self.dash_to_underscore_warning(opt, section)
+                    opt = self.uppercase_warning(opt, section)
                     opt_dict[opt] = (filename, val)
 
             # Make the ConfigParser forget everything (so we retain
@@ -636,6 +637,17 @@ def dash_to_underscore_warning(self, opt, section):
                 % (opt, underscore_opt))
         return underscore_opt
 
+    def uppercase_warning(self, opt, section):
+        if section in ('metadata',) and (any(c.isupper() for c in opt)):
+            lowercase_opt = opt.lower()
+            warnings.warn(
+                "Usage of uppercase key '%s' in '%s' will be deprecated in future "
+                "versions. Please use lowercase '%s' instead"
+                % (opt, section, lowercase_opt)
+            )
+            return lowercase_opt
+        return opt
+
     # FIXME: 'Distribution._set_command_options' is too complex (14)
     def _set_command_options(self, command_obj, option_dict=None):  # noqa: C901
         """

setuptools/tests/test_config.py

@@ -526,6 +526,24 @@ def test_dash_to_underscore_warning(self, tmpdir):
                 assert metadata.author_email == '[email protected]'
                 assert metadata.maintainer_email == '[email protected]'
 
+    def test_uppercase_warning(self, tmpdir):
+        # remove this test and the method uppercase_warning() in setuptools.dist
+        # when no longer needed
+        fake_env(
+            tmpdir,
+            '[metadata]\n'
+            'Name = foo\n'
+            'description = Some description\n'
+        )
+        msg = ("Usage of uppercase key 'Name' in 'metadata' will be deprecated in "
+               "future versions. "
+               "Please use lowercase 'name' instead")
+        with pytest.warns(UserWarning, match=msg):
+            with get_dist(tmpdir) as dist:
+                metadata = dist.metadata
+                assert metadata.name == 'foo'
+                assert metadata.description == 'Some description'
+
 
 class TestOptions: