re: the ::events (sorry late to the party)

["/events" {:get [::events (start-event-stream stream-ready)]}]

this maps GET requests the url ”/events” to (start-event-stream) but also names the route

you can have unnamed routes {:get (start-event-stream stream-ready)}

or named routes as above

you name them with a keyword that you can pass to route/url-for

in this case, the keyword is namespaced, hence the extra colon :

so assuming that file is in ns

(ns example.routes)

then ::events is shorthand for :example.routes/events

this allows you to use a generic word like ‘events'

while avoiding name clashes

from a hypothetically different namespace, assume you want to redirect someone to that endpoint

you could do

`(ns example.other (:require [io.pedestal.http.route :as route] [example.routes :as r])) … (ring/redirect (route/url-for ::r/events)) `

meh forgive the formatting, hopefully the idea is clear...

hope that helps someone