Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Port Devel::Size for PerlOnJava

Aperta
  • Qualcosa non va?
#1,880 2 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
45/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
java, perl
Ambito
backend

Direzione di ricerca

This is a substantial port: reimplement the XS-based Devel::Size as a pure-Perl module plus a Java runtime implementation inside PerlOnJava, following the project's existing module-registration pattern (look at how other bundled CPAN modules are registered). Start by running a minimal use Devel::Size qw(size total_size) to see the lookup failure, then study an existing small module port for the wiring, and adapt upstream 0.87 tests (cycle, shared-reference, export-tag cases) as project-owned tests run on both backends. Done means the acceptance criteria pass on JVM and interpreter backends; this needs real familiarity with the PerlOnJava runtime, so it suits a contributor who already knows the codebase rather than a first-timer.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

area:cpan-port enhancement help wanted

Summary

Port Devel::Size for PerlOnJava so CPAN modules that use it as a runtime dependency can load and estimate Perl object sizes on the JVM and interpreter backends.

Devel::Size is currently absent from PerlOnJava's bundled modules. A minimal use fails during module lookup:

use Devel::Size qw(size total_size);

The missing module blocks consumers that declare it as a runtime prerequisite. One concrete consumer observed during CPAN testing is DBG 0.4.1.

Upstream behavior and expected API

The current CPAN release is Devel-Size 0.87, released 2026-03-31. Its Perl wrapper exports size and total_size on request (and via the :all tag), and exposes $Devel::Size::warn and $Devel::Size::dangle controls. The implementation currently loads XS and traverses Perl values, including aggregate/reference structures.

On PerlOnJava, size($value) should return a useful estimate for the value's PerlOnJava representation, and total_size($value) should estimate the reachable structure while counting shared referents once and handling cycles. Estimates should be stable enough for comparisons and diagnostics, but need not match Perl's C allocator byte-for-byte. The module should load without XS and work on both execution backends.

Porting scope

  • Add a bundled Devel::Size Perl module and Java runtime implementation, following the existing PerlOnJava module-registration pattern.
  • Traverse PerlOnJava runtime values and account for scalars, arrays, hashes, references, code/glob-like values where supported, shared references, and cyclic graphs.
  • Preserve the documented exports and warning/dangling-reference controls where applicable; document any deliberate limitations of the Java object model.
  • Adapt the upstream tests as project-owned tests, including recursion/cycle and shared-reference cases, and run them on system Perl before relying on them for PerlOnJava behavior.
  • Document that these values estimate PerlOnJava-managed object footprints, not process RSS or exact native Perl allocation sizes.

Reverse-dependency estimate

MetaCPAN's reverse-dependency endpoint currently reports 24 distinct distributions mentioning Devel::Size across prerequisite phases. Filtering the latest release metadata to direct runtime requires gives an estimated 22 direct runtime dependants; 6 of those latest releases were updated in the two years before 2026-10-24. These are distribution-level metadata counts, not a count of active users or all transitive consumers. The runtime dependants include diagnostic, profiling, benchmark, GUI, and application distributions.

Sources: MetaCPAN reverse dependencies API and MetaCPAN API documentation.

Acceptance criteria

  • use Devel::Size qw(size total_size) succeeds without an installed native Devel::Size on both JVM and interpreter backends.
  • size and total_size return non-negative numeric estimates for supported values; aggregate size grows as contained data grows.
  • Shared referents are not counted repeatedly by total_size, and cyclic structures terminate.
  • Export/tag behavior and documented controls have focused regression coverage, with unsupported behavior documented.
  • The adapted project-owned tests pass with system Perl as an oracle where the semantics are standard Perl behavior, and on both PerlOnJava backends.

Related: #1873 (a separate FileHandle/IO::Seekable porting issue whose CPAN investigation also encountered this missing prerequisite).

Lingua principale
Perl
Stelle
65
Fork
8
Merge medio
6h 1m
PR unite (30g)
189

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di fglock/PerlOnJava

Tutte le issue di fglock/PerlOnJava

Issue simili

Altre issue su Perl

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.