https://github.com/tatut/bearsql

Bare words SQL macro for Clojure
https://github.com/tatut/bearsql

Last synced: 3 months ago
JSON representation

Bare words SQL macro for Clojure

• Host: GitHub
• URL: https://github.com/tatut/bearsql
• Owner: tatut
• License: mit
• Created: 2023-11-25T08:05:42.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-11-30T17:56:31.000Z (about 1 year ago)
• Last Synced: 2024-10-13T22:52:03.198Z (3 months ago)
• Language: Clojure
• Size: 97.7 KB
• Stars: 32
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# BearSQL

![test workflow](https://github.com/tatut/bearsql/actions/workflows/test.yml/badge.svg)

Bare words SQL macro for Clojure.

![BearSQL logo](bearsql.png)

What if you could **just write SQL** as is and still retain safety of parameters.

With BearSQL you can!

```clojure

;; Using ambient dynamic connection

(let [id 1]

  (q select name from product where id = @id))

;; => [{:product/name "Fine leather jacket"}]

```

BearSQL macros provide a minimal symbols to SQL conversion at compile time

while still allowing you to have runtime input parameters.

You can also pass in the database by using a configuration map as the first

argument.

## Syntax rules

- Any symbol is converted to SQL as is (with dashes converted to underscores)

- Symbol `as` is special and allows aliasing

- Vectors are turned into comma separated lists (because comma is whitespace in Clojure) except special (see below)

- Lists are recursively converted and surrounded with parenthesis

- Deref (`@form`) escapes back to Clojure code and uses that value as SQL query parameter

- Strings are passed in as SQL-quoted strings

- Any other Clojure value is used as input parameter as is

- Vector that begins with `:raw` is special and can be used to include any raw SQL fragment and parameters into the query

See unit tests for examples of usage.