Config::Model::Tester::Setup(3pm)

NAME
Config::Model::Tester::Setup - Common test setup functions for Config::Model

VERSION
version 4.010

SYNOPSIS
 # in t/some_test.t
 use warnings;
 use strict;

 use Config::Model::Tester::Setup qw/init_test setup_test_dir/;

 my ($model, $trace) = init_test();

 # pseudo root where config files are written by config-model as setup
 # by init_test
 my $wr_root = setup_test_dir();

DESCRIPTION
This module provide 2 functions to setup a test environment that can be used in most test involving Config::Model.

FUNCTIONS

  init_test
Scan test command line options and initialise a Config::Model object.

Returns a list containing a Config::Model object, a boolean and a hash. The boolean is true if option "--trace" was used on the command line.

Default command options are:

•   "--error": When set, error handled by Config::Model::Exception shows a strack trace when dying.

•   "--log": When set, Log::Log4perl uses the config from file "~/.log4config-model" or the default config provided by Config::Model. By default, only Error level and above are shown. Note that log tests are disabled when this option is set, so you may see a lot of harmless Warning messages during tests (which depend on the tests to be run). Experimental.

•   "--trace": the value of this option is given back to the caller of "init_test". Usually, this value is used to show more information regarding the tests being run.

More options can be passed to "init_test" using option definitions like the one defined in Getopt::Long . The value of the command line options are returned in the 3rd returned value.

For instance, for a test named "t/my_test.t" calling :

  init_test('foo', 'bar=s')

The test file can be run with:

  perl t/my_test.t --foo --bar=baz --log --trace

"init_test" returns:

  ($model, 1, { foo => 1, bar => 'baz', log => 1 , trace => 1, error => 0 })

  setup_test_dir
Cleanup and create a test directory in "wr_root/test-script-name". For instance this function creates directory "wr_root/foo" for test "t/foo.t"

Returns a Path::Tiny object of the test directory.

SEE ALSO

•   Config::Model

•   Test::More

AUTHOR
Dominique Dumont

COPYRIGHT AND LICENSE
This software is Copyright (c) 2013-2020, 2026 by Dominique Dumont.

This is free software, licensed under:

  The GNU Lesser General Public License, Version 2.1, February 1999