README.md
1# NAME
2
3Amon2::DBI - Simple DBI wrapper
4
5# SYNOPSIS
6
7 use Amon2::DBI;
8
9 my $dbh = Amon2::DBI->connect(...);
10
11# DESCRIPTION
12
13Amon2::DBI is a simple DBI wrapper. It provides better usability for you.
14
15# FEATURES
16
17- Set AutoInactiveDestroy to true.
18
19 If your DBI version is higher than 1.614, Amon2::DBI set AutoInactiveDestroy as true.
20
21- Set sqlite\_unicode and mysql\_enable\_utf8 and pg\_enable\_utf8 automatically
22
23 Amon2::DBI set sqlite\_unicode and mysql\_enable\_utf8 automatically.
24 If using DBD::Pg version less than 2.99, pg\_enable\_utf8 too.
25
26- Nested transaction management.
27
28 Amon2::DBI supports nested transaction management based on RAII like DBIx::Class or DBIx::Skinny. It uses [DBIx::TransactionManager](https://metacpan.org/pod/DBIx::TransactionManager) internally.
29
30- Raising error when you occurred.
31
32 Amon2::DBI raises exception if your $dbh occurred exception.
33
34# ADDITIONAL METHODS
35
36Amon2::DBI is-a DBI. And Amon2::DBI provides some additional methods.
37
38- `$dbh->do_i(@args);`
39
40 Amon2::DBI uses [SQL::Interp](https://metacpan.org/pod/SQL::Interp) as a SQL generator. Amon2::DBI generate SQL using @args and do it.
41
42- `$dbh->insert($table, \%row);`
43
44 It's equivalent to following statement:
45
46 $dbh->do_i(qq{INSERT INTO $table }, \%row);
47
48# AUTHOR
49
50Tokuhiro Matsuno <tokuhirom AAJKLFJEF@ GMAIL COM>
51
52# SEE ALSO
53
54# LICENSE
55
56Copyright (C) Tokuhiro Matsuno
57
58This library is free software; you can redistribute it and/or modify
59it under the same terms as Perl itself.
60