NAME
    Mojolicious::Plugin::Web::Auth::Site::Reddit - Reddit OAuth Plugin for
    Mojolicious::Plugin::Web::Auth

VERSION
    version 0.000002

SYNOPSIS
        use URI::FromHash qw( uri );
        my $key = 'foo';
        my $secret = 'seekrit';

        my $access_token_url = uri(
            scheme   => 'https',
            username => $key,
            password => $secret,
            host     => 'api.fitbit.com',
            path     => 'oauth2/token',
        );

        my $scope = 'identity,edit,flair,history,modconfig,modflair,modlog,modposts,modwiki,mysubreddits,privatemessages,read,report,save,submit,subscribe,vote,wikiedit,wikiread';

        # Mojolicious
        $self->plugin(
            'Web::Auth',
            module           => 'Reddit',
            access_token_url => $access_token_url,
            authorize_url =>
                'https://www.reddit.com/api/v1/authorize?duration=permanent',
            key         => 'Reddit consumer key',
            secret      => 'Reddit consumer secret',
            scope       => $scope,
            on_finished => sub {
                my ( $c, $access_token, $access_secret ) = @_;
                ...;
            },
        );

        # Mojolicious::Lite
        plugin 'Web::Auth',
            module      => 'Reddit',
            access_token_url => $access_token_url,
            authorize_url =>
                'https://www.reddit.com/api/v1/authorize?duration=permanent',
            key         => 'Reddit consumer key',
            secret      => 'Reddit consumer secret',
            scope       => $scope,
            on_finished => sub {
                my ( $c, $access_token, $access_secret ) = @_;
                ...
            };

        # default authentication endpoint: /auth/reddit/authenticate
        # default callback endpoint: /auth/reddit/callback

DESCRIPTION
    This module adds Reddit <https://www.reddit.com/dev/api/> support to
    Mojolicious::Plugin::Web::Auth.

    The default "authorize_url" allows only for temporary tokens. If you
    require a refresh token, set your own "authorize_url" as in the example
    in the SYNOPSIS.

AUTHOR
    Olaf Alders <olaf@wundercounter.com>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2017 by Olaf Alders.

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