/ 
Test-Consul-0.003
River stage one • 4 direct dependents • 4 total dependents
/ Test::Consul

NAME

Test::Consul - Run a Consul server for testing

SYNOPSIS

use Test::Consul;

# succeeds or dies
my $tc = Test::Consul->start;

my $consul_baseurl = "http://127.0.0.1:".$tc->port;

# do things with Consul here

# kill test server (or let $tc fall out of scope, destructor will clean up)
$tc->end;

DESCRIPTION

This module starts and stops a standalone Consul instance. It's designed to be used to help test Consul-aware Perl programs.

It's assumed that you have Consul 0.6.3 installed somewhere.

METHODS

start

my $tc = Test::Consul->start;

Starts a Consul instance. This method can take a moment to run, because it waits until Consul's HTTP endpoint is available before returning. If it fails for any reason an exception is thrown. In this way you can be sure that Consul is ready for service if this method returns successfully.

The returned object is a guard. end is called when it goes out of scope, so if you don't store it your Consul server will be killed before it even gets started.

start takes the following arguments:

  • port

    Port for the HTTP service. If not provided, a port between 28500 and 28599 (inclusive) is chosen at random.

  • datadir

    Directory for Consul's datastore. If not provided, defaults to /tmp/perl-test-consul.

  • bin

    Location of the consul binary. If not provided, $PATH will be searched for it.

end

Kill the Consul instance. Graceful shutdown is attempted first, and if it doesn't die within a couple of seconds, the process is killed.

This method is also called if the guard object returned by start falls out of scope.

running

Returns a true value if the Consul instance is running, false otherwise.

port

Returns the port that the Consul's HTTP server is listening on.

bin

Returns the path to the consul binary that was used to start the instance.

datadir

Returns the path to the data dir.

SEE ALSO

SUPPORT

Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at https://github.com/robn/Consul-Test/issues. You will be notified automatically of any progress on your issue.

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

https://github.com/robn/Consul-Test

git clone https://github.com/robn/Consul-Test.git

AUTHORS

  • Robert Norris <rob@eatenbyagrue.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Robert Norris.

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