sgilmore10 opened a new pull request, #37043:
URL: https://github.com/apache/arrow/pull/37043
<!--
Thanks for opening a pull request!
If this is your first pull request you can find detailed information on how
to contribute here:
* [New Contributor's
Guide](https://arrow.apache.org/docs/dev/developers/guide/step_by_step/pr_lifecycle.html#reviews-and-merge-of-the-pull-request)
* [Contributing
Overview](https://arrow.apache.org/docs/dev/developers/overview.html)
If this is not a [minor
PR](https://github.com/apache/arrow/blob/main/CONTRIBUTING.md#Minor-Fixes).
Could you open an issue for this pull request on GitHub?
https://github.com/apache/arrow/issues/new/choose
Opening GitHub issues ahead of time contributes to the
[Openness](http://theapacheway.com/open/#:~:text=Openness%20allows%20new%20users%20the,must%20happen%20in%20the%20open.)
of the Apache Arrow project.
Then could you also rename the pull request title in the following format?
GH-${GITHUB_ISSUE_ID}: [${COMPONENT}] ${SUMMARY}
or
MINOR: [${COMPONENT}] ${SUMMARY}
In the case of PARQUET issues on JIRA the title also supports:
PARQUET-${JIRA_ISSUE_ID}: [${COMPONENT}] ${SUMMARY}
-->
### Rationale for this change
Now that we've have the basic building blocks for tabular IO in the MATLAB
Interface (`Array`, `Schema`, `RecordBatch`), we can implement a Feather V1
writer in terms of the new APIs.
This is the first in a series of pull requests in which we will work on
replacing the legacy feather V1 infrastructure with a new implementation that
use the MATLAB Interface APIs. A side effect of doing this work is that we can
eventually delete a lot of legacy build infrastructure and code.
### What changes are included in this PR?
Added a new class called `arrow.internal.io.feather.Writer` which can be
used to write feather V1 files. It has one public property named `Filename` and
one public method `write`.
Below is an example of its usage:
```matlab
>> T = table([1; 2; 3], single([10; 11; 12]));
T =
3×2 table
Var1 Var2
____ ____
1 10
2 11
3 12
>> filename = "/tmp/table.feather";
>> writer = arrow.internal.io.feather.Writer(filename)
writer =
Writer with properties:
Filename: "/tmp/table.feather"
>> writer.write(T);
```
<!--
There is no need to duplicate the description in the issue here but it is
sometimes worth providing a summary of the individual changes in this PR.
-->
### Are these changes tested?
Yes, added a new test file called `tRoundTrip.m` in the
`matlab/test/arrow/io/feather` folder.
### Are there any user-facing changes?
No.
### Future Directions
1. Add a new class for reading feather V1 files (See #37041).
2. Integrate this class in the public `featherwrite` function.
3. Once this class is integrated with `featherwrite`, we can delete the
legacy build infrastructure and source code.
--
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]
