Add support to names keyword in Index

pandas/core/indexes/base.py

@@ -176,8 +176,10 @@ class Index(IndexOpsMixin, PandasObject):
         Otherwise, an error will be raised.
     copy : bool
         Make a copy of input ndarray
-    name : object
+    name : object, optional
         Name to be stored in the index
+    names : tuple of objects, optional
+        Names to be stored in the index (only accepts tuple of length 1)
     tupleize_cols : bool (default: True)
         When True, attempt to create a MultiIndex if possible
 
@@ -259,12 +261,22 @@ def __new__(
         dtype=None,
         copy=False,
         name=None,
+        names=None,
         fastpath=None,
         tupleize_cols=True,
         **kwargs
     ):
 
-        if name is None and hasattr(data, "name"):
+        if names is not None:
+            if name is not None:
+                raise TypeError("Using name and names is unsupported")
+            elif names is not None and not is_list_like(names):
+                raise TypeError("names must be list-like")
+            elif len(names) > 1:
+                raise TypeError("names must be list-like of size 1")
+            # infer name from names when MultiIndex cannot be created
+            name = names[0]
+        elif hasattr(data, "name") and name is None:
             name = data.name
 
         if fastpath is not None:
@@ -492,9 +504,7 @@ def __new__(
                     # 10697
                     from .multi import MultiIndex
 
-                    return MultiIndex.from_tuples(
-                        data, names=name or kwargs.get("names")
-                    )
+                    return MultiIndex.from_tuples(data, names=names or name)
             # other iterable of some kind
             subarr = com.asarray_tuplesafe(data, dtype=object)
             return Index(subarr, dtype=dtype, copy=copy, name=name, **kwargs)

pandas/tests/indexes/test_base.py

@@ -371,6 +371,29 @@ def test_constructor_simple_new(self, vals, dtype):
         result = index._simple_new(index.values, dtype)
         tm.assert_index_equal(result, index)
 
+    def test_constructor_names(self):
+        # test both `name` and `names`
+        with pytest.raises(TypeError):
+            idx = Index([1, 2, 3], name="a", names=("a",))
+
+        # test non-list-like `names`
+        with pytest.raises(TypeError):
+            idx = Index([1, 2, 3], names="a")
+
+        # test list-like with length > 1
+        with pytest.raises(TypeError):
+            idx = Index([1, 2, 3], names=("a", "b"))
+
+        # test using `name` for a flat `Index`
+        idx = Index([1, 2, 3], name="a")
+        assert idx.name == "a"
+        assert idx.names == ("a",)
+
+        # test using `names` for a flat `Index`
+        idx = Index([1, 2, 3], names=("a",))
+        assert idx.name == "a"
+        assert idx.names == ("a",)
+
     @pytest.mark.parametrize(
         "vals",
         [