=encoding utf8

=head1 NAME

Twitter::Queue - the micro blogging cloud based FIFO queue

=head1 SYNOPSIS

  use Twitter::Queue;

  my $q = Twitter::Queue-new({
    consumer_key        => '311ee384568611e79db19e8',
    consumer_secret     => '3cac5b46568611e79c9c5ad',
    access_token        => '45d89cc0568611e7991c72d',
    access_token_secret => '470dbab2568611e79c5d8ad',
  });

  $q->add('{"some":"jsondata"}');
  ...

  while (my $item = $q->next) {
    # do something
  }

=head1 METHODS

=head2 new ($args)

Constructor, returns a new C<Twitter::Queue> object.

Requires hashref containing these key values:

  consumer_key        => '...',
  consumer_secret     => '...',
  access_token        => '...',
  access_token_secret => '...',
  size                => 100, # optional queue size

The Twitter key/secrets come from the Twitter API. You need to L<register|http://apps.twitter.com>
an application with Twitter in order to obtain them.

=head2 add ($item)

Adds C<$item> to the queue, C<$item> must be be a string that complies with Twitter's
character counting L<rules|https://dev.twitter.com/basics/counting-characters>.

=head2 next ()

Returns the next item in the queue, removing it from the queue. Returns C<undef>
if the queue is empty.

=head1 AUTHOR

E<copy> 2017 David Farrell

=head1 LICENSE

The (two-clause) FreeBSD License, see LICENSE.


=cut