Skip to content

[Python][Doc] Improve docs to specify that source argument on parquet.read_table can also be a list of strings #46374

Closed

Description

@raulcd

Describe the enhancement requested

The docstring for parquet.read_table doesn't specify that the source can be a list of strings:

source : str, pyarrow.NativeFile, or file-like object
If a string passed, can be a single file name or directory name. For
file-like objects, only read a single file. Use pyarrow.BufferReader to
read a file contained in a bytes or buffer-like object.

There is also a #TODO for a check on the source argument to validate is of the valid type in case dataset is not enabled.

if filesystem is not None:
source = filesystem.open_input_file(path)
# TODO test that source is not a directory or a list
dataset = ParquetFile(

This should only tackle those. There is another issue to test the fallback case successfully:

Component(s)

Documentation, Python

Activity

  1. added a commit that references this issue on Jul 20, 2025
  2. rok commented on Jul 20, 2025

    @rok
    Member

    Issue resolved by pull request 47142
    #47142

  3. added this to the 22.0.0 milestone on Jul 20, 2025
  4. AlenkaF commented on Jul 21, 2025

    @AlenkaF
    Member

    Let's reopen the issue as the second PR for mentioned todo still needs to get merged: #47144. After this is merged, the issue can be closed.

  5. AlenkaF commented on Oct 7, 2025

    @AlenkaF
    Member

    I have moved the TODO part for checking on the source argument into a follow-up issue (#47728) so this can be closed for 22.0.0.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions