The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
use Modern::Perl;
package Net::OpenXchange::Module::Calendar;
BEGIN {
  $Net::OpenXchange::Module::Calendar::VERSION = '0.001';
}

use Moose;
use namespace::autoclean;

# ABSTRACT: OpenXchange calendar module

use HTTP::Request::Common;
use Net::OpenXchange::Object::Appointment;

has 'path' => (
    is      => 'ro',
    isa     => 'Str',
    default => 'calendar',
);

has 'class' => (
    is      => 'ro',
    isa     => 'ClassName',
    default => 'Net::OpenXchange::Object::Appointment',
);

with 'Net::OpenXchange::Module';

sub all {
    my ($self, %args) = @_;
    my %query;

    $query{folder} = $args{folder}->id if $args{folder};
    $query{start}  = $self->ox_date($args{start}) if $args{start};

    if ($args{end}) {
        my $end = $args{end}->clone();
        $end->add(days => 1);
        $query{end} = $self->ox_date($end);
    }

    my $req = GET(
        $self->req_uri(
            action  => 'all',
            columns => $self->columns,
            %query,
        )
    );

    my $res = $self->_send($req);
    return map { $self->class->thaw($_) } @{ $res->{data} };
}

__PACKAGE__->meta->make_immutable;
1;


__END__
=pod

=head1 NAME

Net::OpenXchange::Module::Calendar - OpenXchange calendar module

=head1 VERSION

version 0.001

=head1 SYNOPSIS

L<Net::OpenXchange::Module::Calendar|Net::OpenXchange::Module::Calendar>
interfaces with the calendar API of OpenXchange. It works with instances of
L<Net::OpenXchange::Object::Appointment|Net::OpenXchange::Object::Appointment>.

When using L<Net::OpenXchange|Net::OpenXchange,> an instance of this class is
provided as the C<calendar> attribute.

=head1 METHODS

=head2 all

    my @appointments = $module_calendar->all(
        start => $start_dt,
        end   => $end_dt,
    );

Fetch all appointments in the given date range and return a list of them.

=head1 AUTHOR

Maximilian Gass <maximilian.gass@credativ.de>

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Maximilian Gass.

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.

=cut