NAME

Mojo::Snoo - Mojo wrapper for the Reddit API

DESCRIPTION

Mojo::Snoo is a Perl wrapper for the Reddit API which relies heavily on the Mojo modules. Mojo::Collection was the initial inspiration for going the Mojo route. Skip to synopsis to see how Mojo::Snoo can be great for one-liners, quick scripts, and full-blown applications!

SYNOPSIS

use Mojo::Snoo;

# OAuth ONLY. Reddit is deprecating cookie auth soon.
my $snoo = Mojo::Snoo->new(
    username      => 'foobar',
    password      => 'very_secret',
    client_id     => 'oauth_client_id',
    client_secret => 'very_secret_oauth',
);

# upvote first 10 posts from /r/perl after a specific post ID
$snoo->subreddit('perl')->links(
    10 => {after => 't3_39ziem'} => sub {
        say shift->code;    # callback receives Mojo::Message::Response
    }
)->each(sub { $_->upvote });

# print names of moderators from /r/Perl
# Warning: mods() is subject to change!
Mojo::Snoo->new->subreddit('Perl')->mods->each( sub { say $_->name } );

# Print moderators via Mojo::Snoo::Subreddit
Mojo::Snoo::Subreddit->new('Perl')->mods->each( sub { say $_->name } );

# print title and author of the newest "self" posts from /r/perl
Mojo::Snoo::Subreddit->new('Perl')->links_new(50)->grep(sub { $_->is_self })
  ->each(sub { say $_->title, ' posted by ', $_->author });

# get the top 3 controversial links on /r/AskReddit
@links = Mojo::Snoo::Subreddit->new('Perl')->links_contro_all(3);

# print past week's top video URLs from /r/videos
Mojo::Snoo::Subreddit->new('Perl')->links_top_week->each( sub { say $_->url } );

# print the /r/Perl subreddit description
say Mojo::Snoo->new->subreddit('Perl')->about->description;

# even fetch a subreddit's header image!
say Mojo::Snoo->new->subreddit('Perl')->about->header_img;

METHODS

multireddit

Returns a Mojo::Snoo::Multireddit object.

subreddit

Returns a Mojo::Snoo::Subreddit object.

link

Returns a Mojo::Snoo::Link object.

comment

Returns a Mojo::Snoo::Comment object.

user

Returns a Mojo::Snoo::User object.

WHY SNOO?

Snoo is reddit's alien mascot. Not to be confused with snu-snu.

Reddit's licensing changes prohibit the word "reddit" from being used in the name of reddit API clients.

API DOCUMENTATION

Please see the official Reddit API documentation for more details regarding the usage of endpoints. For a better idea of how OAuth works, see the Quick Start and the full documentation. There is also a lot of useful information of the redditdev subreddit.

LICENSE

The (two-clause) FreeBSD License. See LICENSE for details.

aggrolite / Mojo-Snoo