From 249ab639ec25af59d69217926a65724d09c4a245 Mon Sep 17 00:00:00 2001 From: Sean Corfield Date: Fri, 6 Aug 2021 11:35:53 -0700 Subject: [PATCH] Add links to HoneySQL web app --- CHANGELOG.md | 3 ++- README.md | 8 ++++++++ doc/getting-started.md | 4 ++++ 3 files changed, 14 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e4b033c..1376258 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,8 +1,9 @@ # Changes -* 2.0.next in progress +* 2.0.next in progress ("gold" mid-August?) * Fixes #340 by making hyphen to space logic more general so _operators_ containing `-` should retain the hyphen without special cases. * Documentation improvements: `:fetch`, `:lift`, `:limit`, `:offset`, `:param`, `:select`; also around JSON/PostgreSQL. + * Link to the [HoneySQL web app](https://www.john-shaffer.com/honeysql/) in both the README and **Getting Started**. * Update `depstar` and `test-runner`. * 2.0.0-rc5 (for testing; 2021-07-17) diff --git a/README.md b/README.md index 44edf1f..c2ca0d6 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,14 @@ Compared to 1.x, HoneySQL 2.x provides a streamlined codebase and a simpler meth > Note: you can use 1.x and 2.x side-by-side as they use different group IDs and different namespaces. This allows for a piecemeal migration. See this [summary of differences between 1.x and 2.x](doc/differences-from-1-x.md) if you are migrating from 1.x! +## Try HoneySQL Online! + +[John Shaffer](https://github.com/john-shaffer) has created this awesome +[HoneySQL web app](https://www.john-shaffer.com/honeysql/), written in ClojureScript, +so you can experiment with HoneySQL in a browser, including setting different +options so you can generate pretty SQL with inline values (via `:inline true`) +for copying and pasting directly into your SQL tool of choice! + ## Note on code samples All sample code in this README is automatically run as a unit test using diff --git a/doc/getting-started.md b/doc/getting-started.md index 3a9a302..495138f 100644 --- a/doc/getting-started.md +++ b/doc/getting-started.md @@ -22,6 +22,10 @@ HoneySQL produces SQL statements but does not execute them. To execute SQL statements, you will also need a JDBC wrapper like [`seancorfield/next.jdbc`](https://github.com/seancorfield/next-jdbc) and a JDBC driver for the database you use. +You can also experiment with HoneySQL directly in a browser -- no installation +required -- using [John Shaffer](https://github.com/john-shaffer)'s awesome +[HoneySQL web app](https://www.john-shaffer.com/honeysql/), written in ClojureScript! + ## Basic Concepts SQL statements are represented as hash maps, with keys that