NAME

AI::CleverbotIO - A Perl wrapper for the cleverbot.io API

VERSION

This document describes AI::CleverbotIO version 0.002.

SYNOPSIS

   use AI::CleverbotIO;

   my $cleverbot = AI::CleverbotIO->new(
      key => $ENV{CLEVERBOT_API_KEY},
      nick => $ENV{CLEVERBOT_NICK},
      user => $ENV{CLEVERBOT_API_USER},
   );

   # call to create() is mostly safe, you might get an error
   # back but still 200 OK. You can avoid this (and wasting one
   # API call) if you know the nick is already active for these
   # API credentials.
   $cleverbot->create();

   # then, it's just... ask()
   my $answer = $cleverbot->ask('Hello darling!');
   say $answer->{response};

DESCRIPTION

This module allows you to interact with the API served by https://cleverbot.io.

ACCESSORS

key

   my $api_key = $obj->key;

Read-only accessor to the API key. MUST be provided upon instantiation.

endpoints

   my $endpoints_hashref = $obj->endpoints;

Read-only accessor to a hash reference whose keys are the strings ask and create and the corresponding values are the API endoints (URIs). The default is:

   {
      ask    => 'https://cleverbot.io/1.0/ask',
      create => 'https://cleverbot.io/1.0/create',
   }

logger

   my $logger = $obj->logger;

Read-only accessor to the logger object (Log::Any compatible). See "BUILD_logger" for the default value.

nick

   $obj->nick($some_string);
   my $nick = $obj->nick;

Read-write accessor to the nick for invoking API calls. If not set, it is set after a call to "create". See also "has_nick".

ua

   my $ua = $obj->ua;

Read-only accessor to the user agent object (HTTP::Tiny compatible). See BUILD_ua for the default value.

user

   my $api_user = $obj->user;

Read-only accessor to the API user. MUST be provided upon instantiation.

METHODS

BUILD_logger

Called automatically if "logger" is not set. By default, it returns whatever "get_logger" in Log::Any provides, but you can easily override this in a derived class.

BUILD_ua

Called automatically if "ua" is not set. By default, it returns a plain new instance of HTTP::Tiny, without options.

ask

   my $answer = $obj->ask($some_text);

Send a ask API request. The returned $answer is a hash reference derived by the JSON decoding of the response body, e.g.:

   {
      status   => 'success',
      response => 'Hullo'
   }

create

   my $answer = $obj->create();
   my $other  = $obj->create($other_nick);

Send a create API request. The returned $answer is a hash reference derived by the JSON decoding of the response body, e.g.:

   {
      status => 'success',
      nick   => 'NickTheRobot',
   }

If the current "nick" has already been used for creation, the API call will fail partially in that status 200 will be returned, but the status field in the answer will contain an error about the fact that the nick already exists (Error: reference name already exists). You can safely ignore this error.

You can optionally pass a different other_nick. This will be set as "nick" and used for creation (this will overwrite whatever "nick" contains though).

has_nick

   say $obj->nick if $obj->has_nick;
   say 'no nick yet' unless $obj->has_nick;

Predicate to check whether a "nick" is already set or not.

BUGS AND LIMITATIONS

Report bugs either through RT or GitHub (patches welcome).

SEE ALSO

https://cleverbot.io.

AUTHOR

Flavio Poletti <polettix@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2017 by Flavio Poletti <polettix@cpan.org>

This module is free software. You can redistribute it and/or modify it under the terms of the Artistic License 2.0.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

cpanm AI::CleverbotIO

perl -MCPAN -e shell
install AI::CleverbotIO