Port JSON::SL using existing JSON infrastructure where possible

Open
#2,097 3 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
java, perl

Research direction

Start with docs/reference/bundled-modules.md and dev/modules/cpanel_json_xs.md, then pin an upstream JSON::SL release and compare its module source, dependencies, documentation, and tests with bundled JSON::PP and the existing shims. Run the upstream tests on system Perl and both PerlOnJava backends, recording gaps and missing prerequisites. Done means a compatible implementation passes the selected tests and regressions on both backends, bundled loading works in an isolated CPAN home, and the documentation records any unsupported behavior.

Written by the indexing model from the issue text.

Description

Goal

Add compatibility support for JSON::SL in PerlOnJava, reusing the bundled JSON implementation and module-loading infrastructure wherever the upstream API allows.

Existing infrastructure to assess

PerlOnJava bundles JSON::PP and uses it for JSON, Cpanel::JSON::XS, and other JSON compatibility layers. Before adding code, compare the current JSON::SL API and tests with those providers. Prefer a small Perl shim or adapter over a separate Java encoder/decoder if JSON::PP can provide the required behavior. Add Java support only for functionality that cannot be expressed compatibly through the existing Perl implementation.

Work

  • Pin the upstream JSON::SL release and inspect its module source, dependencies, documentation, and unchanged tests.
  • Identify API and behavior overlap with bundled JSON::PP and existing JSON shims; document any differences requiring adaptation.
  • Run upstream tests on system Perl and PerlOnJava, recording missing prerequisites and untested cases.
  • Implement the smallest compatible adapter/provider, preserving upstream behavior and avoiding duplicate JSON parsing/encoding logic.
  • Add project-owned regressions for externally observed gaps, validated first with system Perl.
  • Verify loading works without installed CPAN overlays and run tests on both JVM and interpreter backends.
  • Update bundled-module and feature-matrix documentation after acceptance.

Acceptance

  • The selected upstream test suite passes on both PerlOnJava backends, with any unsupported behavior explicitly documented.
  • Focused regressions pass on system Perl and both PerlOnJava backends.
  • The implementation reuses existing JSON and loader infrastructure where compatible and documents any necessary independent code.
  • Bundled loading is verified in an isolated CPAN home without depending on an installed copy.

Initial context

docs/reference/bundled-modules.md documents bundled JSON/JSON::PP and the Cpanel::JSON::XS shim. dev/modules/cpanel_json_xs.md describes the existing JSON compatibility architecture. No upstream version or test result is asserted here; refresh both against the pinned distribution before implementation.

Dominant language
Perl
Stars
67
Forks
8
Avg merge
5h 12m
Merged PRs (30d)
131

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from fglock/PerlOnJava

All issues in fglock/PerlOnJava

Similar issues

More Perl issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.