/ 
Module-Generic-v1.3.0
River stage two • 21 direct dependents • 23 total dependents

Changes for version v1.3.0 - 2026-03-28

  • Added XS implementations of twelve frequently-called utility methods, providing a measurable performance improvement for all code inheriting from Module::Generic. The XS versions are loaded automatically at startup via XSLoader and fall back transparently to the pure-Perl implementations when the compiled shared library is unavailable (pure-Perl installs remain fully functional without a C compiler). The following methods are now accelerated by XS: _get_args_as_array, _is_array, _is_code, _is_glob, _is_hash, _is_integer, _is_number, _is_object, _is_overloaded, _is_scalar, _obj2h, _refaddr.
  • The XS helper mg_get_sv_arg() correctly handles tied scalars (such as Module::Generic::LvalueGuard) by using sv_mortalcopy() to trigger the FETCH magic before inspecting SV flags, mirroring the behaviour of Scalar::Util::reftype() in all cases.
  • Extended Generic.xs (previously only used by Module::Generic::File::Magic) with a new MODULE = Module::Generic / PACKAGE = Module::Generic section for the utility method XS functions. A shared double-load guard ($Module::Generic::XS_LOADED) prevents the "subroutine redefined" warnings that would otherwise occur when both Module::Generic and Module::Generic::File::Magic trigger XSLoader on the same .so.
  • Fixed a latent bug in the pure-Perl implementations of _is_array, _is_code, _is_glob, _is_integer, _is_number, _is_scalar: the guard 'return(0) if( scalar( @_ < 2 ) )' was incorrectly testing the boolean result of the comparison rather than the argument count. Corrected to 'return(0) if( scalar( @_ ) < 2 )'.
  • Fixed _is_overloaded, _is_object to return 0 (explicit false integer) instead of undef in all negative cases, in line with the boolean contract of the _is_* family.
  • Fixed _is_code to use Scalar::Util::reftype() instead of ref() so that blessed coderefs are correctly recognised (ref() returns the class name, not 'CODE', for blessed coderefs).
  • Added unit test t/33.xs_methods.t covering all twelve XS-accelerated methods, verifying correctness of edge cases including undef arguments, blessed references, tied scalars, strict mode for _is_hash, and element mutability for _get_args_as_array.
  • Fixed GV_ADD | GV_ADDMULTI in _set_backend() within Generic.xs to suppress the spurious 'Name used only once: possible typo' warning emitted by DynaLoader for $Module::Generic::File::Magic::BACKEND.

Documentation

CONTRIBUTING.md
README.md
Module::Generic::DateTime::Interval
An Enhanced DateTime::Duration Object
Module::Generic::Iterator::Element
An Array Iterator Element Object Class
Module::Generic::RegexpCapture
A Regexp Result Object
Module::Generic::SemStat
Shared Memory Manipulation

Modules

Module::Generic
Generic Module to inherit from
Module::Generic::Array
An Array Manipulation Object Class
Module::Generic::Boolean
Boolean Representation Class
Module::Generic::DateTime
A DateTime wrapper for enhanced features
Module::Generic::Dynamic
Dynamic Object Class
Module::Generic::Exception
Generic Module Exception Class
Module::Generic::File
File Object Abstraction Class
Module::Generic::File::Cache
File-based Cache
Module::Generic::File::IO
File IO Object Wrapper
Module::Generic::File::Magic
File type and MIME detection with 3-level backend cascade
Module::Generic::File::Mmap
MMap File Class
Module::Generic::Finfo
File Info Object Class
Module::Generic::Global
Contextual global storage by namespace, class or object
Module::Generic::Hash
Hash Manipulation Object Class
Module::Generic::HeaderValue
Generic Header Value Parser
Module::Generic::Iterator
An Array Iterator Object Class
Module::Generic::JSON
A thin and reliable wrapper around JSON
Module::Generic::Null
Null Value Chaining Object Class
Module::Generic::Number
Number Manipulation Object Class
Module::Generic::Scalar
String Manipulation Object Class
Module::Generic::Scalar::IO
Generic Module Scalar IO Class
Module::Generic::SharedMem
Shared Memory Manipulation
Module::Generic::SharedMemXS
Shared Memory Manipulation with XS API
Module::Generic::Tie
Object Access Control Class
Module::Generic::TieHash
Generic Tie Hash Mechanism for Object Oriented Hashes

Provides

Module::Generic::DateTime::Interval
in lib/Module/Generic/DateTime.pm
Module::Generic::Infinity
in lib/Module/Generic/Number.pm
Module::Generic::Iterator::Element
in lib/Module/Generic/Iterator.pm
Module::Generic::Nan
in lib/Module/Generic/Number.pm
Module::Generic::NumberSpecial
in lib/Module/Generic/Number.pm

Other files