NAME
    MooseX::Role::DBIx::Connector - give your Moose class DBIx::Connector
    powers

SYNOPSIS
      package MyClass;
      use Moose;
      with 'MooseX::Role::DBIx::Connector';

      package main;

      my $c = MyClass->new(
          db_dsn  => 'dbi:Pg:dbname=foo;host=bar',
          db_user => 'mikey',
          db_password => 'seekrit',
          db_attrs => { Foo => 'Bar' },
         );

      $c->db_conn->dbh->selectall_arrayref( ... );

      $c->db_conn->txn( fixup => sub { ... } );


      ### more advanced usage

      package BigClass;
      use Moose;
      with 'MooseX::Role::DBIx::Connector' => { connection_name => 'itchy'    };
      with 'MooseX::Role::DBIx::Connector' => { connection_name => 'scratchy' };

      package main;

      my $c = BigClass->new(
          itchy_dsn  => 'dbi:Pg:dbname=foo;host=bar',
          itchy_user => 'mikey',
          itchy_password => 'seekrit',

          scratchy_dsn   => 'dbi:SQLite:dbname=somefile',
         );

      $c->itchy_conn->dbh->selectall_arrayref( ... );
      $c->scratchy_conn->txn( fixup => sub { ... } );

DESCRIPTION
    Generic parameterized Moose role to give your class accessors to manage
    one or more DBIx::Connector connections.

ROLE PARAMETERS
connection_name
    Name for this connection, which is the prefix for all the generated
    accessors. Default 'db', which means that you get the accessors
    "db_dsn", "db_user", "db_password", "db_attrs", and "db_conn".

connection_description
    Plaintext description of this connection. Only used in generating
    "documentation" for each of the generated accessors.

accessor_options
    Hashref of additional options to pass to the generated accessors, e.g.

      package MyClass;
      use Moose;
      with 'MooseX::Role::DBIx::Connector' => {
        connection_name  => 'itchy',
        accessor_options => { 'itchy_dsn'  => [ traits => ['GetOpt'], ],
                              'itchy_user' => [ default => 'minnie_the_moocher' ],
                            }
      };

ATTRIBUTES
  (connection_name)_conn
    Get a DBIx::Connector connection object for the given connection info.

  (connection_name)_dsn
    DBI DSN for your connection. Required.

  (connection_name)_user
    Username for the connection.

  (connection_name)_password
    Password for the connection.

  (connection_name)_attrs
    Hashref of DBI attributes for the connection. Passed to DBIx::Connector,
    which passes them to DBI's connect()

AUTHOR
    Robert Buels, <rmb32@cornell.edu>