Port JSON::SL using existing JSON infrastructure where possible

未關閉
#2,097 3 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 1 天內回覆

還沒有人認領這個 Issue。

評估

難度
5/5
預估耗時
一週以上
新手友好度
35/100
Issue 類型
功能
描述清晰度
基本清楚
活躍度
活躍
技術堆疊
java, perl

研究方向

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.

由索引模型根據 Issue 內容生成。

描述

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.

主要語言
Perl
星號
67
分支
8
平均合併
5 小時 12 分鐘
30 天內合併 PR
131

環境準備

  • 提供 Dockerfile 或 Docker Compose 檔案
  • 沒有 Pull Request 範本
  • 閱讀貢獻指南

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

fglock/PerlOnJava 的其他 Issue

查看 fglock/PerlOnJava 的全部 Issue

相似的 Issue

更多 Perl Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。