The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

MooseX::GlobRef::Role::Object - An object role for MooseX::GlobRef

SYNOPSIS

Moose::Util::MetaRole::apply_base_class_roles(
    for_class => $caller,
    roles => [ 'MooseX::GlobRef::Role::Object' ],
);

package My::IO::File;

use Moose;

extends 'Moose::Object', 'IO::File';
with 'MooseX::GlobRef::Role::Object';

has 'file' => ( is => 'ro', isa => 'Str', required => 1 );
has 'mode' => ( is => 'ro', isa => 'Str', default => 'r' );

sub BUILD {
    my ($fh) = @_;
    $fh->open( $fh->file, $fh->mode );
};

sub slurp {
  my ($fh) = @_;
  local $/ = undef;
  return $fh->getline;
};

my $io = My::IO::File->new( file => '/etc/passwd' );
print "::::::::::::::\n";
print $io->file, "\n";
print "::::::::::::::\n";
print $io->slurp;

DESCRIPTION

This is a role for Moose::Object which is applied by MooseX::GlobRef. It allows to store Moose object in glob reference of file handle.

The MooseX::GlobRef package should be used instead for Moose classes but the MooseX::GlobRef::Role::Object can be helpful if you want to extend non-Moose classes like IO::File or File::Temp.

METHODS

<<around>> dump( maxdepth : Int = 1 ) : Array|Str

Dumps the object itself and also a hash slot of glob reference of this object. It returns an array or string depended on context.

See Moose::Object.

SEE ALSO

MooseX::GlobRef, Moose::Object, Moose::Role.

AUTHOR

Piotr Roszatycki <dexter@cpan.org>

LICENSE

Copyright (c) 2007, 2008, 2009, 2010 Piotr Roszatycki <dexter@cpan.org>.

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

See http://dev.perl.org/licenses/artistic.html