Support B::Hooks::OP::Check method syntax for Data::Page::Pagination

Open
#2,089 2 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
Clearly specified
Activity status
Active
Tech stack
java, perl
Domain
backend, compilers

Research direction

Start with dev/modules/devel_declare.md and related parser work in #1292 to understand the documented limitation and proposed parser keyword-plugin API. Then trace how Syntax::Feature::Method uses B::Hooks::OP::Check and reproduce the failure with Data::Page::Pagination 0.006 on PerlOnJava. Done means method declarations load and the upstream tests pass on both JVM and interpreter backends, with focused regression coverage for declarations and constructor type checks.

Written by the indexing model from the issue text.

Description

area:cpan-port area:parser bug

Summary

Data::Page::Pagination 0.006 fails its upstream tests under PerlOnJava because its syntax qw(method) feature cannot load the native B::Hooks::OP::Check dependency. B::Hooks::OP::Check has XS code but no Java XS implementation, and its load fails with no Java XS implementation available.

Evidence

CPAN random tester run 20261117-153921-75160:

  • System Perl 5.42.2: Data-Page-Pagination-0.006 passed all 18 tests across 7 test programs. The normal optional skips remained skipped.
  • PerlOnJava: 3 of the 5 executed subtests failed in t/01_basics.t; the program exited 255 after four tests. The failing checks were use Data::Page::Pagination and the two expected constructor type-constraint errors.
  • The first failure is explicit: Can't load loadable object for module B::Hooks::OP::Check: no Java XS implementation available, while loading syntax from Syntax-Feature-Method.
  • Later constructor errors report Found unknown attribute(s) init_arg passed to the constructor: page page_numbers. These are downstream of the failed compile-time method feature and should be rechecked once that feature loads correctly.

The same archived run's system-Perl oracle passed the target distribution's complete suite. This is a PerlOnJava compatibility failure, not an upstream test failure or missing environment prerequisite.

Root cause and scope

Data::Page::Pagination declares methods with method and imports them through use syntax qw(method). That syntax feature depends on parser hooks supplied by B::Hooks::OP::Check (through the Devel::Declare-based method feature). The CPAN install can copy the XS module's Perl files, but PerlOnJava cannot load the native hook because there is no Java implementation. As a result, the package's compile-time declarations are not installed, and module loading and subsequent object construction fail.

The existing design note dev/modules/devel_declare.md records that B::Hooks::OP::Check is pure XS and that parser hook support is not implemented. This issue should establish the minimum compatible path for B::Hooks::OP::Check and the parser/declarator behavior needed by Syntax::Feature::Method, then use this distribution as integration coverage. A Java shim that only makes use B::Hooks::OP::Check succeed is insufficient if it does not implement the compile-time declaration behavior.

Reverse dependencies

MetaCPAN's reverse_dependencies/module/B::Hooks::OP::Check endpoint returned 19 records. Filtering to released distributions with a runtime / requires dependency yields 18 unique distributions; 0 were released in the five years before 2026-11-17. Examples include Devel-Declare, B-Hooks-OP-Check-EntersubForCV, B-Hooks-OP-Check-LeaveEval, B-Hooks-Parser, TryCatch, signatures, multidimensional, and Unicode-Casing. This count indicates a modest but concrete downstream surface; the method-syntax integration failure is independently confirmed by the passing system-Perl oracle and PerlOnJava log.

Acceptance criteria

  • Provide Java-backed support sufficient for B::Hooks::OP::Check consumers to load and register the needed compile-time method declarator behavior, or implement an equivalent parser-integrated compatibility path.
  • Syntax::Feature::Method and Data::Page::Pagination 0.006 load and pass their upstream tests on PerlOnJava.
  • Preserve system-Perl behavior and validate the supported path on both JVM and interpreter backends.
  • Add focused project-owned regression coverage for the method declaration behavior and the constructor/type-check cases above.

Related broader parser work: #1292, “Design a parser keyword-plugin API for PerlOnJava”. The existing design note is dev/modules/devel_declare.md.

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.