danepitkin commented on PR #37097:
URL: https://github.com/apache/arrow/pull/37097#issuecomment-1684358488
I'm also not sure how to fix these new numpydoc lint issues:
```
INFO:archery:Running Python docstring linters
pyarrow._s3fs.S3LogLevel
-> pyarrow._s3fs.An enumeration.
PR01: Parameters {'qualname', 'module', 'names', 'start', 'type', 'value'}
not documented
pyarrow._fs.FileType
-> pyarrow._fs.An enumeration.
PR01: Parameters {'qualname', 'module', 'names', 'start', 'type', 'value'}
not documented
pyarrow.lib.MetadataVersion
-> pyarrow.lib.An enumeration.
PR01: Parameters {'qualname', 'module', 'names', 'start', 'type', 'value'}
not documented
pyarrow._dataset.type.FileSystemDataset.from_paths
-> pyarrow._dataset.FileSystemDataset.from_paths(cls, paths, schema=None,
format=None, filesystem=None, partitions=None, root_partition=None)
PR01: Parameters {'schema', 'filesystem', 'format', 'root_partition',
'partitions'} not documented
pyarrow.lib.MetadataVersion
-> pyarrow.lib.An enumeration.
PR01: Parameters {'qualname', 'module', 'names', 'start', 'type', 'value'}
not documented
Total number of docstring violations: 5
```
The enums are all defined in Cython with `cpdef`, which is a wrapper for
https://peps.python.org/pep-0435/. Maybe cython or numpydoc isn't parsing
correctly?
The `pyarrow._dataset.type.FileSystemDataset.from_paths` error seems like a
bug in cython or numpydocs. The parameters are already documented and visible
here
https://arrow.apache.org/docs/python/generated/pyarrow.dataset.FileSystemDataset.html#pyarrow.dataset.FileSystemDataset.from_paths.
--
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]
