Port Math::Random::MT as a bundled Java XS implementation
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 5/5
- Tempo estimado
- Mais de uma semana
- Facilidade para iniciantes
- 45/100
Direção de pesquisa
Start by inspecting the bundled Java XS bridge pattern and registry, then read the upstream Math-Random-MT 1.17 tests and implementation to identify the required seeded vectors and API behavior. Add the bridge, Perl shim, and focused project tests; validate those tests with system Perl first. Done means the upstream suite and both named Games-Solitaire-BlackHole-Solver tests pass on JVM and interpreter backends, with no runtime need for MT.xs or _mt.c.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Summary
Add a bundled Java implementation of Math::Random::MT so PerlOnJava can load the CPAN module without its XS binary. This should also unblock CPAN consumers that require Math::Random::MT at runtime, including Games-Solitaire-BlackHole-Solver.
Evidence
CPAN random run 20261109-091152-39587 tested Games-Solitaire-BlackHole-Solver 0.18.0. Under PerlOnJava, t/00-compile.t could not load Math::Random::MT because no Java XS implementation was available; t/01-run.t then failed after the solver could not run. The system-Perl oracle passed the complete target suite: 27/27 tests across both test programs. The same system-Perl run built and passed Math-Random-MT 1.17's nine test files (125 tests).
The failed solver requires Math::Random::MT at runtime. Targeted MetaCPAN reverse-dependency data reports 13 unique released CPAN distributions with runtime dependencies, 4 recent; examples include Games-Solitaire-BlackHole-Solver, Task-BeLike-SHLOMIF, Log-GELF-Util, and Bencher-Scenario-RandomNumbers.
Proposed implementation
Provide the Java XS bridge and Perl shim for the Math::Random::MT API, following the project's existing Java XS bridge pattern. Bouncy Castle is already a project dependency, but its documented RandomGenerator is an interface and does not itself provide an MT19937 engine. Avoid assuming that a Bouncy Castle DRBG has MT19937-compatible sequences. A small pure-Java MT19937 implementation avoids adding another runtime dependency; Apache Commons RNG is an alternative only if its additional dependency and seed/output compatibility are justified.
Preserve the CPAN module's behavior and seeded sequence, including:
- Object interface:
new,set_seed,get_seed,rand, andirand. - Functional interface and optional exports:
srand,rand, andirand. - Single unsigned 32-bit seed and array seeding (up to 624 words), including the published high-value seed cases.
- Automatic seeding when no seed is supplied, without changing Perl's
CORE::randstate beyond the upstream behavior. - Unsigned 32-bit results from
irandand[0, n)floating-point results fromrand(n).
Acceptance criteria
- Add the module to the bundled Java XS registry and provide the required Perl-facing shim, without modifying upstream CPAN tests.
- Add project-owned focused tests for seeded MT19937 output, array seeding, unsigned output, OO calls, function imports, and automatic seeding. Validate new Perl unit tests with system Perl first as required by the repository.
- Run the upstream
Math-Random-MT1.17 suite with the Java implementation and confirm its deterministic vectors match system Perl. - Re-run
Games-Solitaire-BlackHole-Solver0.18.0 with PerlOnJava and confirm botht/00-compile.tandt/01-run.tpass; test JVM and interpreter backends. - Confirm native
MT.xs/_mt.cis not needed at runtime when the Java implementation is selected.
References
- CPAN distribution: https://metacpan.org/release/FANGLY/Math-Random-MT-1.17
- Bouncy Castle
RandomGeneratorAPI: https://downloads.bouncycastle.org/java/docs/bcprov-jdk18on-javadoc/org/bouncycastle/crypto/prng/RandomGenerator.html - Apache Commons RNG MT19937 API (candidate if a dependency is preferred): https://commons.apache.org/proper/commons-rng/commons-rng-docs/apidocs/org/apache/commons/rng/core/source32/MersenneTwister.html
- Linguagem predominante
- Perl
- Estrelas
- 67
- Forks
- 8
- Merge médio
- 5h 12min
- PRs com merge (30d)
- 131
Preparar o ambiente
- Inclui um Dockerfile ou arquivo Docker Compose
- Sem modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de fglock/PerlOnJava
-
area:cpan-port bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 70/100
fglock/PerlOnJava#2153 ·
Mantenedores costumam responder em até 1 dia
-
area:cpan-port area:parser bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
fglock/PerlOnJava#2137 ·
Mantenedores costumam responder em até 1 dia
-
area:backend area:cpan-port area:runtime bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
fglock/PerlOnJava#2071 ·
Mantenedores costumam responder em até 1 dia
-
area:runtime documentation enhancement
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
fglock/PerlOnJava#1579 ·
Mantenedores costumam responder em até 1 dia
-
area:cpan-port bug
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 62/100
fglock/PerlOnJava#2157 ·
Mantenedores costumam responder em até 1 dia
Todas as issues de fglock/PerlOnJava
Issues semelhantes
-
Dev-output directory preparation accepts file-valued lib/include paths and fails on dangling linksAbertateam-cli
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 70/100
Mantenedores costumam responder em até 2 dias
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 66/100
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 93/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 73/100
inverse-inc/packetfence#9728 ·
Mantenedores costumam responder em até 1 dia
-
fix(char-create): show the real reason a character is refusedTalvez já em andamento @baphomello assumiu há 1 dia. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 84/100
Mantenedores costumam responder em até 1 dia