A simple HTTP serve task for use with the boot build tool that can serve resources, directories or a typical ring handler.

[pandeiro/boot-http "0.7.6"] ;; latest release

(The following examples assume you have boot installed and updated.)

This serves the current directory at port 3000:

boot -d pandeiro/boot-http serve -d . wait

To inspect the meanings of the flags and other tasks, use boot's built-in documentation mechanism:

boot -d pandeiro/boot-http -h       # show all tasks on the classpath
boot -d pandeiro/boot-http serve -h # show serve's usage

If you already have a build.boot, add pandeiro/boot-http to :dependencies and (require '[pandeiro.boot-http :refer :all]).

You can use boot-http for three different use cases:

boot serve wait   # or from REPL: (boot (serve) (wait))

boot serve -d target wait   # or at the REPL: (boot (serve :dir "target") (wait))

That would serve the target directory if it exists.

Instead of specifying a directory, you can also specify a ring handler:

boot serve -H myapp.server/app -R wait   # (boot (serve :handler 'myapp.server/app :reload true) (wait))

You may have noticed the wait task being used after all the command-line invocations so far. This is because by itself, the serve task does not block and thus exits immediately.

What good is that? It means you can compose with other tasks.

In boot-cljs-example, for example, serve is invoked like so:

boot serve watch speak reload cljs-repl cljs -usO none

which is, again, the same as:

(comp (serve)
      (watch)
      (speak)
      (reload)
      (cljs-repl)
      (cljs :optimizations :none))

In that case, since serve is given a directory, it serves the directory and whatever resources can be found on the classpath, and then gets out of the way.

Use a specific port. A value of 0 will automatically bind to a free port. The actual port number being used is available as :http-port on the fileset.

boot -d pandeiro/boot-http serve -d . -p 8888 wait

Use the HTTP Kit webserver instead of Jetty.

boot -d pandeiro/boot-http serve -d . -k wait  # uses httpkit

Start an nREPL server for access to the http server. Accepts :port and :bind options for setting nREPL server IP and port.

boot -d pandeiro/boot-http serve -d . -n "{:port 3001}"

Setup and teardown functions to run.

Silences all output.

Wrap provided ring handler with ring-reload.

Use the provided symbol's function to handle requests for results that are not found.

Serve over HTTPS (see -T / --ssl-props as well): Jetty only.

boot serve -d target -N myapp.server/custom-not-found wait

Right now that is about it. It basically blends the functionality of python3 -m http.server and a subset of lein ring server.

Feel free to add issues or comment here if you have any ideas.

The boot guys basically wrote all of this or walked me through any parts I had to change. Thanks!

Copyright © 2015 Murphy McMahon

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.