fix: should use Collection[Array] instead list[Array] (#170)

"List" is invariant -- see https://mypy.readthedocs.io/en/stable/common_issues.html#variance
Consider using "Sequence" instead, which is covariant

Author: zen-xu

pyarrow-stubs/__lib_pxi/array.pyi

@@ -16,6 +16,7 @@ else:
     from typing_extensions import TypeAlias
 from typing import (
     Any,
+    Collection,
     Generic,
     Iterable,
     Iterator,
@@ -1095,7 +1096,7 @@ class Array(_PandasConvertible[pd.Series], Generic[_Scalar_CoT]):
         buffers: list[Buffer],
         null_count: int = -1,
         offset=0,
-        children: list[Array[Scalar[_DataTypeT]]] | None = None,
+        children: Collection[Array[Scalar[_DataTypeT]]] | None = None,
     ) -> Array[Scalar[_DataTypeT]]: ...
     @property
     def null_count(self) -> int: ...
@@ -1403,14 +1404,14 @@ class UnionArray(Array[scalar.UnionScalar]):
     def from_dense(
         types: Int8Array,
         value_offsets: Int32Array,
-        children: list[Array],
+        children: Collection[Array],
         field_names: list[str] | None = None,
         type_codes: Int8Array | None = None,
     ) -> UnionArray: ...
     @staticmethod
     def from_sparse(
         types: Int8Array,
-        children: list[Array],
+        children: Collection[Array],
         field_names: list[str] | None = None,
         type_codes: Int8Array | None = None,
     ) -> UnionArray: ...

pyarrow-stubs/__lib_pxi/table.pyi

@@ -15,6 +15,7 @@ else:
     from typing_extensions import TypeAlias
 from typing import (
     Any,
+    Collection,
     Generator,
     Generic,
     Iterable,
@@ -469,7 +470,7 @@ class RecordBatch(_Tabular[Array]):
     @classmethod
     def from_arrays(
         cls,
-        arrays: list[Array] | list[ChunkedArray],
+        arrays: Collection[Array] | Collection[ChunkedArray],
         names: list[str] | None = None,
         schema: Schema | None = None,
         metadata: Mapping | None = None,
@@ -550,7 +551,7 @@ class Table(_Tabular[ChunkedArray]):
     @classmethod
     def from_arrays(
         cls,
-        arrays: list[Array] | list[ChunkedArray],
+        arrays: Collection[Array] | Collection[ChunkedArray],
         names: list[str] | None = None,
         schema: Schema | None = None,
         metadata: Mapping | None = None,
@@ -601,7 +602,7 @@ class Table(_Tabular[ChunkedArray]):
 
 def record_batch(
     data: dict[str, list | Array]
-    | list[Array]
+    | Collection[Array]
     | pd.DataFrame
     | SupportArrowArray
     | SupportArrowDeviceArray,
@@ -618,7 +619,7 @@ def table(
 ) -> Table: ...
 @overload
 def table(
-    data: list[Array | ChunkedArray]
+    data: Collection[Array | ChunkedArray]
     | pd.DataFrame
     | SupportArrowArray
     | SupportArrowStream