Skip to content
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

lib: add grass JSON API #4801

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

NishantBansal2003
Copy link
Contributor

Pull Request Description

Ref #4697

Purpose:

This PR addresses #4697 by adding the gparson wrapper for better JSON handling in GRASS GIS.

Changes:

  • Added thin wrapper of the parson with a unique GRASS API.
  • Added unit tests to cover all major operations.

Signed-off-by: Nishant Bansal <[email protected]>
Signed-off-by: Nishant Bansal <[email protected]>
@github-actions github-actions bot added C Related code is in C HTML Related code is in HTML libraries docs labels Dec 4, 2024
@nilason
Copy link
Contributor

nilason commented Dec 5, 2024

Sorry for being slow on response!

What you have come up with looks promising. But before we go into detail, there is structural change I'd prefer we should pursue. As this now stands, we will end up with two json libraries: parson.so and gparson.so. It would be better to end up having only one, the latter. Do you think of a possible solution to this, without changing code that now links to parson.so? Phasing out the direct use of parson API may then be made module by module.

@NishantBansal2003
Copy link
Contributor Author

To ensure we only have one JSON library (gparson) while maintaining backward compatibility, the possible solutions from my understanding are:

  • We’ll keep parson internal to gparson, ensuring it is only used by gparson. Other modules will interact with gparson directly, preventing any direct access to parson from other modules. This can be achieved by making parson a static library, accessible only via gparson.
  • Initially, we’ll retain the parson API for compatibility, but over time, the goal is to make sure that parson is only used by gparson, and all other modules rely on gparson directly.

This solution is based on my current understanding, and there may be better approaches. I welcome any input or guidance from other contributors on this.

@nilason
Copy link
Contributor

nilason commented Dec 5, 2024

A possible way may be to (1) include/add the "gparson" API on top/together with current parson; (2) convert current user code to use gparson API; and (3) drop/rename current parson library to gparson (original parson API will unavoidably be accessible, but not encouraged–not part of GRASS API–a situation we will end up with in any case).

Perhaps gjson would be a better name for GRASS json API library, thoughts anyone? Anonymising the backbone library, for future eventual freedom to change.

Signed-off-by: Nishant Bansal <[email protected]>
@NishantBansal2003
Copy link
Contributor Author

I made some modifications and also added tests. Please take a look.
cc: @nilason

@nilason
Copy link
Contributor

nilason commented Dec 9, 2024

I like the direction this is going (and I tested with an updated version of #4665, which passed on Mac and Win runner). Before moving forward–and to avoid doing changes back-and-forth–let us hear out the opinion of other dev team mates. In particular on the question of unit tests in library: should they be in-compilation tests (like lib/vector/diglib or lib/cdhc) or post-compilation tests (like lib/raster3d)?

@NishantBansal2003
Copy link
Contributor Author

I like the direction this is going (and I tested with an updated version of #4665, which passed on Mac and Win runner). Before moving forward–and to avoid doing changes back-and-forth–let us hear out the opinion of other dev team mates. In particular on the question of unit tests in library: should they be in-compilation tests (like lib/vector/diglib or lib/cdhc) or post-compilation tests (like lib/raster3d)?

Can you provide some opinions here...
cc: @echoix @cwhite911 @petrasovaa @wenzeslaus

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
C Related code is in C docs HTML Related code is in HTML libraries
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants