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 摘要。