BUG: Join with a list of a single element behaves as a join with a single element (pandas-dev#57676)

Author: Dacops

doc/source/whatsnew/v3.0.0.rst

@@ -458,6 +458,7 @@ Other
 - Bug in :class:`DataFrame` when passing a ``dict`` with a NA scalar and ``columns`` that would always return ``np.nan`` (:issue:`57205`)
 - Bug in :func:`unique` on :class:`Index` not always returning :class:`Index` (:issue:`57043`)
 - Bug in :meth:`DataFrame.eval` and :meth:`DataFrame.query` which caused an exception when using NumPy attributes via ``@`` notation, e.g., ``df.eval("@np.floor(a)")``. (:issue:`58041`)
+- Bug in :meth:`DataFrame.join` join with a list of a single element should behave as a join with a single element (:issue:`57676`)
 - Bug in :meth:`DataFrame.sort_index` when passing ``axis="columns"`` and ``ignore_index=True`` and ``ascending=False`` not returning a :class:`RangeIndex` columns (:issue:`57293`)
 - Bug in :meth:`DataFrame.transform` that was returning the wrong order unless the index was monotonically increasing. (:issue:`57069`)
 - Bug in :meth:`DataFrame.where` where using a non-bool type array in the function would return a ``ValueError`` instead of a ``TypeError`` (:issue:`56330`)

pandas/core/frame.py

@@ -10609,6 +10609,9 @@ def join(
         from pandas.core.reshape.concat import concat
         from pandas.core.reshape.merge import merge
 
+        if isinstance(other, list) and len(other) == 1:
+            other = other[0]
+
         if isinstance(other, Series):
             if other.name is None:
                 raise ValueError("Other Series must have a name")

pandas/tests/frame/methods/test_join.py

@@ -107,8 +107,6 @@ def test_suffix_on_list_join():
 
     # check proper errors are raised
     msg = "Suffixes not supported when joining multiple DataFrames"
-    with pytest.raises(ValueError, match=msg):
-        first.join([second], lsuffix="y")
     with pytest.raises(ValueError, match=msg):
         first.join([second, third], rsuffix="x")
     with pytest.raises(ValueError, match=msg):
@@ -562,3 +560,21 @@ def test_frame_join_tzaware(self):
 
         tm.assert_index_equal(result.index, expected)
         assert result.index.tz.zone == "US/Central"
+
+    def test_join_list_with_single_element(self):
+        test1 = DataFrame(
+            {"cat": pd.Categorical(["a", "v", "d"])},
+            index=Index(["a", "b", "c"], name="y"),
+        )
+        test2 = DataFrame(
+            {"foo": np.arange(6)},
+            index=MultiIndex.from_tuples(
+                [(0, "a"), (0, "b"), (0, "c"), (1, "a"), (1, "b"), (1, "c")],
+                names=("x", "y"),
+            ),
+        )
+
+        result = test2.join([test1])
+        expected = test2.join(test1)
+
+        tm.assert_frame_equal(result, expected)