On Wed, Mar 6, 2013 at 7:44 AM, Thomas Heller <th.hel...@gmail.com> wrote:
> I'm using [clojure/java.jdbc "0.2.3"] and wasn't sure about a function so I
> looked at the source and noticed that the git master seems to be turning
> into some sort of DSL/ORM?

Not really. The API (for the upcoming 0.3.0 version) has been extended
with new functions to provide a more idiomatic usage (e.g., insert!
and query) based on feedback from Clojure/core and others a long time
ago. The original API will all be deprecated as part of 0.3.0 but kept
around for backward compatibility for a few more point releases (but
will go away close to a 1.0.0 release at some distant future date).

You'll probably find the generated documentation useful:
http://clojure.github.com/java.jdbc/ - I still need to update the
additional documentation linked from that page (part of the
clojure.java.jdbc source).

> Just wondering if the intention is to make the DSL the primary way to work
> with the API or if clojure.java.jdbc.sql will be completely optional?

Completely optional.

The idea is just to provide some (optional) sugar for common
operations. I have no intention of going particularly deep on the DSL.

If folks want a full DSL for SQL in Clojure, I'd suggest
https://github.com/jkk/honeysql or http://sqlkorma.com - the former is
a DSL to generate SQL that is compatible with clojure.java.jdbc, the
latter is a DSL that wraps clojure.java.jdbc.

> Just wondering what motivated the massive API changes?

Motivated by guidelines and feedback to achieve a 1.0.0 release at some point:

http://dev.clojure.org/display/design/Contrib+1.0.0+Releases (general
guidelines)

https://groups.google.com/d/msg/clojure-dev/n3ZdOoDch5g/ir06M1EelesJ
(feedback from Stu on clojure.java.jdbc)

https://groups.google.com/forum/#!topic/clojure-dev/tObIBvGz_Qo/discussion
(my response to some specific questions / suggestions)

The whole "contrib 1.0.0 releases?" thread contains a mix of
clojure.java.jdbc-specific stuff and general contrib library feature
discussion so it's good reading.

Hope that helps?
--
Sean A Corfield -- (904) 302-SEAN
An Architect's View -- http://corfield.org/
World Singles, LLC. -- http://worldsingles.com/

"Perfection is the enemy of the good."
-- Gustave Flaubert, French realist novelist (1821-1880)

-- 
-- 
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your 
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"Clojure" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to