=head1 NAME

DBIx::Class::Migration::Script::Help::populate - Install fixtures to a database

=head1 SYNOPSIS

    dbic-migration populate --fixture_set core --fixture_set countries

=head1 DESCRIPTION

Installs a prepared migration to  either the current schema version or the target
version specified via L</to_version> to the database connected via the L</dsn>,
L</username> and L</password> (or to a developer level sandbox as defined by the
L</sandbox_type>).

You can't install to a database if the tables already exist.  See C<drop_tables>.

=head1 OPTIONS

This command accepts the following options.  You may learn more about each
option by typing C<dbic-migration help OPTION>.  The following is a summary.

=head1 fixture_sets (fixture_sets)

Required.  The fixture configuration set names (basically these are the file
names of your fixture configurations, without the '.json' part.

=head2 includes (I,lib,libs,include)

Optional.

Adds the listed paths to @INC.  Handy during development when you want to use
a development schema class.


=head2 schema_class (S)

Accepts Str. Required.

This is the schema we use as the basis for creating, managing and running your
deployments.  This should be the full package namespace defining your subclass
of L<DBIx::Class::Schema>.  For example C<MyApp::Schema>.

If the L</schema_class> cannot be loaded, a hard exception will be thrown.

=head2 target_dir (D)

Optional.

When using a C<sandbox_class> for generating developer level database sandboxes,
you may wish to place the sandbox in a directory other than the default (which
is under the C<share> directory off the project root).

=head2 sandbox_class

Aliases: T, sb

Accepts: String (default: SqliteSandbox)

The class we use to create a developer level database sandbox.

You can change this to either 'PostgresqlSandbox' or 'MySQLSandbox', which will
create a sandbox using either L<DBIx::Class::Migration::MySQLSandbox> or 
L<DBIx::Class::Migration::PostgresqlSandbox>.

=head2 user

Aliases: U

=head2 password

Aliases: P

=head2 dsn

Connection information to an already created and running instance of a database.
If you don't specify this, we will assume you want a developer level sandbox (
See L</sandbox>).

=head2 dbic_fixture_class

Accepts: String to a Perl Class.  Defaults to L<DBIx::Class::Fixtures>

Lets you specify a fixture class.

=head2 dbic_fixtures_extra_args

Accepts: HashRef.  Optional

Allows you to pass custom arguments to L<DBIx::Class::Fixtures>.

=head1 SEE ALSO

L<DBIx::Class::Migration>, L<DBIx::Class::Migration::Script>,
L<DBIx::Class::Migration::Features>, L<DBIx::Class::Migration::Tutorial>

=head1 AUTHOR

See L<DBIx::Class::Migration> for author information

=head1 COPYRIGHT & LICENSE

See L<DBIx::Class::Migration> for copyright and license information

=cut

