pitrou opened a new pull request #12076:
URL: https://github.com/apache/arrow/pull/12076


   Add docstrings for parameters of the various function options classes.
   Automatically ingest those parameter docstrings into the generated compute 
function docstrings
   (this uses vendored code from `numpydoc`).
   
   Example with the `min_max` parameter docs:
   
   * before:
   ```
   array : Array-like
       Argument to compute function
   skip_nulls : optional
       Parameter for ScalarAggregateOptions constructor. Either `options`
       or `skip_nulls` can be passed, but not both at the same time.
   min_count : optional
       Parameter for ScalarAggregateOptions constructor. Either `options`
       or `min_count` can be passed, but not both at the same time.
   options : pyarrow.compute.ScalarAggregateOptions, optional
       Parameters altering compute function semantics.
   memory_pool : pyarrow.MemoryPool, optional
       If not passed, will allocate memory from the default memory pool.
   ```
   
   * after:
   ```
   array : Array-like
       Argument to compute function.
   skip_nulls : bool, default True
       Whether to skip (ignore) nulls in the input.
       If False, any null in the input forces the output to null.
   min_count : int, default 1
       Minimum number of non-null values in the input.  If the number
       of non-null values is below `min_count`, the output is null.
   options : pyarrow.compute.ScalarAggregateOptions, optional
       Alternative way of passing options.
   memory_pool : pyarrow.MemoryPool, optional
       If not passed, will allocate memory from the default memory pool.
   ```


-- 
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: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


Reply via email to