GH-45908: [C++][Docs] Rename and expose basic {Array,...}FromJSON helpers as public APIs by amoeba · Pull Request #46180 · apache/arrow

amoeba · 2025-04-18T18:37:17Z

Rationale for this change

These functions are generally useful and stable so it would be a good idea to clearly include them in the public API. I'm starting here with just the basic ones in order to make the PR small. See #45908 for more information.

What changes are included in this PR?

Moves ArrayFromJSON, ChunkedArrayFromJSON, DictArrayFromJSON, ScalarFromJSON, DictScalarFromJSON from arrow::ipc::internal namespace to arrow::json so it's clearer they're part of the public API and that they're more useful than just for IPC
Renames each of the above from {Array,...}FromJSON to {Array,...}FromJSONString to avoid confusion between these helpers and the main JSON(L) reader
Renames arrow/util/json_simple.{h,cc} to arrow/json/from_string.{h,cc} both because of the namespace jump but also because the filename is more clear.
Adds User Guide and adds a listing in the API docs for moved functions

Are these changes tested?

Yes.

Are there any user-facing changes?

This expands the scope of our public API but does not break any existing public APIs though it's possible users

GitHub Issue: [C++] Expose {Array,...}FromJSON as public APIs #45908

This moves the following functions from the IPC namespace to util to make it clear these are useful outside of their use in Arrow IPC. - ArrayFromJSON - ChunkedArrayFromJSON - DictArrayFromJSON - ScalarFromJSON - DictScalarFromJSON

amoeba · 2025-04-21T02:41:13Z

@github-actions crossbow submit preview-docs

github-actions · 2025-04-21T02:43:33Z

Revision: cf808f9

Submitted crossbow builds: ursacomputing/crossbow @ actions-7a9d15701e

Task	Status
preview-docs

amoeba · 2025-04-21T03:27:46Z

Docs previews:

zanmato1984

Thank you for bringing this up! I have some minor comments.

bkietz · 2025-05-08T20:25:33Z

Well, those cases appear to have been responsible for that failure. After looking more closely, we've got an issue open for this already: #46343

This reverts commit b5ed9b1.

amoeba · 2025-05-08T21:04:55Z

Nice catch. I commented there. I reverted the testing commit so the PR is in a merge-able state. Would you be okay if we merged with that one job failing or should we wait on #46343 and rebase before merge?

EnricoMi

Some minor comments.

Co-authored-by: Enrico Minack <github@enrico.minack.dev>

amoeba · 2025-05-09T17:59:38Z

Thanks @bkietz. There were a couple of comments from @EnricoMi and I'll merge this once those are resolved.

EnricoMi

LGTM!

amoeba · 2025-05-14T14:23:00Z

Merged. Thanks all for the reviews, it's greatly appreciated.

pitrou · 2025-05-14T14:37:20Z

I posted a couple comments, it would be nice to do a post-commit polish PR.

amoeba · 2025-05-14T14:46:20Z

I'll file an issue to follow-up on those.

conbench-apache-arrow · 2025-05-14T21:37:34Z

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

There were no benchmark performance regressions. 🎉

The full Conbench report has more details. It also includes information about 1 possible false positive for unstable benchmarks that are known to sometimes produce them.

Fixesapache#46180 (comment)

…nternal.h (apache#46695) ### Rationale for this change Addresses apache#46180 (comment). One of three PRs to resolveapache#46439. ### What changes are included in this PR? - Remove unneeded namespace prefix in test_util_internal.h. ### Are these changes tested? Yes. Impacted tests still pass. ### Are there any user-facing changes? No. * GitHub Issue: apache#46439 Authored-by: Bryce Mecum <petridish@gmail.com> Signed-off-by: Sutou Kouhei <kou@clear-code.com>

amoeba · 2025-06-05T00:47:15Z

The post-merge comments were all resolved in #46439.

This comment was marked as resolved.
Sign in to view

github-actionsBot added Component: C++ awaiting review Awaiting review Component: Python Component: Documentation labels Apr 18, 2025

amoeba added 2 commits April 20, 2025 18:00

Move core *FromJSON helpers from ipc to util NS
e6b8267
This moves the following functions from the IPC namespace to util to make it clear these are useful outside of their use in Arrow IPC. - ArrayFromJSON - ChunkedArrayFromJSON - DictArrayFromJSON - ScalarFromJSON - DictScalarFromJSON

Add docs for FromJSON helpers
cf808f9

amoeba force-pushed the feature/GH-45908--expose-from-json branch from 3b6015e to cf808f9Compare April 21, 2025 01:00

amoeba mentioned this pull request Apr 21, 2025
[C++] Fix ASAN issue in the arrow-dataset-dataset-writer-test #45235
Closed

amoeba changed the title ~~GH-45908: [C++] Expose {Array,...}FromJSON as public APIs~~GH-45908: [C++] Expose basic {Array,...}FromJSON helpers as public APIsApr 21, 2025

amoeba marked this pull request as ready for review April 21, 2025 02:36

amoeba requested review from AlenkaF, raulcd, rok and westonpace as code owners April 21, 2025 02:36

amoeba requested review from bkietz, pitrou and zanmato1984 April 21, 2025 02:37

amoeba mentioned this pull request Apr 21, 2025
[C++] Expose {Array,...}FromJSON as public APIs #45908
Closed

amoeba changed the title ~~GH-45908: [C++] Expose basic {Array,...}FromJSON helpers as public APIs~~GH-45908: [C++][Docs] Expose basic {Array,...}FromJSON helpers as public APIsApr 21, 2025

Update meson.build
644d407

zanmato1984 reviewed Apr 21, 2025
View reviewed changes

Comment threadcpp/src/arrow/CMakeLists.txt
Comment threadcpp/src/arrow/acero/hash_join_node_test.cc Outdated
Comment threadcpp/src/arrow/meson.build Outdated
Comment threaddocs/source/cpp/api/array.rst Outdated

github-actionsBot added awaiting committer review Awaiting committer review and removed awaiting review Awaiting review labels Apr 21, 2025

amoeba added 3 commits April 21, 2025 14:52

Fix path in meson.build
6fbb2f3

Remove JSON bits from IPC
ce373f5

Use using in hash_join_node_test.cc
6479400

testing theory on ci failure
b5ed9b1

amoeba mentioned this pull request May 8, 2025
[CI][Python] Conda Python 3.10 jobs fail with UnicodeDecodeError due to gdb issue #46343
Closed

Revert "testing theory on ci failure"
96ed729
This reverts commit b5ed9b1.

EnricoMi reviewed May 9, 2025
View reviewed changes

bkietz approved these changes May 9, 2025
View reviewed changes

github-actionsBot added awaiting merge Awaiting merge and removed awaiting change review Awaiting change review labels May 9, 2025

Update cpp/examples/arrow/from_json_string_example.cc
f91dd1c
Co-authored-by: Enrico Minack <github@enrico.minack.dev>

EnricoMi approved these changes May 10, 2025
View reviewed changes

amoeba merged commit 07778d9 into apache:mainMay 14, 2025

amoeba removed the awaiting merge Awaiting merge label May 14, 2025

pitrou reviewed May 14, 2025
View reviewed changes

Comment threadcpp/src/arrow/dataset/test_util_internal.h

github-actionsBot added the awaiting committer review Awaiting committer review label May 14, 2025

pitrou reviewed May 14, 2025
View reviewed changes

Comment threadcpp/src/arrow/json/from_string.cc

pitrou reviewed May 14, 2025
View reviewed changes

Comment threadcpp/src/arrow/json/from_string.h

amoeba mentioned this pull request May 14, 2025
[C++] Address post-merge review comments in PR exposing {Array,...}FromJSON helpers in public API #46439
Closed

This was referenced May 16, 2025
Fix Meson Confiugration to Include Recent JSON Changes #46478
Closed
GH-46478: [C++] Implement recent JSON changes into Meson configuration #46479
Merged

amoeba added a commit to amoeba/arrow that referenced this pull request Jun 3, 2025
Remove unneeded ns prefix
18f6225
Fixesapache#46180 (comment)

amoeba mentioned this pull request Jun 3, 2025
GH-46439: [C++] Remove unneeded namespace prefix in test_util_internal.h #46695
Merged

sjperkins mentioned this pull request Jul 21, 2025
Arrow 21.0.0 moved ArrayFromJSON utilities to a public API ska-sa/arcae#159
Closed

Uh oh!

Conversation

amoeba commented Apr 18, 2025• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Rationale for this change

What changes are included in this PR?

Are these changes tested?

Are there any user-facing changes?

Uh oh!

This comment was marked as resolved.

amoeba commented Apr 21, 2025

Uh oh!

github-actionsBot commented Apr 21, 2025

Uh oh!

amoeba commented Apr 21, 2025

Uh oh!

zanmato1984 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bkietz commented May 8, 2025

Uh oh!

amoeba commented May 8, 2025

Uh oh!

EnricoMi left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

amoeba commented May 9, 2025

Uh oh!

EnricoMi left a comment

Choose a reason for hiding this comment

Uh oh!

amoeba commented May 14, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pitrou commented May 14, 2025

Uh oh!

amoeba commented May 14, 2025

Uh oh!

conbench-apache-arrowBot commented May 14, 2025

Uh oh!

amoeba commented Jun 5, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

amoeba commented Apr 18, 2025•
edited
Loading