Skip to content

Conversation

@kevingurney
Copy link
Member

@kevingurney kevingurney commented Aug 17, 2023

Rationale for this change

As @kou suggested in #37215 (comment), it makes sense to rename arrow.recordbatch (all lowercase) to arrow.recordBatch (camelCase).

recordBatch is the first "two-word" function in the top-level arrow.* package, so it makes sense to establish a clear camelCase standard for "multi-word" functions in the MATLAB interface at this point.

One part of the rationale motivating this change is that other language bindings follow a similar pattern (e.g. pyarrow.record_batch instead of pyarrow.recordbatch).

What changes are included in this PR?

  1. Renamed arrow.recordbatch (all lowercase) to arrow.recordBatch (camelCase).
  2. Updated documentation and tests to reflect arrow.recordbatch being renamed to arrow.recordBatch.

Are these changes tested?

Yes.

  1. All existing MATLAB tests have been updated to use the new name arrow.recordbatch and are passing on my Debian 11 machine.

Are there any user-facing changes?

Yes.

This PR includes breaking changes to public APIs.

The public facing API arrow.recordbatch has been renamed to arrow.recordBatch. Since the MATLAB interface is still "pre 1.0", we don't expect this change to have a significant impact.

Notes

  1. Thank you @sgilmore10 for your help with this pull request!

Co-authored-by: Sarah Gilmore <sgilmore@mathworks.com>
Copy link
Member

@sgilmore10 sgilmore10 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No flags. Thanks for doing this!

@kevingurney kevingurney changed the title GH-37222: [MATLAB] Rename arrow.recordbatch (all lowercase) to arrow.recordBatch (camelCase) GH-37222: [Docs][MATLAB] Rename arrow.recordbatch (all lowercase) to arrow.recordBatch (camelCase) Aug 17, 2023
@kevingurney
Copy link
Member Author

+1

@kevingurney kevingurney merged commit e44f5eb into apache:main Aug 17, 2023
@kevingurney kevingurney removed the awaiting committer review Awaiting committer review label Aug 17, 2023
@kevingurney kevingurney deleted the GH-37222 branch August 17, 2023 16:14
@conbench-apache-arrow
Copy link

After merging your PR, Conbench analyzed the 5 benchmarking runs that have been run so far on merge-commit e44f5eb.

There were no benchmark performance regressions. 🎉

The full Conbench report has more details.

loicalleyne pushed a commit to loicalleyne/arrow that referenced this pull request Nov 13, 2023
…ase) to `arrow.recordBatch` (camelCase) (apache#37223)

### Rationale for this change

As @ kou suggested in apache#37215 (comment), it makes sense to rename `arrow.recordbatch` (all lowercase) to `arrow.recordBatch` (camelCase).

`recordBatch` is the first "two-word" function in the top-level `arrow.*` package, so it makes sense to establish a clear camelCase standard for "multi-word" functions in the MATLAB interface at this point.

One part of the rationale motivating this change is that other language bindings follow a similar pattern (e.g. `pyarrow.record_batch` instead of `pyarrow.recordbatch`).

### What changes are included in this PR?

1. Renamed `arrow.recordbatch` (all lowercase) to `arrow.recordBatch` (camelCase).
2. Updated documentation and tests to reflect `arrow.recordbatch` being renamed to `arrow.recordBatch`.

### Are these changes tested?

Yes.

1. All existing MATLAB tests have been updated to use the new name `arrow.recordbatch` and are passing on my Debian 11 machine.

### Are there any user-facing changes?

Yes.

**This PR includes breaking changes to public APIs.**

The public facing API `arrow.recordbatch` has been renamed to `arrow.recordBatch`. Since the MATLAB interface is still "pre 1.0", we don't expect this change to have a significant impact.

### Notes

1. Thank you @ sgilmore10 for your help with this pull request!
* Closes: apache#37222

Lead-authored-by: Kevin Gurney <kgurney@mathworks.com>
Co-authored-by: Sarah Gilmore <sgilmore@mathworks.com>
Signed-off-by: Kevin Gurney <kgurney@mathworks.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs][MATLAB] Rename arrow.recordbatch (all lowercase) to arrow.recordBatch (camelCase)

2 participants