Batteries-included Clojure development and release workflows using Boot.
Clojure's Boot build tool provides incredible flexibility for composing simple build tasks like compile
or translate-markdown
into a complete development and release workflow.
The challenge is that integrating the more sophisticated Boot tasks requires a nontrivial amount of effort. The boot Boot
project performs those integrations in a single place so you don't have to. For example, boot Boot
:
LiveReload.js
).:open-source
projects to Clojars, update the project web site on Github Pages, tag the release, and push the release tag to Github. (:private
projects are protected against accidentally executing this task.)boot Boot
is built, documented, and deployed using itself.
Preconfigures Boot with the following common tasks/features:
boot dev
or boot cider dev
boot write-site
- Create a beautiful project web site using Markdown, styled using Twitter Bootstrap.
site-src
folder.LiveReload.js
).boot write-full-site
- Like boot write-site
, and generates full API documentation with Codox on each save too.
boot release-site
boot release
- Deploy projects of type :open-source
to Clojars and release the latest project web site to Github Pages.
(...and more, of course. See the Codox for details.)
Updated nrepl, cider, and friends to latest versions.
A dependency cleanup release, with a few minor breaking changes documented below.
nightlight
is no longer supported by default. The --port
option to the dev
task is removed.boot-serve
backed by Immutant no longer selects a default logger; you have to supply your own slf4j implementation.See the New and Noteworthy document for details on what features have been added to other releases.
boot Boot
uses a standard Boot project directory structure, with some extra conventions about how to structure your build.boot
file that reduces repetition. Sample starter files are included in the Getting Started guide.
The latest version is:
All Boot tasks are documented in the Codox.
boot new
template for boot Boot projectsboot Boot
can reuse the template files in its own documentation, easing maintenance.