boot-vertx

a development webserver for boot (WIP)

[tailrecursion/boot-vertx "0.1.0-SNAPSHOT"] ;; latest release

overview

THIS TASK IS A WORK IN PROGRESS AND NOT YET RECOMMENDED FOR USE. it is designed to speed up the server-side development workflow by utilizing boot's pods to maintain a clean, interactive environment without the need for annoying jvm restarts or libraries that compromise lisp's ability to clearly express the logic of the problem your application is solving. it serves an internal distribution from the fileset's output directories (resources and assets). the distribution mirrors the contents of the environment's target directory, but is served from vertx's classpath as an exploded war file.

rationale

at present, this task is a rather naive implementation that fails to make use of vertx's many features and idioms; to the extend that some of these make sense for use with clojure and boot, they may be exposed over time.

• vertx is simple, modular, and non-bloated.
• vertx facilitates multiple languages on the server through verticles.
• vertx has a first class push story that wasn't included as an afterthought.
• vertx is fast. io is done tthrough netty and java's nio api.

objectives

• embrace ring to remain backwards compatible, but extend the request and response maps that were based on the old javax servlet api standard with the more convenient nomenclature used by vertx.

usage

(require
  '[tailrecursion.boot-vertx :refer [serve]])

  (deftask develop []
    (comp (watch) (speak) (web :serve 'myapp/serve) (serve))))

demo

to see it in action, check out the project, type boot demo, navigate your browser to localhost:3006, then edit the test app in tst/tailrecursion/boot_vertx_app.clj. You should have a clean app instance in about 0.044 sec after each save.

development

to enhance boot-vertx while using a test driven development workflow, from the project root, type:

boot develop