https://github.com/greenyouse/dorali

Transitive SQL and Elasticsearch queries
https://github.com/greenyouse/dorali

Last synced: 2 days ago
JSON representation

Transitive SQL and Elasticsearch queries

• Host: GitHub
• URL: https://github.com/greenyouse/dorali
• Owner: greenyouse
• License: epl-1.0
• Created: 2016-12-15T08:19:55.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2016-12-19T02:38:49.000Z (almost 8 years ago)
• Last Synced: 2024-06-07T00:42:15.915Z (4 months ago)
• Language: Clojure
• Size: 8.79 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# dorali

This is a tiny library for building transitive SQL and Elasticsearch

queries. It's really more of a design pattern than a feature complete

solution. 

For more info I wrote up a blog post about the design of the library

[here](https://edbabcock.com/composable-queries.html). It talks more

about the design pattern and the trade-offs for using it. There are also

some small SQL examples in the post.

## Recent Release

Latest Leiningen version:

[![Clojars Project](https://img.shields.io/clojars/v/com.greenyouse/dorali.svg)](https://clojars.org/com.greenyouse/dorali)

## Usage

The gist is that it's easy to use transitives to create extensible

database queries.

SQL is built on top of [Honey SQL](https://github.com/jkk/honeysql) and

uses it's data structure DSL.

```clj

(require '[dorali.sql.core :as sql])

(def get-employee

  (sql/query>

   {:select [:emp_id :fname :lname]

    :from [:employee]

    :where (sql/term> := :lname (sql/=> :surname))}))

(get-employee {:surname "smith"})

=> {:select [:emp_id :fname :lname],

    :from [:employee],

    :where [:= :lname "smith"]}

```

Elasticsearch queries are written in a similar data structure DSL that

can be passed to a native or REST client.

```clj

(require '[dorali.es.core :as es])

(def get-everything 

  (es/query>

   {:query

    ;; constantly keeps the {}, it escapes the transitive

    {:match-all (constantly {})}

    :size (es/default> 10 :size)}))

(get-everything {:size 5})

=> {:query

    {:match-all {}}

    :size 5}

```

## License

Copyright © 2016 Ed Babcock

Distributed under the Eclipse Public License either version 1.0