/ 
Module-Generic-v1.2.0
River stage two • 20 direct dependents • 22 total dependents

Changes for version v1.2.0 - 2026-03-08

  • Added new module Module::Generic::File::Magic providing file type and MIME type detection through a three-level backend cascade: an XS binding to libmagic (loaded at runtime via dlopen, requiring only the libmagic1 runtime package, so no libmagic-dev at build time), a pure-Perl JSON backend using a bundled magic signature database derived from the freedesktop.org shared-mime-info XML, and a final fallback to the file(1) subprocess. The active backend is available via $Module::Generic::File::Magic::BACKEND and the backend() method. All MAGIC_* flag constants are exported via the :flags tag.
  • Added Generic.xs to the distribution to provide the XS backend for Module::Generic::File::Magic. The XS MODULE is declared as Module::Generic so that XSLoader resolves Generic.so correctly; PACKAGE = Module::Generic::File::Magic ensures all XS functions are installed in the correct namespace.
  • Added lib/Module/Generic/File/magic.json: a compact JSON magic signature database generated from the upstream freedesktop.org shared-mime-info XML (630 entries, covering binary signatures with offset ranges, endianness-aware integer types, AND sub-matches, and bitmask support).
  • Added scripts/gen_magic_json.pl: a generator script to regenerate magic.json from an updated freedesktop.org XML source. Supports XML::LibXML, XML::Twig, and XML::Parser. Included in the distribution for reference but not installed by make install.
  • Added unit test t/32.file_magic.t for Module::Generic::File::Magic.
  • Updated Module::Generic::Finfo to use Module::Generic::File::Magic for mime_type() detection, replacing the previous File::MMagic::XS / File::MMagic fallback chain.
  • Updated Module::Generic::File to add the alias method 'stringify' to 'load_utf8'
  • Added the option 'pretty' to the method 'unload_perl' in Module::Generic::File
  • Improved Module::Generic::Global by allowing a new option 'on_get' to set a callback upon deserialisation
  • Improved Module::Generic::File, and especially the subroutine 'tmpfile'
  • Improved cleanup in Module::Generic::Global

Documentation

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