Docs and auto-detect launchpad version

Author: plexus

README.md

@@ -68,7 +68,7 @@ docker-compose, ensure environment variables are set up? You do that here.
 ```clj
 #!/usr/bin/env bb
 
-('require '[lambdaisland.launchpad :as launchpad])
+(require '[lambdaisland.launchpad :as launchpad])
 
 (launchpad/main {})
 
@@ -133,6 +133,35 @@ You don't have to stop there, you could add a `dev/user.clj` (add "dev" to your
 even want to put cross-project integration tests in this repo, but the above is
 the main stuff you need.
 
+## Using Launchpad
+
+When invoking `bin/launchpad` you pass it any aliases you want to start, plus a
+number of optional flags. These currently allow injecting the CIDER and/or
+refactor-nrepl middleware, which will suffice to use launchpad with Emacs/CIDER,
+VS Code/Calva, and probably others.
+
+Please do file issues on Github for your favorite editor environment, we want to
+eventually support every Clojure editor out there with a non-negligible user
+base.
+
+Emacs is currently best supported, since we are able to query Emacs to find
+which versions of cider-nrepl and refactor-nrepl we should inject, and are also
+able to instruct Emacs to connect to the REPL, so the whole process is smooth
+and automated. This level of integration will not be possible with every editor,
+but we can look into what options we have.
+
+```clj
+➜ bin/launchpad --help
+bin/launchpad <options> [proj1|proj2]+
+
+  -h, --help
+  -v, --verbose         Print debug information
+      --cider-nrepl     Include the CIDER nREPL middleware
+      --refactor-nrepl  Include the refactor-nrepl middleware
+      --cider-connect   Automatically connect CIDER
+      --emacs           Shorthand for --cider-nrepl --refactor-nrepl --cider-connect
+```
+
 <!-- opencollective -->
 ## Lambda Island Open Source
 

src/lambdaisland/launchpad.clj

@@ -24,10 +24,12 @@
 (def classpath-coords
   {:mvn/version "0.4.44"}
   #_{:local/root "/home/arne/github/lambdaisland/classpath"})
-(def launchpad-coords {
-                       ;; :git/url "https://github.com/lambdaisland/launchpad"
-                       ;; :git/sha "176b4678c201e2a04e9110c27b39628fd7342a60"
-                       :local/root "/home/arne/github/lambdaisland/launchpad"})
+
+(def default-launchpad-coords
+  "Version coordinates for Launchpad, which we use to inject ourselves into the
+  project dependencies for runtime support. Only used when we are unable to find
+  the current version in `bb.edn`"
+  {:mvn/version "RELEASE"})
 
 (def verbose? (some #{"-v" "--verbose"} *command-line-args*))
 
@@ -230,8 +232,14 @@
                     ~@build-ids)))
       ctx)))
 
+(defn find-launchpad-coords []
+  (or
+   (when (.exists (io/file "bb.edn"))
+     (get-in (edn/read-string (slurp "bb.edn")) [:deps 'com.lambdaisland/launchpad]))
+   default-launchpad-coords))
+
 (defn include-launchpad-deps [{:keys [extra-deps] :as ctx}]
-  (update ctx :extra-deps assoc 'com.lambdaisland/launchpad launchpad-coords))
+  (update ctx :extra-deps assoc 'com.lambdaisland/launchpad (find-launchpad-coords)))
 
 (defn start-process [{:keys [options aliases nrepl-port env] :as ctx}]
   (let [args (clojure-cli-args ctx)]

template/bin/launchpad

@@ -1,6 +1,6 @@
 #!/usr/bin/env bb
 
-('require '[lambdaisland.launchpad :as launchpad])
+(require '[lambdaisland.launchpad :as launchpad])
 
 (launchpad/main {})