prep for 2.0.0-rc3

This commit is contained in:
Sean Corfield 2021-06-16 23:01:33 -07:00
parent 3b00d5c3e6
commit a2ee638b3b
6 changed files with 11 additions and 10 deletions

View file

@ -1,11 +1,12 @@
# Changes # 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. * 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). * 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. * Fix #327 by making single-argument helpers consistent with multi-argument helpers.
* Support PostgreSQL's `&&` array operator. * Support PostgreSQL's `&&` array operator.
* Clarify how to `SELECT` a function expression (in **Getting Started**). * Clarify how to `SELECT` a function expression (in **Getting Started**).
* Update `test-runner`.
* 2.0.0-rc2 (for testing; 2021-05-10) * 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. * Fix #326 by allowing `ON`/`USING` to be optional and not dropping parameters on the floor.

View file

@ -4,7 +4,7 @@ SQL as Clojure data structures. Build queries programmatically -- even at runtim
## Build ## 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. 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.

View file

@ -49,7 +49,7 @@ Supported Clojure versions: 1.7 and later.
```clojure ```clojure
;; in deps.edn: ;; 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: ;; in use:
(ns my.project (ns my.project
@ -70,7 +70,7 @@ Supported Clojure versions: 1.9 and later.
## API Changes ## 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. 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.

View file

@ -114,6 +114,6 @@ section. The full list
of "special syntax" functions is documented in the of "special syntax" functions is documented in the
[Special Syntax](special-syntax.md) section. The best [Special Syntax](special-syntax.md) section. The best
documentation for the helper functions is in the 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 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. between 1.x and 2.x](differences-from-1-x.md) should help.

View file

@ -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: For the Clojure CLI, add the following dependency to your `deps.edn` file:
```clojure ```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: For Leiningen, add the following dependency to your `project.clj` file:
```clojure ```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. 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 of "special syntax" functions is documented in the
[Special Syntax](special-syntax.md) section. The best [Special Syntax](special-syntax.md) section. The best
documentation for the helper functions is in the 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 More detail about certain core HoneySQL functionality can be found in the
[Reference documentation](general-reference.md). [Reference documentation](general-reference.md).
If you're migrating to HoneySQL 2.x, this [overview of differences If you're migrating to HoneySQL 2.x, this [overview of differences

View file

@ -3,7 +3,7 @@
<modelVersion>4.0.0</modelVersion> <modelVersion>4.0.0</modelVersion>
<groupId>com.github.seancorfield</groupId> <groupId>com.github.seancorfield</groupId>
<artifactId>honeysql</artifactId> <artifactId>honeysql</artifactId>
<version>2.0.0-rc2</version> <version>2.0.0-rc3</version>
<name>honeysql</name> <name>honeysql</name>
<description>SQL as Clojure data structures.</description> <description>SQL as Clojure data structures.</description>
<url>https://github.com/seancorfield/honeysql</url> <url>https://github.com/seancorfield/honeysql</url>
@ -25,7 +25,7 @@
<url>https://github.com/seancorfield/honeysql</url> <url>https://github.com/seancorfield/honeysql</url>
<connection>scm:git:git://github.com/seancorfield/honeysql.git</connection> <connection>scm:git:git://github.com/seancorfield/honeysql.git</connection>
<developerConnection>scm:git:ssh://git@github.com/seancorfield/honeysql.git</developerConnection> <developerConnection>scm:git:ssh://git@github.com/seancorfield/honeysql.git</developerConnection>
<tag>v2.0.0-rc2</tag> <tag>v2.0.0-rc3</tag>
</scm> </scm>
<dependencies> <dependencies>
<dependency> <dependency>