NAME

POE::Component::Metabase::Client::Submit - a POE client that submits to Metabase servers

VERSION

version 0.14

SYNOPSIS

  use strict;
  use warnings;
  use POE qw[Component::Metabase::Client::Submit];

  POE::Session->create(
    package_states => [
      'main' => [qw(_start _status)],
    ],
  );

  sub _start {
    POE::Component::Metabase::Client::Submit->submit(
      event   => '_status',
      uri     => 'https://foo.bar.com/metabase/',
      fact    => $metabase_fact_object,
      profile => $metabase_user_profile_object,
      secret  => $metabase_user_secret_object,
    );
    return;
  }

  sub _status {
    my $data = $_[ARG0];

    print "Success!\n" if $data->{success};

    print $data->{error}, "\n" if $data->{error};

    return;
  }

DESCRIPTION

POE::Component::Metabase::Client::Submit provides a POE mechanism for submitting facts to a Metabase web server.

CONSTRUCTOR

submit

  POE::Component::Metabase::Client::Submit->spawn( %args );

Constructs a POE session that will manage submitting a Metabase fact to a Metabase web server.

Takes a number of mandatory arguments:

 'profile', a Metabase::User::Profile object
 'secret', a Metabase::User::Secret object
 'fact', a Metabase::Fact object
 'event', an event handler in the calling session to invoke on completion
 'uri', the uri of a Metabase server to submit to.

And some optional arguments:

 'session', a session alias, reference or ID to send 'event' to instead of the calling session
 'http_alias', the alias or ID of an existing POE::Component::Client::HTTP session to use.
 'context', anything that can be stored in a scalar that is meaningful to you.
 'resolver', a reference to a POE::Component::Resolver object to use (ignored if http_alias is used).
 'compress', a compressor to use - defaults to none ( available compressors: gzip, deflate, x-bzip2, none )

OUTPUT EVENT

An event will be sent to either the calling session or the session specified with session during submit.

ARG0 of the event will be a hashref with the following keys:

success

Indicates that the submission was successful.

error

If there was an error this will contain a string indicating the error that occurred.

context

If you specified context in submit, whatever you passed will be here.

<content>

This will contain the content of any HTTP responses whether success or failure.

SEE ALSO

Metabase

POE

AUTHORS

• Chris Williams <chris@bingosnet.co.uk>

• Ricardo SIGNES

• David A. Golden

COPYRIGHT AND LICENSE

This software is copyright (c) 2017 by Chris Williams.

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