NAME

ElasticSearch::TestServer - Start an ElasticSearh cluster for testing

SYNOPSIS

  use ElasticSearch::TestServer;

  $ENV{ES_HOME} = '/path/to/elasticsearch';
  $ENV{ES_TRANSPORT} = 'http';

  my $es = connect_to_es();

OR

  my $es = connect_to_es(
      home        => '/path/to/elasticsearch',
      instances   => 3,
      transport   => 'http',
      ip          => '127.0.0.1',
      trace_calls => 'logfile',
      config      => { values to override}
  );

DESCRIPTION

ElasticSearch::TestServer is a utility module which will start an ElasticSearch cluster intended for testing, and shut the cluster down at the end, even if your code exits abnormally.

By default, it uses http transport, the local gateway, and starts 3 instances on localhost.

connect_to_es returns an ElasticSearch instance.

AUTHOR

Clinton Gormley, <clinton@traveljury.com>

COPYRIGHT AND LICENSE

Copyright (C) 2011 by Clinton Gormley

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.7 or, at your option, any later version of Perl 5 you may have available.