Log-Any-Adapter-MacOS-OSLog

Log to macOS' unified logging system from Perl.

This adapter bridges Log::Any to Apple's structured logging API via FFI (foreign function interface) and a C wrapper. It supports all standard log levels and lets you choose between public and private visibility for each message.

It also comes with a simple command line script, maclog.

Why?

macOS uses a modern, structured logging system that’s not directly accessible from Perl. This module provides a native-feeling solution without requiring Swift or Objective-C code.

System requirements

Runtime

• macOS Sierra 10.12 or higher
• Perl v5.18 or higher
• various Perl modules that will be installed automatically should you use a utility like cpan or cpanm

Additional building requirements

• Xcode from the Mac App Store

• Xcode command line tools, installable via:

  xcode-select --install
  

Installation

perl Makefile.PL
make
make test
make install

Example usage

use Log::Any::Adapter ('MacOS::OSLog', subsystem => 'com.example.perl');
use Log::Any qw($log);

$log->info("Hello from Perl!");

For more information, consult the full module documentation by running:

perldoc Log::Any::Adapter::MacOS::OSLog

Status

This is a work in progress. It's currently tested on macOS Sequoia 15.6 and aims to stay compatible with future releases. Feedback and contributions welcome!

Learn More

For background, design rationale, and implementation details, see the full blog post.

License

See the enclosed LICENSE file.