[GitHub] [arrow] pitrou commented on a change in pull request #12627: ARROW-15860: [Python] Document RecordBatchReader

[GitBox <gi...@apache.org>]

pitrou commented on a change in pull request #12627:
URL: https://github.com/apache/arrow/pull/12627#discussion_r828153493



##########
File path: docs/source/python/data.rst
##########
@@ -512,3 +512,23 @@ a new schema and cast the data to this schema:
 
 Metadata key and value pair are ``std::string`` objects in the C++ implementation
 and so they are bytes objects (``b'...'``) in Python.
+
+Record Batch Readers
+--------------------
+
+Many functions in PyArrow either return or take as an argument a :class:`RecordBatchReader`.
+It can be used like any iterable of record batches, but also provides their common
+schema without having to get any of the batches.
+
+.. ipython:: python

Review comment:
       We're trying to get away from `ipython` blocks because they're heavy to execute and a bit fragile.
   
   I think the current inclination is to use doctest? @jorisvandenbossche 




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org