INSTALLATION

To install this module type the following:
      perl Makefile.PL
      make
      make test
      make install

Perl 5.18 or newer and a functional C compiler are required. Graph analysis and Perl source emission use a mandatory XS engine. Construction, options, entry points, and callback dispatch also use XS. Perl supplies loading/export glue and integration with B::Deparse, PadWalker, and the optional compression modules.

On XPerl with class snapshot helpers, native class objects preserve their fields and ordinary blessed payloads. Reconstruction requires the class definitions and XPerl helpers to be available and bypasses constructors.

DEPENDENCIES

ExtUtils::MakeMaker configures and builds the distribution. Runtime and test dependencies are listed in Makefile.PL.

Optional dependencies:

CI tests every stable Perl series from 5.18 through 5.44, plus a development Perl built with the refcounted stack and a separate threaded build.

DEVELOPMENT

Run make tidy to format the maintained C and Perl sources. The target uses .clang-format and .perltidyrc; the Perl profile preserves the previous tidyall.sh preferences. Install clang-format 18 or newer and Perl::Tidy separately. These are optional developer tools.

Use make tidy-c or make tidy-perl for one language. Tool commands can be overridden, for example make tidy CLANG_FORMAT=clang-format-18. Generated files and Streamer.xs are excluded from automatic formatting.

Run perl -Mblib maint/memory-benchmark.pl wide 100000 for the large-graph benchmark, or use deep 1000 1 to include key-sorting callbacks.

Yves Orton, (demerphq)

Copyright (C) 2003 Yves Orton  2003-2005

This library is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.

Contains code derived from works by Gisle Aas, Graham Barr,
Jeff Pinyan, Richard Clamp, and Gurusamy Sarathy as well as
material taken from the core.