Miles Granger created ARROW-17320:
-------------------------------------

             Summary: Refine pyarrow.parquet API exposure
                 Key: ARROW-17320
                 URL: https://issues.apache.org/jira/browse/ARROW-17320
             Project: Apache Arrow
          Issue Type: Improvement
          Components: Parquet, Python
            Reporter: Miles Granger


Spawning from [ARROW-17106|https://issues.apache.org/jira/browse/ARROW-17106], 
moving code from `pyarrow/parquet/__init__` to `pyarrow/parquet/core` and 
re-exporting in `__init__` to maintain the same functionality.


[pyarrow.__init__|https://github.com/apache/arrow/blob/master/python/pyarrow/__init__.py]
 is very careful about what is exposed through the public API by prefixing 
private symbols with underscores, even imports. 

What's exposed at the top level of `{{{}pyarrow.parquet{}}}`, however, is not 
so careful. API calls such as `{{{}pq.FileSystem{}}}`, `{{{}pq.pa.Array{}}}`, 
`{{{}pq.json{}}}` are all valid and should probably be designated as private 
attributes in {{{}pyarrow.parquet{}}}.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

Reply via email to