NAME

Net::Gnip - interact with Gnip

SYNOPSIS

    use Net::Gnip;
    my $gnip       = Net::Gnip->new($user, $pass, $publisher_name);

    # Get a list of publisher
    my @publisher = $gnip->publishers();
    $gnip->create_publisher($name);


    # Create an activity and publish it
    my $activity   = Net::Gnip::Activity->new('added_friend', 'me');
    $gnip->publish($publisher_name, $activity);
    # or
    $gnip->publish($publisher_name, @activities);
    # or
    $gnip->publish($activity_stream);

    # Retrieve activities for a given publisher
    my $stream     = $gnip->fetch(notification => $publisher_name);
    foreach my $activity ($stream->activities) {
        print "Type=".$activity->type."\n";
    }

    # Retrieve activities for a given publisher 10 minutes ago
    my $stream     = $gnip->fetch(notification => $publisher_name, time => 10*60);

    # Retrieve activities for a given publisher from a specific time
    my $stream     = $gnip->fetch(notification => $publisher_name, time => $dt);

    # The same but get the full date
    my $stream     = $gnip->fetch(activity => $publisher_name, time => $dt);


    # Create a filter and 
    my @rules  = ( { type => 'actor', value => 'joe' } );
    my $filter     = Net::Gnip::Filter->new('my_filter', 'true', [@rules]);
    my $result     = $gnip->create_filter($publisher_name, $filter); 

    # Get a list of filters
    foreach my $filters ($gnip->filters($publisher_name)) {
        print $filter->name."\n";
    }

    
    # Get the activities from it
    my $stream     = $gnip->fetch(activity => $publisher_name, filter => $filter_name);
    foreach my $activity ($stream->activities) {
        print "Type=".$activity->type."\n";
    }
    
    # Update it
    $filter->full('false');
    $gnip->update_filter($publisher_name, $filter);

    $gnip->add_filter_rule($filter,    'actor', 'simon');
    $gnip->delete_filter_rule($filter, 'actor', 'simon')

    
    # Delete it
    $gnip->delete_filter($publisher_name, $filter);

METHODS

new <username> <password>

Create a new Gnip object

fetch <publisher> [datetime])

Gets all of the data for a specific publisher, based on the datetime parameter.

If datetime is not passed in, the current time will be used.

Note that all times need to be as UTC DateTime objects.

Returns a Net::Gnip::ActivityStream object.

publish <activity stream>

Publish an activity stream.

publish <publisher name> <activity[s]>

filters <publisher name>

Get a list of filters for this publisher.

Returns a list of Net::Gnip::Filter objects.

create_filter <publisher name> <filter>

Creates a new filter.

get_filter <publisher name> <filter>

Fetches an existing filter.

filter can either be a filter object or a name.

Returns a Net::Gnip::Filter object.

update_filter <publisher name> <filter>

Updates an existing filter.

filter can either be a filter object or a name.

Returns 1 on success and 0 on failure.

delete_filter <publisher name> <filter>

Deletes an existing filter.

filter can either be a filter object or a name.

add_filter_rule <publisher> <filter> <type> <value>

Incrementally add a filter rule.

delete_filter_rule <publisher> <filter> <type> <value>

Incrementally delete a filter rule.

publishers

Gets a list of publishers on the system

create_publisher <publisher[s]>

Takes one or more Net::Gnip::Publisher objects and creates them.

Returns 1 on success and undef on failure (and sets $@)

get <url>

Does an HTTP GET request of the passed in url, and returns the result from the server.

Returns undef on failure (and sets $@)

post <url> <data object>

Does a HTTP POST request of the passed in url and data object, and returns the result from the server.

Returns undef on failure (and sets $@)

put <url> <data>

Does an HTTP PUT request of the passed in url and data object, and returns the result from the server.

Returns undef on failure (and sets $@)

delete <url>

Does a HTTP Delete request of the passed in url and returns the result from the server.

Returns undef on failure (and sets $@)

round_time_to_nearest_bucket <datetime>

Rounds the time passed in down to the previous 1 minute mark.

Returns a new DateTime object.

sync_with_gnip_clock <datetime>

This method gets the current time from the Gnip server.

Returns a new DateTime object.

time_to_string <datetime>

Converts the time passed in to a string of the form YYYYMMDDHHMM.

AUTHOR

Simon Wistow <simon@thegestalt.org>

Based on code by ajackson from http://github.com/gnip/gnip-perl/tree/master

COPYRIGHT

Copyright 2008, Simon Wistow

Release under the same terms as Perl itself.

cpanm Net::Gnip

perl -MCPAN -e shell
install Net::Gnip