=head1 NAME

Handel::Manual::Requirements - What you need to install to use Handel.

=head1 DESCRIPTION

This page lists the known requirements recommended software needed to use Handel.

=head1 REQUIREMENTS

=head2 Prerequisites

The following modules are required for Handel to work properly. Older versions may work fine, but these
are the versions I have installed and verified to work correctly. If you have older versions and all tests pass,
send me an email and I'll lower the version requirements.

=head3 DBIx::Class

Version 0.08 or greater.

=head3 DBIx::Class::UUIDColumns

Version 0.01 or greater.

=head3 DBIx::Class::Validation

Version 0.01 or greater.

=head3 Class::Accessor::Grouped

Version 0.02 or greater.

=head3 Class::ISA

Version 0.32 or greater.

=head3 Class::Inspector

Version 0.16 or greater.

=head3 Clone

Version 0.20 or greater.

=head3 Data::Currency

Version 0.03 or greater.

=head3 Error

Version 0.14 or greater.

=head3 Locale::Maketext

Version 1.06 or greater.

=head3 Module::Pluggable

Version 2.95 or greater.

=head3 Module::Starter

Version 1.42 or greater.

This is only used for the quick start module creation. IF you don't plan on using that, you can ignore this
requirement.

=head3 Scalar::Util

Version 0.13 or greater with weaken support.

=head3 Tie::Hash

Version 1.01 or greater.

=head3 DateTime

Version 0.31 or greater.

=head3 DateTime::Format::MySQL

Version 0.04 or greater.

This is used in the bulk of core module tests with SQLite. IF you are using another database like Postgres,
you should install the appropriate module for that database.

=head3 NEXT

This is only used in Handel::Compat.

=head3 SQL::Translator

Version 0.08 or greater. This is used by DBIC and the quick start code to install the schema to a db. You can
ignore this requirement if you are not going to use the quick start.

=head3 Locale::Currency::Format

Version 1.22 or greater.

This module allows all prices to be formatted to specific currency codes and formats.

=head3 Finance::Currency::Convert::WebserviceX

Version 0.03 or greater.

This module allows all prices to be converted from one currency to another.

=head3 Locale::Currency

Version 2.07 or greater.

This module allows all conversion and currency codes to be verified as real 3 letter ISO
currency codes.

=head3 Getopt::Long

This is included in perl 5.8. It is used by the quick start code.

=head3 Pod::Usage

This is included in perl 5.8. It is used by the quick start code.

=head3 FormValidator::Simple

Version 0.17 or greater.

This module is only required if you plan on using the generated scaffolding code from the supplied Catalyst
Controller/Model Helpers.

=head2 Optional Modules

The following modules are not required for Handel to run, although some features may be unavailable
without them.

=head3 AxKit

Version 1.61 or greater.

AxKit is only required if you plan on using Handel within XSP pages using the supplied taglibs.

=head3 Template Toolkit

Version 2.07 or greater.

Template ToolKit is only required if you plan on using Handel within TT2 based websites using the supplied
TT plugins.

=head3 Catalyst::Runtime

Version 5.7007 or greater.

Catalyst is only required if you plan on using the supplied Catalyst Cart/Order models withing a Catalyst app.

=head3 Catalyst::Devel

Version 1.0 or greater.

Catalyst::Devel is only required if you plan on using the supplied Catalyst Helpers to generate scaffolding or
started code.

=head3 HTML::FiillInForm

Version 1.05 or greater.

This module is only required if you plan on using the generated scaffolding code from the supplied Catalyst
Controller/Mode Helpers.

=head3 YAML

Version 0.58 or greater.

This module is only required if you plan on using the generated scaffolding code from the supplied Catalyst
Controller/Mode Helpers.

=head2 Test Modules

The following modules are only required for the test suite when running
C<make test>.

=head3 Apache::Test

Version 1.27 or greater.

Apache::Test is used to test the AxKit XSP taglib modules.

=head3 Test::More

Version 0.61 or greater.

Earlier Test::More modules may have an issue with running the number of tests in this dist with 
'command line too long' type errors.

=head3 Pod::Coverage

Version 0.14 or greater.

The pod coverage tests may fail complaining about missing pod for methods if
Pod::Coverage < 0.14 is installed. This is due to certain syntax variations of
the pod with escaped gt/lt. I may just alter the pod and bump this version down
if there is enough feedback to do so.

=head3 Test::Pod

Version 1.00 or greater.

Test::Pod 1.00 added the C<all_pod_files_ok()> method which makes my life
easier. :-)

=head3 Test::Pod::Coverage

Version 1.04 or greater.

Test::Pod::Coverage 1.04 was made taint safe, and we run the tests with -wT
like good girls and boys.

=head3 Test::Strict

Version 0.01 or greater.

This keeps me honest and makes sure I always C<use strict>.

=head3 Test::Spelling

Version 0.10 or greater.

I can't type, or spell. This keeps the pod somewhat readable.

=head3 Test::NoTabs

Version 0.01 or greater.

Tabs are bad, m'kay? This keeps me honest.

=head3 Test::Perl::Critic

Version 0.08 or greater.

Yet another test to keep my code somewhat honest.

=head1 AUTHOR

    Christopher H. Laco
    CPAN ID: CLACO
    claco@chrislaco.com
    http://today.icantfocus.com/blog/
