luciano/honeysql
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Fix README now into is a helper function

Browse source
This commit is contained in:
Sean Corfield 2021-03-13 13:46:47 -08:00
parent 16d04a1dfd
commit 9f6393a2fd
1 changed files with 12 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
README.md
View file

@ -30,10 +30,15 @@ Some of these samples show pretty-printed SQL: HoneySQL 2.x supports `:pretty tr
## Usage ## Usage
```clojure ```clojure
(refer-clojure :exclude '[for group-by set update]) (refer-clojure :exclude '[for group-by into partition-by set update])
(require '[honey.sql :as sql] (require '[honey.sql :as sql]
;; caution: this overwrites for, group-by, set, and update ;; caution: this overwrites several clojure.core fns:
'[honey.sql.helpers :refer :all :as h]) ;; for, group-by, into, partition-by, set, and update
;; you should generally only refer in the specific
;; helpers that you want to use!
'[honey.sql.helpers :refer :all :as h]
;; so we can still get at clojure.core functions:
'[clojure.core :as c])
``` ```
Everything is built on top of maps representing SQL queries: Everything is built on top of maps representing SQL queries:
@ -735,9 +740,9 @@ Or perhaps your database supports syntax like `a BETWIXT b AND c`, in which case
[sql-c & params-c] (sql/format-expr c)] [sql-c & params-c] (sql/format-expr c)]
(-> [(str sql-a " " (sql/sql-kw op) " " (-> [(str sql-a " " (sql/sql-kw op) " "
sql-b " AND " sql-c)] sql-b " AND " sql-c)]
(into params-a) (c/into params-a)
(into params-b) (c/into params-b)
(into params-c))))) (c/into params-c)))))
;; example usage: ;; example usage:
(-> (select :a) (where [:betwixt :a 1 10]) sql/format) (-> (select :a) (where [:betwixt :a 1 10]) sql/format)
=> ["SELECT a WHERE a BETWIXT ? AND ?" 1 10] => ["SELECT a WHERE a BETWIXT ? AND ?" 1 10]
@ -755,7 +760,7 @@ You can also register SQL clauses, specifying the keyword, the formatting functi
(if (ident? x) (if (ident? x)
(sql/format-expr x) (sql/format-expr x)
(sql/format-dsl x))] (sql/format-dsl x))]
(into [(str (sql/sql-kw clause) " " sql)] params))) (c/into [(str (sql/sql-kw clause) " " sql)] params)))
:from) ; SELECT ... FOOBAR ... FROM ... :from) ; SELECT ... FOOBAR ... FROM ...
;; example usage: ;; example usage:
(sql/format {:select [:a :b] :foobar :baz}) (sql/format {:select [:a :b] :foobar :baz})