The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
package Bot::Cobalt::IRC::Event::Mode;
$Bot::Cobalt::IRC::Event::Mode::VERSION = '0.017004';
use strictures 2;

use Bot::Cobalt;
use Bot::Cobalt::Common qw/:types/;

use IRC::Utils qw/parse_mode_line eq_irc/;

use Moo;
extends 'Bot::Cobalt::IRC::Event';

has mode   => (
  required  => 1,
  is        => 'rw',
  isa       => Str,
);

has target => (
  required  => 1,
  is        => 'rw',
  isa       => Str,
);

has is_umode => (
  lazy      => 1,
  is        => 'ro',
  isa       => Bool,
  default   => sub {
    my ($self)  = @_;
    my $casemap = core->get_irc_casemap( $self->context );
    my $irc_obj = core->get_irc_object( $self->context );
    my $me = $irc_obj->nick_name;
    eq_irc($me, $self->target) ? 1 : 0
  },
);

has channel => (
  lazy      => 1,
  is        => 'rw',
  default   => sub {
    my ($self) = @_;
    $self->is_umode ? undef : $self->target
  },
);

has args => (
  lazy      => 1,
  is        => 'rw',
  isa       => ArrayObj,
  coerce    => 1,
  default   => sub { [] },
);

has hash => (
  lazy      => 1,
  is        => 'ro',
  isa       => HashObj,
  coerce    => 1,
  predicate => 'has_hash',
  builder   => '_build_hash',
);

sub _build_hash {
  my ($self) = @_;
  parse_mode_line( $self->mode, @{ $self->args })
}

1;
__END__

=pod

=head1 NAME

Bot::Cobalt::IRC::Event::Mode - IRC Event subclass for mode changes

=head1 SYNOPSIS

  unless ( $mode_ev->is_umode ) {
    my $channel = $mode_ev->channel;
    my $modestr = $mode_ev->mode;
    my $args    = $mode_ev->args;
    my $parsed  = $mode_ev->hash;
  }

=head1 DESCRIPTION

This is the L<Bot::Cobalt::IRC::Event> subclass for mode changes, both user
and channel.

=head2 mode

Returns the mode change as a string.

=head2 is_umode

Returns a boolean value indicating whether or not this appears to be a
umode change on ourselves.

=head2 target

Returns the target of the mode change; this may be a channel or our
nickname.

=head2 channel

If L</is_umode> is false, B<channel> will return the same value as
L</target>.

=head2 args

Returns a L<List::Objects::WithUtils::Array> containing any parameters for the
mode change.

=head2 hash

Returns a L<List::Objects::WithUtils::Hash> containing the hashref generated
by L<IRC::Utils/parse_mode_line>.

=head1 AUTHOR

Jon Portnoy <avenj@cobaltirc.org>

L<http://www.cobaltirc.org>

=cut