ydbi 0.5.0 → 0.5.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/ChangeLog +4 -0
- data/build/Rakefile.dbi.rb +4 -4
- data/lib/dbi/version.rb +1 -1
- data/test/dbi/tc_dbi.rb +1 -1
- metadata +9 -124
- data/.gitignore +0 -6
- data/Gemfile +0 -4
- data/Rakefile +0 -8
- data/TODO +0 -44
- data/bench/bench.rb +0 -79
- data/build/rake_task_lib.rb +0 -187
- data/doc/DBD_SPEC.rdoc +0 -88
- data/doc/DBI_SPEC.rdoc +0 -157
- data/doc/homepage/contact.html +0 -62
- data/doc/homepage/development.html +0 -124
- data/doc/homepage/index.html +0 -83
- data/doc/homepage/ruby-dbi.css +0 -91
- data/lib/dbd/Mysql.rb +0 -137
- data/lib/dbd/ODBC.rb +0 -89
- data/lib/dbd/Pg.rb +0 -188
- data/lib/dbd/SQLite.rb +0 -97
- data/lib/dbd/SQLite3.rb +0 -124
- data/lib/dbd/mysql/database.rb +0 -405
- data/lib/dbd/mysql/driver.rb +0 -125
- data/lib/dbd/mysql/statement.rb +0 -188
- data/lib/dbd/odbc/database.rb +0 -128
- data/lib/dbd/odbc/driver.rb +0 -38
- data/lib/dbd/odbc/statement.rb +0 -137
- data/lib/dbd/pg/database.rb +0 -516
- data/lib/dbd/pg/exec.rb +0 -47
- data/lib/dbd/pg/statement.rb +0 -160
- data/lib/dbd/pg/tuples.rb +0 -121
- data/lib/dbd/pg/type.rb +0 -209
- data/lib/dbd/sqlite/database.rb +0 -151
- data/lib/dbd/sqlite/statement.rb +0 -125
- data/lib/dbd/sqlite3/database.rb +0 -201
- data/lib/dbd/sqlite3/statement.rb +0 -78
- data/prototypes/types2.rb +0 -237
- data/setup.rb +0 -1585
- data/test/DBD_TESTS +0 -50
- data/test/TESTING +0 -16
- data/test/dbd/general/test_database.rb +0 -206
- data/test/dbd/general/test_statement.rb +0 -326
- data/test/dbd/general/test_types.rb +0 -296
- data/test/dbd/mysql/base.rb +0 -26
- data/test/dbd/mysql/down.sql +0 -19
- data/test/dbd/mysql/test_blob.rb +0 -18
- data/test/dbd/mysql/test_new_methods.rb +0 -7
- data/test/dbd/mysql/test_patches.rb +0 -111
- data/test/dbd/mysql/up.sql +0 -28
- data/test/dbd/odbc/base.rb +0 -30
- data/test/dbd/odbc/down.sql +0 -19
- data/test/dbd/odbc/test_new_methods.rb +0 -12
- data/test/dbd/odbc/test_ping.rb +0 -10
- data/test/dbd/odbc/test_statement.rb +0 -44
- data/test/dbd/odbc/test_transactions.rb +0 -58
- data/test/dbd/odbc/up.sql +0 -33
- data/test/dbd/postgresql/base.rb +0 -31
- data/test/dbd/postgresql/down.sql +0 -31
- data/test/dbd/postgresql/test_arrays.rb +0 -179
- data/test/dbd/postgresql/test_async.rb +0 -121
- data/test/dbd/postgresql/test_blob.rb +0 -36
- data/test/dbd/postgresql/test_bytea.rb +0 -87
- data/test/dbd/postgresql/test_ping.rb +0 -10
- data/test/dbd/postgresql/test_timestamp.rb +0 -77
- data/test/dbd/postgresql/test_transactions.rb +0 -58
- data/test/dbd/postgresql/testdbipg.rb +0 -307
- data/test/dbd/postgresql/up.sql +0 -60
- data/test/dbd/sqlite/base.rb +0 -32
- data/test/dbd/sqlite/test_database.rb +0 -30
- data/test/dbd/sqlite/test_driver.rb +0 -68
- data/test/dbd/sqlite/test_statement.rb +0 -112
- data/test/dbd/sqlite/up.sql +0 -25
- data/test/dbd/sqlite3/base.rb +0 -32
- data/test/dbd/sqlite3/test_database.rb +0 -77
- data/test/dbd/sqlite3/test_driver.rb +0 -67
- data/test/dbd/sqlite3/test_statement.rb +0 -88
- data/test/dbd/sqlite3/up.sql +0 -33
- data/test/ts_dbd.rb +0 -131
- data/ydbi.gemspec +0 -24
data/doc/DBI_SPEC.rdoc
DELETED
@@ -1,157 +0,0 @@
|
|
1
|
-
= DBI Interface Spec, for version 0.4.0
|
2
|
-
|
3
|
-
by Erik Hollensbe <erik@hollensbe.org>
|
4
|
-
|
5
|
-
== Foreword
|
6
|
-
|
7
|
-
DBI is still in a large state of flux. Previous versions of this
|
8
|
-
specification rarely reflected reality, and the 0.4.0 release is an
|
9
|
-
attempt to get the code and documentation more in sync.
|
10
|
-
|
11
|
-
While this is the goal, there is still a lot of
|
12
|
-
code to check, sanitize, and otherwise clean up. If you find something
|
13
|
-
missing in these specifications while working on a new DBD or a patch
|
14
|
-
for DBI, please bring it to our attention (in IRC or on the mailing list)
|
15
|
-
to get the spec revised. Doing this will save
|
16
|
-
yourself (and the DBI authors) a lot of time.
|
17
|
-
|
18
|
-
== Design
|
19
|
-
|
20
|
-
With DBI, there are the concepts of driver, database, and statement. The core
|
21
|
-
functionality for these concepts is provided by a database driver, or
|
22
|
-
DBD. DBI controls one or more drivers at once, a driver has databases, a
|
23
|
-
database may have statements.
|
24
|
-
|
25
|
-
DBI uses a delegation model to communicate with its DBDs through a
|
26
|
-
series of handles. When a connection to a database is requested, DBI contacts
|
27
|
-
the appropriate DBD and builds a handle in
|
28
|
-
its name that it aligns with a DBI base class for that concept. The
|
29
|
-
handle provided by the DBD is the first-class method of communication,
|
30
|
-
otherwise it resorts to calling the base class methods. This allows
|
31
|
-
DBI to provide a level of consistency unless the DBD author finds it
|
32
|
-
otherwise unnecessary.
|
33
|
-
|
34
|
-
For example: DBI will provide handy methods like fetch_all and
|
35
|
-
fetch_scroll which all leverage the fetch method in the base class,
|
36
|
-
and the fetch method must be implemented by the DBD. However, the DBD
|
37
|
-
may have an internal representation of fetch_scroll (as is the case
|
38
|
-
with the ODBC driver) that may be more suited to direct use, and
|
39
|
-
therefore DBI will never see the base class method. This is similar to
|
40
|
-
inheritance, but there is a distinct disconnect between the handles
|
41
|
-
and the base classes, intentionally so. This way the DBDs have no
|
42
|
-
access to the base class and DBI does all the delegation work. Also,
|
43
|
-
DBI has no idea what the DBD is doing underneath, nor does it need to
|
44
|
-
care as long as valid data is returned.
|
45
|
-
|
46
|
-
== Classes
|
47
|
-
|
48
|
-
These are the classes that make up the core of DBI and provide
|
49
|
-
various functionality:
|
50
|
-
|
51
|
-
=== DBI
|
52
|
-
Core module, responsible for everything underneath it, kickstarting
|
53
|
-
connections and loading drivers.
|
54
|
-
|
55
|
-
=== DBI::Row
|
56
|
-
|
57
|
-
Responsible for representing the result set and managing the type
|
58
|
-
conversion of the result set.
|
59
|
-
|
60
|
-
=== DBI::Utils
|
61
|
-
|
62
|
-
Utility methods which propogate through the rest of DBI.
|
63
|
-
|
64
|
-
=== DBI::SQL
|
65
|
-
|
66
|
-
Utility methods for working with SQL queries. Includes a
|
67
|
-
driver-independent SQL bind manager.
|
68
|
-
|
69
|
-
=== DBI::ColumnInfo
|
70
|
-
|
71
|
-
Responsible for representing the information per column for both
|
72
|
-
queries and table descriptions.
|
73
|
-
|
74
|
-
=== DBI::Type
|
75
|
-
|
76
|
-
Namespace for typecasting classes. These classes are provided with a
|
77
|
-
parse method which converts them to a native Ruby type from a string.
|
78
|
-
|
79
|
-
=== DBI::TypeUtil
|
80
|
-
|
81
|
-
The inverse of DBI::Type, this provides functionality to turn native
|
82
|
-
Ruby types into a representation suitable for the DBD's queries.
|
83
|
-
|
84
|
-
=== DBI::Binary
|
85
|
-
|
86
|
-
The representation of a BLOB/CLOB in a Ruby object. This will
|
87
|
-
eventually be rolled into DBI::Type::, but remains here currently for
|
88
|
-
compatibility purposes.
|
89
|
-
|
90
|
-
=== DBI::Base* and DBI::*Handle
|
91
|
-
|
92
|
-
Please see the Design section above for the description of these modules.
|
93
|
-
|
94
|
-
== Exceptions
|
95
|
-
|
96
|
-
DBI has a slew of custom exceptions it uses to control program flow,
|
97
|
-
and alert the user to specific classes of problems.
|
98
|
-
|
99
|
-
They currently all live in the DBI namespace, although it's expected
|
100
|
-
that there will eventually be an exception namespace.
|
101
|
-
|
102
|
-
=== DBI::Warning < RuntimeError
|
103
|
-
For important warnings such as data truncation, etc.
|
104
|
-
|
105
|
-
=== DBI::Error < RuntimeError
|
106
|
-
Base class of all other error exceptions.
|
107
|
-
Rescue this to rescue all DBI errors.
|
108
|
-
|
109
|
-
=== DBI::InterfaceError < DBI::Error
|
110
|
-
Exception for errors related to the DBI interface rather
|
111
|
-
than the database itself.
|
112
|
-
|
113
|
-
=== DBI::NotImplementedError < DBI::InterfaceError
|
114
|
-
Exception raised if the DBD driver has not specified
|
115
|
-
a mandatory method.
|
116
|
-
|
117
|
-
=== DBI::DatabaseError < DBI::Error
|
118
|
-
Exception for errors related to the database.
|
119
|
-
|
120
|
-
Has three attributes: ((|err|)), ((|errstr|)) and ((|state|)).
|
121
|
-
|
122
|
-
=== DBI::DataError < DBI::DatabaseError
|
123
|
-
Exception for errors due to problems with the processed
|
124
|
-
data, such as division by zero, numeric value out of range, etc.
|
125
|
-
|
126
|
-
=== DBI::OperationalError < DBI::DatabaseError
|
127
|
-
Exception for errors related to the database's operation which
|
128
|
-
are not necessarily under the control of the programmer. This would include
|
129
|
-
such things as unexpected disconnection, failure to find a datasource name,
|
130
|
-
failure to process a transaction, memory allocation errors, etc.
|
131
|
-
|
132
|
-
=== DBI::IntegrityError < DBI::DatabaseError
|
133
|
-
Exception raised when the relational integrity of the database
|
134
|
-
is affected, such as when a foreign key constraint is violated.
|
135
|
-
|
136
|
-
=== DBI::InternalError < DBI::DatabaseError
|
137
|
-
Exception raised when the database encounters an internal error,
|
138
|
-
such as a cursor not being valid anymore, or a transaction going out of
|
139
|
-
sync.
|
140
|
-
|
141
|
-
=== DBI::ProgrammingError < DBI::DatabaseError
|
142
|
-
Exception raised for programming errors, e.g., table not found
|
143
|
-
or already exists, syntax error in SQL statement, wrong number
|
144
|
-
of parameters specified, etc.
|
145
|
-
|
146
|
-
=== DBI::NotSupportedError < DBI::DatabaseError
|
147
|
-
Raised if, e.g., ((<commit>)) is called for a database that does not
|
148
|
-
support transactions.
|
149
|
-
|
150
|
-
== API
|
151
|
-
|
152
|
-
To save my sanity, I have joined the specification and the rdoc for
|
153
|
-
DBI. Please review the specification there.
|
154
|
-
|
155
|
-
If you wish to author your own DBD, please see DBD_SPEC.rdoc,
|
156
|
-
which is a more in-depth view of the communication between DBI and
|
157
|
-
DBDs.
|
data/doc/homepage/contact.html
DELETED
@@ -1,62 +0,0 @@
|
|
1
|
-
<?xml version="1.0" encoding="utf-8"?>
|
2
|
-
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
3
|
-
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US">
|
4
|
-
<head>
|
5
|
-
<meta http-equiv="content-type" content="application/xhtml+xml; charset=utf-8"/>
|
6
|
-
<title>Ruby/DBI - Direct database access layer for Ruby</title>
|
7
|
-
<link rel="stylesheet" type="text/css" href="ruby-dbi.css"/>
|
8
|
-
</head>
|
9
|
-
<body>
|
10
|
-
<div class="body-container">
|
11
|
-
<h1>Ruby/DBI - Contact Information</h1>
|
12
|
-
<div class="main-container">
|
13
|
-
<div class="nav-container">
|
14
|
-
<h1>Links</h1>
|
15
|
-
<a href="index.html">Home</a>
|
16
|
-
<a href="http://rubyforge.org/projects/ruby-dbi">RubyForge Project</a>
|
17
|
-
<a href="http://ruby-dbi.rubyforge.org/rdoc/index.html">RDoc</a>
|
18
|
-
<a href="development.html">Developer Information</a>
|
19
|
-
<a href="http://www.kitebird.com/articles/ruby-dbi.html">Ruby/DBI Tutorial</a>
|
20
|
-
<a href="contact.html">Contact/Reporting Bugs</a>
|
21
|
-
</div>
|
22
|
-
<p>
|
23
|
-
If you'd like to contact us to report a bug or submit a patch,
|
24
|
-
please use the <a
|
25
|
-
href="http://rubyforge.org/tracker/?group_id=234">tracker</a>
|
26
|
-
on RubyForge.
|
27
|
-
</p>
|
28
|
-
|
29
|
-
<p>
|
30
|
-
If you'd like to ask questions about using Ruby/DBI, there is a
|
31
|
-
<a href="http://rubyforge.org/mailman/listinfo/ruby-dbi-users">ruby-dbi-users</a> email list where those questions
|
32
|
-
can be answered. Likewise, <a
|
33
|
-
href="http://rubyforge.org/mailman/listinfo/ruby-dbi-bugs">ruby-dbi-bugs</a>
|
34
|
-
is for discussing bug reports in detail, and <a
|
35
|
-
href="http://rubyforge.org/mailman/listinfo/ruby-dbi-devel-new">ruby-dbi-devel-new</a> is for discussing future
|
36
|
-
development and management of the project.
|
37
|
-
</p>
|
38
|
-
|
39
|
-
<p>
|
40
|
-
If you're an irc user, the <b>#ruby-dbi</b> irc channel on
|
41
|
-
<b>freenode</b> will get you in touch with developers and
|
42
|
-
advanced users.
|
43
|
-
</p>
|
44
|
-
|
45
|
-
<p>
|
46
|
-
If these avenues are not working for you for some reason,
|
47
|
-
please feel free to contact <a
|
48
|
-
href="mailto:erik-at-hollensbe-dot-org">Erik</a>
|
49
|
-
directly. He will be glad to help!
|
50
|
-
</p>
|
51
|
-
</div>
|
52
|
-
<br />
|
53
|
-
<br />
|
54
|
-
<div class="copyright">
|
55
|
-
©2008 Erik Hollensbe, all rights reserved. Please see the
|
56
|
-
README file for the full copyright notice. Please see the
|
57
|
-
LICENSE file in the source package for information on
|
58
|
-
redistributing the source or any of the site content.
|
59
|
-
</div>
|
60
|
-
</div>
|
61
|
-
</body>
|
62
|
-
</html>
|
@@ -1,124 +0,0 @@
|
|
1
|
-
<?xml version="1.0" encoding="utf-8"?>
|
2
|
-
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
3
|
-
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US">
|
4
|
-
<head>
|
5
|
-
<meta http-equiv="content-type" content="application/xhtml+xml; charset=utf-8"/>
|
6
|
-
<title>Ruby/DBI - Direct database access layer for Ruby</title>
|
7
|
-
<link rel="stylesheet" type="text/css" href="ruby-dbi.css"/>
|
8
|
-
</head>
|
9
|
-
<body>
|
10
|
-
<div class="body-container">
|
11
|
-
<h1>Ruby/DBI - Development Information</h1>
|
12
|
-
<div class="main-container">
|
13
|
-
<div class="nav-container">
|
14
|
-
<h1>Links</h1>
|
15
|
-
<a href="index.html">Home</a>
|
16
|
-
<a href="http://rubyforge.org/projects/ruby-dbi">RubyForge Project</a>
|
17
|
-
<a href="http://ruby-dbi.rubyforge.org/rdoc/index.html">RDoc</a>
|
18
|
-
<a href="development.html">Developer Information</a>
|
19
|
-
<a href="http://www.kitebird.com/articles/ruby-dbi.html">Ruby/DBI Tutorial</a>
|
20
|
-
<a href="contact.html">Contact/Reporting Bugs</a>
|
21
|
-
</div>
|
22
|
-
<p>
|
23
|
-
Regarding patches, please consider these issues:
|
24
|
-
<br />
|
25
|
-
<ul>
|
26
|
-
<li>
|
27
|
-
If your patch does not contain tests, it better be
|
28
|
-
very compelling, as someone else will be forced to
|
29
|
-
write them.
|
30
|
-
</li>
|
31
|
-
<li>
|
32
|
-
Please ensure your patch addresses the whole
|
33
|
-
problem space. If it's a patch for DBI, makes sure it
|
34
|
-
works with <b>all</b> DBDs. Likewise, if it is DBD
|
35
|
-
scope, it should handle all versions of the database
|
36
|
-
that DBD supports.
|
37
|
-
</li>
|
38
|
-
<li>
|
39
|
-
Please follow the existing formatting in the
|
40
|
-
files. Check your diffs to see that you aren't
|
41
|
-
generating patches with tons of formatting-only
|
42
|
-
changes.
|
43
|
-
</li>
|
44
|
-
<li>
|
45
|
-
If you plan a series of patches, consider setting
|
46
|
-
up a git repository, or merging your patches before
|
47
|
-
you submit them.
|
48
|
-
</li>
|
49
|
-
</ul>
|
50
|
-
<br />
|
51
|
-
</p>
|
52
|
-
<p>
|
53
|
-
Regarding bug reports, please consider these issues:
|
54
|
-
<br />
|
55
|
-
<ul>
|
56
|
-
<li>
|
57
|
-
Use the tracker if you can. Posting to the lists or
|
58
|
-
a private email is ok, but if it's multipart or
|
59
|
-
significantly complex you may be asked to post it
|
60
|
-
to the tracker anyways.
|
61
|
-
</li>
|
62
|
-
<li>
|
63
|
-
Please search the tracker first, and have a
|
64
|
-
repeatable use case that accurately describes your
|
65
|
-
problem.
|
66
|
-
</li>
|
67
|
-
<li>
|
68
|
-
If you post to the tracker, have a rubyforge
|
69
|
-
account and ensure you're logged in. If you don't,
|
70
|
-
and questions to need to be asked, your bug will
|
71
|
-
likely be quickly round-filed. Our tracker is not
|
72
|
-
your cathartic dumping ground.
|
73
|
-
</li>
|
74
|
-
</ul>
|
75
|
-
<p>
|
76
|
-
If you'd like to contact us to report a bug or submit a patch,
|
77
|
-
please use the <a
|
78
|
-
href="http://rubyforge.org/tracker/?group_id=234">tracker</a>
|
79
|
-
on RubyForge. If you plan long term development, consider
|
80
|
-
setting up a git repository other developers can pull from.
|
81
|
-
</p>
|
82
|
-
|
83
|
-
<p>
|
84
|
-
Please see the <a href="contact.html">contact</a> page
|
85
|
-
about contacting developers or mailing lists.
|
86
|
-
</p>
|
87
|
-
|
88
|
-
<p>
|
89
|
-
We now use 'git' for our revision control system. We now push
|
90
|
-
to several locations:
|
91
|
-
|
92
|
-
<dl>
|
93
|
-
<dt>Rubyforge</dt>
|
94
|
-
<dd>git://rubyforge.org/ruby-dbi.git</dd>
|
95
|
-
<dt>GitHub</dt>
|
96
|
-
<dd>git://github.com/erikh/ruby-dbi.git</dd>
|
97
|
-
<dt>hollensbe.org</dt>
|
98
|
-
<dd>git://hollensbe.org/git/ruby-dbi.git</dd>
|
99
|
-
</dl>
|
100
|
-
<br />
|
101
|
-
|
102
|
-
Forward development occurs in the 'development' branch,
|
103
|
-
which is version-tagged and merged into 'master' at release
|
104
|
-
time. 'master' is used to track release versions and
|
105
|
-
maintenance to those versions.
|
106
|
-
</p>
|
107
|
-
|
108
|
-
<p>
|
109
|
-
Ruby/DBI is a BSD-licensed product. As a result, the
|
110
|
-
licensing on your patches must be the same. Please do
|
111
|
-
not send patches that are of any other license. Thanks!
|
112
|
-
</p>
|
113
|
-
</div>
|
114
|
-
<br />
|
115
|
-
<br />
|
116
|
-
<div class="copyright">
|
117
|
-
©2008 Erik Hollensbe, all rights reserved. Please see the
|
118
|
-
README file for the full copyright notice. Please see the
|
119
|
-
LICENSE file in the source package for information on
|
120
|
-
redistributing the source or any of the site content.
|
121
|
-
</div>
|
122
|
-
</div>
|
123
|
-
</body>
|
124
|
-
</html>
|
data/doc/homepage/index.html
DELETED
@@ -1,83 +0,0 @@
|
|
1
|
-
<?xml version="1.0" encoding="utf-8"?>
|
2
|
-
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
3
|
-
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US">
|
4
|
-
<head>
|
5
|
-
<meta http-equiv="content-type" content="application/xhtml+xml; charset=utf-8"/>
|
6
|
-
<title>Ruby/DBI - Direct database access layer for Ruby</title>
|
7
|
-
<link rel="stylesheet" type="text/css" href="ruby-dbi.css"/>
|
8
|
-
</head>
|
9
|
-
<body>
|
10
|
-
<div class="body-container">
|
11
|
-
<h1>Ruby/DBI - Direct database access layer for Ruby</h1>
|
12
|
-
<div class="main-container">
|
13
|
-
<div class="nav-container">
|
14
|
-
<h1>Links</h1>
|
15
|
-
<a href="index.html">Home</a>
|
16
|
-
<a href="http://rubyforge.org/projects/ruby-dbi">RubyForge Project</a>
|
17
|
-
<a href="http://ruby-dbi.rubyforge.org/rdoc/index.html">RDoc</a>
|
18
|
-
<a href="development.html">Developer Information</a>
|
19
|
-
<a href="http://www.kitebird.com/articles/ruby-dbi.html">Ruby/DBI Tutorial</a>
|
20
|
-
<a href="contact.html">Contact/Reporting Bugs</a>
|
21
|
-
</div>
|
22
|
-
|
23
|
-
<p>
|
24
|
-
Ruby/DBI is a database interface in the spirit of Perl's prolific
|
25
|
-
<a href="http://search.cpan.org/~timb/DBI/DBI.pm">DBI</a> authored
|
26
|
-
by Tim Bunce.
|
27
|
-
</p>
|
28
|
-
|
29
|
-
<p>
|
30
|
-
Ruby/DBI differs in quite a few ways, however. It incorporates
|
31
|
-
many "rubyisms" while maintaining the core DBI interface, and a
|
32
|
-
suite of commonly used DBD's are maintained with the
|
33
|
-
application.
|
34
|
-
</p>
|
35
|
-
|
36
|
-
<p>
|
37
|
-
Ruby/DBI is <i>not</i> an ORM, like <a
|
38
|
-
href="http://ar.rubyonrails.com">ActiveRecord</a> or <a
|
39
|
-
href="http://datamapper.rubyforge.org">DataMapper</a>. It is a
|
40
|
-
lightweight, centralized API to database manipulation. An ORM may
|
41
|
-
or may not be what you want for a given situation, due to weight,
|
42
|
-
ease-of-use or other issues. Our goal with Ruby/DBI is to provide a
|
43
|
-
compelling, lightweight interface that you can use for things where
|
44
|
-
an ORM is too much or too cumbersome.
|
45
|
-
</p>
|
46
|
-
|
47
|
-
<p>
|
48
|
-
Getting started with Ruby/DBI is very easy if you have a working
|
49
|
-
knowledge of SQL and your target database. Read the <a
|
50
|
-
href="http://ruby-dbi.rubyforge.org/rdoc/index.html">Documentation</a>
|
51
|
-
to get on your way!
|
52
|
-
</p>
|
53
|
-
|
54
|
-
<p>
|
55
|
-
The maintainer, Erik Hollensbe, has made a commitment to
|
56
|
-
keeping Ruby/DBI compatible with future Ruby releases. There is
|
57
|
-
also a significant interest in enhancing the suite by further
|
58
|
-
clarifying and enforcing the interface, and further tailoring DBI
|
59
|
-
for the specific needs of Ruby users (as opposed to many of the
|
60
|
-
Perlisms maintained) without impacting the goal of the project.
|
61
|
-
There is also significant effort applied to clarifying the
|
62
|
-
underpinnings, making debugging and development simpler.
|
63
|
-
</p>
|
64
|
-
|
65
|
-
<p>
|
66
|
-
Ruby/DBI is a very old project as far as the ruby community is
|
67
|
-
concerned, tracing back to at least 2001. There are plenty of
|
68
|
-
people who <a
|
69
|
-
href="http://ruby-dbi.rubyforge.org/rdoc/index.html">have
|
70
|
-
contributed</a> to this effort. Big thanks to the original
|
71
|
-
project lead, Michael Neumann, and Francis Hwang and Daniel Berger, who held the
|
72
|
-
project in escrow for such a long time.
|
73
|
-
</p>
|
74
|
-
</div>
|
75
|
-
<div class="copyright">
|
76
|
-
©2008 Erik Hollensbe, all rights reserved. Please see the
|
77
|
-
README file for the full copyright notice. Please see the
|
78
|
-
LICENSE file in the source package for information on
|
79
|
-
redistributing the source or any of the site content.
|
80
|
-
</div>
|
81
|
-
</div>
|
82
|
-
</body>
|
83
|
-
</html>
|
data/doc/homepage/ruby-dbi.css
DELETED
@@ -1,91 +0,0 @@
|
|
1
|
-
BODY {
|
2
|
-
background-color: #666;
|
3
|
-
}
|
4
|
-
|
5
|
-
a:visited {
|
6
|
-
color: #144;
|
7
|
-
}
|
8
|
-
|
9
|
-
a {
|
10
|
-
color: white;
|
11
|
-
}
|
12
|
-
|
13
|
-
a:active {
|
14
|
-
text-decoration: none;
|
15
|
-
}
|
16
|
-
|
17
|
-
a:hover {
|
18
|
-
text-decoration: none;
|
19
|
-
}
|
20
|
-
|
21
|
-
.body-container {
|
22
|
-
margin-left: auto;
|
23
|
-
margin-right: auto;
|
24
|
-
margin-top: 50px;
|
25
|
-
width: 80%;
|
26
|
-
background-color: #AAA;
|
27
|
-
color: black;
|
28
|
-
padding: 10px;
|
29
|
-
border: 1px solid black;
|
30
|
-
}
|
31
|
-
|
32
|
-
h1 {
|
33
|
-
display: block;
|
34
|
-
margin: 2em;
|
35
|
-
border: 1px solid black;
|
36
|
-
padding: 1em;
|
37
|
-
color: #444;
|
38
|
-
font-size: 1em;
|
39
|
-
text-align: center;
|
40
|
-
font-family: sans-serif;
|
41
|
-
}
|
42
|
-
|
43
|
-
.main-container {
|
44
|
-
margin: 2em;
|
45
|
-
}
|
46
|
-
|
47
|
-
.nav-container {
|
48
|
-
display: block;
|
49
|
-
border: 1px solid black;
|
50
|
-
float: left;
|
51
|
-
vertical-align; top:
|
52
|
-
font-size: .8em;
|
53
|
-
min-width: 20%;
|
54
|
-
margin-right: 2em;
|
55
|
-
margin-bottom: 2em;
|
56
|
-
}
|
57
|
-
|
58
|
-
.nav-container h1 {
|
59
|
-
margin: 0;
|
60
|
-
padding: 0;
|
61
|
-
border: 0;
|
62
|
-
border-bottom: 1px solid black;
|
63
|
-
font-size: 1.2em;
|
64
|
-
font-weight: bold;
|
65
|
-
color: black;
|
66
|
-
text-align: center;
|
67
|
-
font-family: sans-serif;
|
68
|
-
}
|
69
|
-
|
70
|
-
.nav-container a {
|
71
|
-
display: block;
|
72
|
-
padding: 5px;
|
73
|
-
}
|
74
|
-
|
75
|
-
.nav-container a:hover {
|
76
|
-
background-color: #444;
|
77
|
-
color: white;
|
78
|
-
font-weight: bold;
|
79
|
-
}
|
80
|
-
|
81
|
-
.copyright {
|
82
|
-
display: block;
|
83
|
-
margin: 2em;
|
84
|
-
border: 1px solid black;
|
85
|
-
padding: 1em;
|
86
|
-
color: #444;
|
87
|
-
font-size: 0.6em;
|
88
|
-
text-align: center;
|
89
|
-
font-family: sans-serif;
|
90
|
-
}
|
91
|
-
|
data/lib/dbd/Mysql.rb
DELETED
@@ -1,137 +0,0 @@
|
|
1
|
-
#--
|
2
|
-
# Copyright (c) 2001, 2002 Michael Neumann <neumann@s-direktnet.de>
|
3
|
-
#
|
4
|
-
# All rights reserved.
|
5
|
-
#
|
6
|
-
# Redistribution and use in source and binary forms, with or without
|
7
|
-
# modification, are permitted provided that the following conditions
|
8
|
-
# are met:
|
9
|
-
# 1. Redistributions of source code must retain the above copyright
|
10
|
-
# notice, this list of conditions and the following disclaimer.
|
11
|
-
# 2. Redistributions in binary form must reproduce the above copyright
|
12
|
-
# notice, this list of conditions and the following disclaimer in the
|
13
|
-
# documentation and/or other materials provided with the distribution.
|
14
|
-
# 3. The name of the author may not be used to endorse or promote products
|
15
|
-
# derived from this software without specific prior written permission.
|
16
|
-
#
|
17
|
-
# THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
|
18
|
-
# INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
|
19
|
-
# AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
|
20
|
-
# THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
21
|
-
# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
22
|
-
# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
23
|
-
# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
24
|
-
# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
25
|
-
# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
26
|
-
# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
27
|
-
#
|
28
|
-
# $Id$
|
29
|
-
#++
|
30
|
-
|
31
|
-
begin
|
32
|
-
require 'rubygems'
|
33
|
-
gem 'mysql'
|
34
|
-
gem 'dbi'
|
35
|
-
rescue LoadError => e
|
36
|
-
end
|
37
|
-
|
38
|
-
require 'dbi'
|
39
|
-
require "mysql"
|
40
|
-
require "thread" # for Mutex
|
41
|
-
|
42
|
-
module DBI
|
43
|
-
module DBD
|
44
|
-
#
|
45
|
-
# DBD::Mysql - Database Driver for the MySQL database system.
|
46
|
-
#
|
47
|
-
# Requires DBI and the 'mysql' gem or package to work.
|
48
|
-
#
|
49
|
-
# Only things that extend DBI's results are documented.
|
50
|
-
#
|
51
|
-
module Mysql
|
52
|
-
VERSION = "0.4.4"
|
53
|
-
DESCRIPTION = "MySQL DBI DBD, Leverages 'mysql' low-level driver"
|
54
|
-
|
55
|
-
MyError = ::MysqlError
|
56
|
-
|
57
|
-
#
|
58
|
-
# returns 'Mysql'
|
59
|
-
#
|
60
|
-
# See DBI::TypeUtil#convert for more information.
|
61
|
-
#
|
62
|
-
def self.driver_name
|
63
|
-
"Mysql"
|
64
|
-
end
|
65
|
-
|
66
|
-
DBI::TypeUtil.register_conversion(driver_name) do |obj|
|
67
|
-
newobj = case obj
|
68
|
-
when ::DBI::Binary
|
69
|
-
obj = obj.to_s.gsub(/\\/) { "\\\\" }
|
70
|
-
obj = obj.to_s.gsub(/'/) { "''" }
|
71
|
-
"'#{obj}'"
|
72
|
-
when ::DateTime
|
73
|
-
"'#{obj.strftime("%Y-%m-%d %H:%M:%S")}'"
|
74
|
-
when ::Time
|
75
|
-
"'#{obj.strftime("%H:%M:%S")}'"
|
76
|
-
when ::Date
|
77
|
-
"'#{obj.strftime("%Y-%m-%d")}'"
|
78
|
-
when ::NilClass
|
79
|
-
"NULL"
|
80
|
-
else
|
81
|
-
obj
|
82
|
-
end
|
83
|
-
|
84
|
-
if newobj.object_id == obj.object_id
|
85
|
-
[newobj, true]
|
86
|
-
else
|
87
|
-
[newobj, false]
|
88
|
-
end
|
89
|
-
end
|
90
|
-
end
|
91
|
-
end
|
92
|
-
end
|
93
|
-
|
94
|
-
#
|
95
|
-
# Utility Methods for the MySQL DBD.
|
96
|
-
#
|
97
|
-
|
98
|
-
module DBI::DBD::Mysql::Util
|
99
|
-
private
|
100
|
-
|
101
|
-
# Raise exception using information from MysqlError object e.
|
102
|
-
# For state value, use SQLSTATE value if mysql-ruby defines
|
103
|
-
# sqlstate method, otherwise nil.
|
104
|
-
def error(e)
|
105
|
-
sqlstate = e.respond_to?("sqlstate") ? e.sqlstate : nil
|
106
|
-
raise DBI::DatabaseError.new(e.message, e.errno, sqlstate)
|
107
|
-
end
|
108
|
-
|
109
|
-
end # module Util
|
110
|
-
|
111
|
-
module DBI::DBD::Mysql::Type
|
112
|
-
#
|
113
|
-
# Custom handling for DATE types in MySQL. See DBI::Type for more
|
114
|
-
# information.
|
115
|
-
#
|
116
|
-
class Date < DBI::Type::Null
|
117
|
-
def self.parse(obj)
|
118
|
-
obj = super
|
119
|
-
return obj unless obj
|
120
|
-
|
121
|
-
case obj.class
|
122
|
-
when ::Date
|
123
|
-
return obj
|
124
|
-
when ::String
|
125
|
-
return ::Date.strptime(obj, "%Y-%m-%d")
|
126
|
-
else
|
127
|
-
return ::Date.parse(obj.to_s) if obj.respond_to? :to_s
|
128
|
-
return ::Date.parse(obj.to_str) if obj.respond_to? :to_str
|
129
|
-
return obj
|
130
|
-
end
|
131
|
-
end
|
132
|
-
end
|
133
|
-
end
|
134
|
-
|
135
|
-
require 'dbd/mysql/driver'
|
136
|
-
require 'dbd/mysql/database'
|
137
|
-
require 'dbd/mysql/statement'
|