From a2ee638b3bb72c70793c5d5f16d3ae2056bf1c59 Mon Sep 17 00:00:00 2001 From: Sean Corfield Date: Wed, 16 Jun 2021 23:01:33 -0700 Subject: [PATCH] prep for 2.0.0-rc3 --- CHANGELOG.md | 3 ++- README.md | 2 +- doc/differences-from-1-x.md | 4 ++-- doc/general-reference.md | 2 +- doc/getting-started.md | 6 +++--- pom.xml | 4 ++-- 6 files changed, 11 insertions(+), 10 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 696c16f..bca889a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,11 +1,12 @@ # Changes -* 2.0.next in progress +* 2.0.0-rc3 (for testing; 2021-06-16) * Fix #328 by adding `:distinct` as special syntax, affecting an expression. * Address #327 by changing "unknown clause" error to including mention of "nil values" (which are also illegal). * Fix #327 by making single-argument helpers consistent with multi-argument helpers. * Support PostgreSQL's `&&` array operator. * Clarify how to `SELECT` a function expression (in **Getting Started**). + * Update `test-runner`. * 2.0.0-rc2 (for testing; 2021-05-10) * Fix #326 by allowing `ON`/`USING` to be optional and not dropping parameters on the floor. diff --git a/README.md b/README.md index 1bc7bdd..61bc4db 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ SQL as Clojure data structures. Build queries programmatically -- even at runtim ## Build -[![Clojars Project](https://clojars.org/com.github.seancorfield/honeysql/latest-version.svg)](https://clojars.org/com.github.seancorfield/honeysql) [![cljdoc badge](https://cljdoc.org/badge/com.github.seancorfield/honeysql?2.0.0-rc2)](https://cljdoc.org/d/com.github.seancorfield/honeysql/CURRENT) +[![Clojars Project](https://clojars.org/com.github.seancorfield/honeysql/latest-version.svg)](https://clojars.org/com.github.seancorfield/honeysql) [![cljdoc badge](https://cljdoc.org/badge/com.github.seancorfield/honeysql?2.0.0-rc3)](https://cljdoc.org/d/com.github.seancorfield/honeysql/CURRENT) Once the prerelease testing is complete, this project will follow the version scheme MAJOR.MINOR.COMMITS where MAJOR and MINOR provide some relative indication of the size of the change, but do not follow semantic versioning. In general, all changes endeavor to be non-breaking (by moving to new names rather than by breaking existing names). COMMITS is an ever-increasing counter of commits since the beginning of this repository. diff --git a/doc/differences-from-1-x.md b/doc/differences-from-1-x.md index 677a242..033bbc7 100644 --- a/doc/differences-from-1-x.md +++ b/doc/differences-from-1-x.md @@ -49,7 +49,7 @@ Supported Clojure versions: 1.7 and later. ```clojure ;; in deps.edn: -com.github.seancorfield/honeysql {:mvn/version "2.0.0-rc2"} +com.github.seancorfield/honeysql {:mvn/version "2.0.0-rc3"} ;; in use: (ns my.project @@ -70,7 +70,7 @@ Supported Clojure versions: 1.9 and later. ## API Changes -The primary API is just `honey.sql/format`. The `array`, `call`, `inline`, `param`, and `raw` functions have all become standard syntax in the DSL as functions (and their tagged literal equivalents have also gone away because they are no longer needed). _[As of 2.0.next, `call` has been reinstated as an undocumented function in `honey.sql` purely to aid migration from 1.x]_ +The primary API is just `honey.sql/format`. The `array`, `call`, `inline`, `param`, and `raw` functions have all become standard syntax in the DSL as functions (and their tagged literal equivalents have also gone away because they are no longer needed). _[As of 2.0.0-rc3, `call` has been reinstated as an undocumented function in `honey.sql` purely to aid migration from 1.x]_ Other `honeysql.core` functions that no longer exist include: `build`, `qualify`, and `quote-identifier`. Many other public functions were essentially undocumented (neither mentioned in the README nor in the tests) and also no longer exist. diff --git a/doc/general-reference.md b/doc/general-reference.md index 6c460ed..6ad5a78 100644 --- a/doc/general-reference.md +++ b/doc/general-reference.md @@ -114,6 +114,6 @@ section. The full list of "special syntax" functions is documented in the [Special Syntax](special-syntax.md) section. The best documentation for the helper functions is in the -[honey.sql.helpers](https://cljdoc.org/d/com.github.seancorfield/honeysql/2.0.0-rc2/api/honey.sql.helpers) namespace. +[honey.sql.helpers](https://cljdoc.org/d/com.github.seancorfield/honeysql/2.0.0-rc3/api/honey.sql.helpers) namespace. If you're migrating to HoneySQL 2.x, this [overview of differences between 1.x and 2.x](differences-from-1-x.md) should help. diff --git a/doc/getting-started.md b/doc/getting-started.md index e99daec..b0a9164 100644 --- a/doc/getting-started.md +++ b/doc/getting-started.md @@ -9,13 +9,13 @@ data to a SQL statement (string) and any parameters it needs. For the Clojure CLI, add the following dependency to your `deps.edn` file: ```clojure - com.github.seancorfield/honeysql {:mvn/version "2.0.0-rc2"} + com.github.seancorfield/honeysql {:mvn/version "2.0.0-rc3"} ``` For Leiningen, add the following dependency to your `project.clj` file: ```clojure - [com.github.seancorfield/honeysql "2.0.0-rc2"] + [com.github.seancorfield/honeysql "2.0.0-rc3"] ``` HoneySQL produces SQL statements but does not execute them. @@ -367,7 +367,7 @@ section. The full list of "special syntax" functions is documented in the [Special Syntax](special-syntax.md) section. The best documentation for the helper functions is in the -[honey.sql.helpers](https://cljdoc.org/d/com.github.seancorfield/honeysql/2.0.0-rc2/api/honey.sql.helpers) namespace. +[honey.sql.helpers](https://cljdoc.org/d/com.github.seancorfield/honeysql/2.0.0-rc3/api/honey.sql.helpers) namespace. More detail about certain core HoneySQL functionality can be found in the [Reference documentation](general-reference.md). If you're migrating to HoneySQL 2.x, this [overview of differences diff --git a/pom.xml b/pom.xml index 96e19a9..2f173f4 100644 --- a/pom.xml +++ b/pom.xml @@ -3,7 +3,7 @@ 4.0.0 com.github.seancorfield honeysql - 2.0.0-rc2 + 2.0.0-rc3 honeysql SQL as Clojure data structures. https://github.com/seancorfield/honeysql @@ -25,7 +25,7 @@ https://github.com/seancorfield/honeysql scm:git:git://github.com/seancorfield/honeysql.git scm:git:ssh://git@github.com/seancorfield/honeysql.git - v2.0.0-rc2 + v2.0.0-rc3