Toucan 2

Toucan 2 is a successor library to Toucan with a modern and more-extensible API, more consistent behavior (less gotchas), support for different backends including non-JDBC databases and non-HoneySQL queries, and more useful utilities.

Toucan 2 uses Honey SQL 2, next.jdbc (a bit), and Methodical under the hood. Everything is super efficient and reducible under the hood (even inserts, updates, and deletes!) and magical (in a good way).

After working on this off and on for several years I decided that the library was overly complicated (at nearly 8000 lines of code) and decided to start over and re-implement things in a ~simpler fashion~ (EDIT: back up to 7000 LoC, but it's easier to use this time). The library is mostly usable now but I have a big pile of things to do before the official announcement -- take a look at the Trello board -- when things get a little further along I'll move things over to GitHub issues. I will update this README when I publish the first alpha release.

In the mean time, browse the Documentation, which are a work in progress.

toucan2-toucan1

Compatibility layer for projects using Toucan 1 to ease transition to Toucan 2. Implements the same namespaces as Toucan 1, but they are implemented on top of Toucan 2. Projects using Toucan 1 can remove their dependency on toucan, and include a dependency on io.github.camsaul/toucan2-toucan1 in its place; with a few changes your project should work without having to switch everything to Toucan 2 all at once. More details on this coming soon.

See toucan2-toucan1 docs for more information.

License

Code, documentation, and artwork copyright © 2017-2022 Cam Saul.

Distributed under the Eclipse Public License, same as Clojure.