# NAME

Test::WWW::Mechanize::Dancer - Wrapper to easily use Test::WWW::Mechanize with your Dancer apps

# VERSION

version 0.003

# SYNOPSIS

   use MyDancerApp;
   use Test::WWW::Mechanize::Dancer;

   # Get your standard Test::WWW::Mechanize object
   my $mech = Test::WWW::Mechanize::Dancer->new(
       # settings here if required
   )->mech;
   # Run standard Test::WWW::Mechanize tests
   $mech->get_ok('/');

# DESCRIPTION

This is a simple wrapper that lets you test your Dancer apps using
Test::WWW::Mechanize.

# SETTINGS

## appdir

Probably the main thing you will want to set, `appdir` sets the base
directory for the app.  `confdir`, `views`, and `public`, will be
set to `appdir`, `appdir`/views, and `appdir`/public
respectively if not set explicitly.

The `appdir` defaults to the current working directory, which works
in most testing cases.

## agent

Allows you to set the user agent of the Mechanizer.

## confdir

Set the dancer confdir.  Will default to appdir if unspecified.

## envdir

Allows you to set the directory where Dancer should look for the config files
for each environment.  Defaults to 'environments' under appdir.  Note if your
app uses $ENV{DANCER_ENVDIR} you should explicitly pass that value using this
option.

## environment

Allows you to set the Dancer environment to run your app in.  Defaults to
'test'

## mech_class

Allows you to override the class used to instantiate the user agent object.
Use this to invoke your own class with project-specific test-helper methods.
Defaults to 'Test::WWW::Mechanize::PSGI' - which your class should inherit
from.  Note, it is your responsibility to 'require' the class.

## public

Set the public directory for your dancer app.  Defaults to `appdir`/public

## views

Set the views directory for your dancer app.  Defaults to `appdir`/views

# AUTHORS

- William Wolf <[email protected]>
- Grant McLean <[email protected]>

# COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by William Wolf.

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