New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
ARROW-7430: [Python] Add more docstrings to dataset bindings #6059
ARROW-7430: [Python] Add more docstrings to dataset bindings #6059
Conversation
@@ -134,6 +135,31 @@ cdef class DefaultPartitionScheme(PartitionScheme): | |||
|
|||
|
|||
cdef class SchemaPartitionScheme(PartitionScheme): | |||
""" | |||
A PartitionScheme based on a specified Schema. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There is still discussion to remove those classes, but already wrote those docstrings last week, so including here any way.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Either way, we can reuse these docstring because the schemes must be explained.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just a couple details.
python/pyarrow/_dataset.pyx
Outdated
@@ -270,19 +331,48 @@ cdef class DataSourceDiscovery: | |||
return schemas | |||
|
|||
def inspect(self): | |||
""" | |||
Insects all data fragments and returns a common Schema. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Inspect" and "return"
python/pyarrow/_dataset.pyx
Outdated
cdef CResult[shared_ptr[CDataSource]] result | ||
with nogil: | ||
result = self.discovery.Finish() | ||
return DataSource.wrap(GetResultValue(result)) | ||
|
||
|
||
cdef class FileSystemDataSourceDiscovery(DataSourceDiscovery): | ||
""" | ||
Creates a DataSource from a list of paths with schema inspection. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Create"?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just a couple nits. You may ignore them if you want :-)
fb51e29
to
127dd80
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
+1
127dd80
to
4e8fa9f
Compare
No description provided.