From 2088a198e915f00e74e84a68346ce7751b526122 Mon Sep 17 00:00:00 2001 From: Michael Blume Date: Sat, 20 May 2017 21:45:20 -0700 Subject: [PATCH] clarify in README that honeysql just generates sql and has nothing to do with your db connection Fix #148? --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 49bb6ac..6117e4c 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,14 @@ Everything is built on top of maps representing SQL queries: => ["SELECT a, b, c FROM foo WHERE (f.a = ?)" "baz"] ``` +Honeysql is a relatively "pure" library, it does not manage your sql connection +or run queries for you, it simply generates SQL strings. You can then pass them +to jdbc: + +```clj +(jdbc/execute! conn (sql/format sqlmap) +``` + You can build up SQL maps yourself or use helper functions. `build` is the Swiss Army Knife helper. It lets you leave out brackets here and there: ```clj