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.