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

more readme updates

Browse source
This commit is contained in:
Justin Kramer 2012-08-24 18:31:49 -04:00
parent ee7f891aea
commit b20a8ab06d
1 changed files with 7 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
README.md
View file

@ -26,9 +26,7 @@ Everything is built on top of maps representing SQL queries:
=> ["SELECT a, b, c FROM foo WHERE (f.a = ?)" "baz"]
```
You can build up a SQL map yourself or use helper functions.
`build` is the Swiss Army Knife helper. It lets you leave out brackets here and there:
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
(sql/build :select :*
@ -99,7 +97,7 @@ calls and raw SQL fragments:
=> ["SELECT COUNT(*), @var := foo.bar FROM foo"]
```
Here's a big, complicated query. (Note that Honey SQL makes no attempt to verify that your queries are valid):
Here's a big, complicated query. Note that Honey SQL makes no attempt to verify that your queries are valid.
```clj
(-> (select :f.* :b.baz :c.quux (sql/call :now) (sql/raw "@x := 10"))
@ -132,11 +130,13 @@ You can define your own function handlers for use in `where`:
```clj
(require '[honeysql.format :as fmt])
;; Note: already built-in. Usage: (where [:between :field 1 10])
(defmethod fmt/fn-handler "between" [_ field lower upper]
(str (fmt/to-sql field) " BETWEEN "
(defmethod fmt/fn-handler "betwixt" [_ field lower upper]
(str (fmt/to-sql field) " BETWIXT "
(fmt/to-sql lower) " AND " (fmt/to-sql upper)))
(-> (select :a) (where [:betwixt :a 1 10]) sql/format)
=> ["SELECT a WHERE a BETWIXT 1 AND 10"]
```
You can also define your own clauses: