A new ruby database API?

Use the ‘user’ table from the default connection or pool

class User < DB('user')
end`</pre>

#### Use a specific database connection or pool

<pre>`Connection = DBConnection.new(...)

class Post &lt; DB(Connection, 'post')
end`</pre>

That is, identify the database by a (reconnectable) connection to it.

#### Associations

<pre>`class Post &lt; DB('posts'); end

class User &lt; DB('users')
    collection :posts, Post, :author # Optionally specifying remote key
end

class Post &lt; DB('posts')
    reference :author, User
end

Collection associations return a collection object, not an array — it’s enumerable, but will perform the fetch either lazily or eagerly, and has methods to force those. It could also take advantage of cursors for huge datasets.

All in all, it’s like a low-magic, easy-to-debug ActiveRecord that I have in mind. I’d layer it on top of DBI, and go about cleaning that up and speeding it up where possible. I’d also love to see the low-level database APIs speak something that’s directly usable as a DBI driver, and do type conversions in the database-specific and fastest way possible, preferably in C.

Queries by single field name and primary key should be easy. Maybe something like User.find(:name, 'John') or User.fetch(1)

Queries by join to an associated table should be possible. I’d love suggestions for an API. Dropping to SQL should only be needed for really complex cases, and be well-defined how the objects are derived from the result set. Replacing what’s under the hood with something entirely unlike SQL should be possible and only break apps using SQL queries.

All of this makes me wish Ruby had a way to swap in a custom parser inline and then yield back to normal parsing at some place. Something that would allow User.find(name = 'John' and joindate < Date.today) — mixing in some Ruby syntax into a custom parser. I’ve some thoughts on how that could be done, but nothing coherent enough to stick in code.