Releasing 4.2.1

Author: jpmonettas

.dir-locals.el

@@ -1 +1,5 @@
-((clojure-mode . ((cider-clojure-cli-aliases . "dev:storm"))))
+((clojure-mode . ((cider-clojure-cli-aliases . "dev:dev-tools:storm")
+				  (clojure-dev-menu-name . "flow-storm-dev-menu")                  
+                  (cider-jack-in-nrepl-middlewares . ("refactor-nrepl.middleware/wrap-refactor"
+                                                      "cider.nrepl/cider-middleware"
+                                                      "flow-storm.nrepl.middleware/wrap-flow-storm")))))

Readme.md

@@ -22,9 +22,9 @@ You use it by swapping the official Clojure compiler by ClojureStorm at dev time
 FlowStorm latest stable releases :
 
 - The complete debugger (includes `flow-storm-inst`)
-  - `[com.github.flow-storm/flow-storm-dbg "4.2.0"]`
+  - `[com.github.flow-storm/flow-storm-dbg "4.2.1"]`
 - A slimmer version with no GUI, to use it for Clojure or ClojureScript remote debugging
-  - `[com.github.flow-storm/flow-storm-inst "4.2.0"]`
+  - `[com.github.flow-storm/flow-storm-inst "4.2.1"]`
 
 ClojureStorm latest stable releases : 
 

build.clj

@@ -5,7 +5,7 @@
             [clojure.spec.alpha :as s]))
 
 (def version (or (System/getenv "VERSION")
-                 "4.2.1-SNAPSHOT"))
+                 "4.2.1"))
 
 (def target-dir "target")
 (def class-dir (str target-dir "/classes"))

docs/user_guide.adoc

@@ -53,10 +53,10 @@ You can start a repl with FlowStorm with a single command like this :
 [%nowrap,bash]
 ----
 ;; on Linux and OSX
-clj -Sforce -Sdeps '{:deps {} :aliases {:dev {:classpath-overrides {org.clojure/clojure nil} :extra-deps {com.github.flow-storm/clojure {:mvn/version "1.12.0-9"} com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}}}' -A:dev
+clj -Sforce -Sdeps '{:deps {} :aliases {:dev {:classpath-overrides {org.clojure/clojure nil} :extra-deps {com.github.flow-storm/clojure {:mvn/version "1.12.0-9"} com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}}}' -A:dev
 
 ;; on Windows
-clj -Sforce -Sdeps '{:deps {} :aliases {:dev {:classpath-overrides {org.clojure/clojure nil} :extra-deps {com.github.flow-storm/clojure {:mvn/version """1.12.0-9"""} com.github.flow-storm/flow-storm-dbg {:mvn/version """4.2.0"""}}}}}' -A:dev
+clj -Sforce -Sdeps '{:deps {} :aliases {:dev {:classpath-overrides {org.clojure/clojure nil} :extra-deps {com.github.flow-storm/clojure {:mvn/version """1.12.0-9"""} com.github.flow-storm/flow-storm-dbg {:mvn/version """4.2.1"""}}}}}' -A:dev
 ----
 
 Pasting that command on your terminal will bring up a repl with _FlowStorm_ and the compiler swapped by _ClojureStorm_. When the repl comes up
@@ -78,7 +78,7 @@ If your project is using deps.edn, you can add <<#_global_deps_edn_aliases,a glo
            {;; for disabling the official compiler
             :classpath-overrides {org.clojure/clojure nil} 
             :extra-deps {com.github.flow-storm/clojure {:mvn/version "1.12.0-9"}
-                         com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}}}
+                         com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}}}
 ----
 
 What gets instrumented will be determined automatically by ClojureStorm from your project. You can always disable this
@@ -107,7 +107,7 @@ If your project uses lein, you can add <<#_global_leiningen_profiles,a global>>
 (defproject my.project "1.0.0"
   :profiles {:1.12-storm
              {:dependencies [[com.github.flow-storm/clojure "1.12.0-9"]
-                             [com.github.flow-storm/flow-storm-dbg "4.2.0"]]
+                             [com.github.flow-storm/flow-storm-dbg "4.2.1"]]
               :exclusions [org.clojure/clojure]}}
   ...)
 ----
@@ -150,7 +150,7 @@ You can setup your global `~/.clojure/deps.edn` (on linux and macOS) or `%USERPR
  :aliases
  {:1.12-storm {:classpath-overrides {org.clojure/clojure nil}
                :extra-deps {com.github.flow-storm/clojure {:mvn/version "1.12.0-9"}
-                            com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}
+                            com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}
                :jvm-opts ["-Dflowstorm.theme=dark"
                           "-Dflowstorm.fileEditorCommand=emacsclient -n +<<LINE>>:0 <<FILE>>"
                           "-Dflowstorm.jarEditorCommand=emacsclient --eval '(let ((b (cider-find-file \"jar:file:<<JAR>>!/<<FILE>>\"))) (with-current-buffer b (switch-to-buffer b) (goto-char (point-min)) (forward-line (1- <<LINE>>))))'"]}
@@ -178,7 +178,7 @@ You can setup your global `~/.lein/profiles.clj` (on linux and macOS) or `%USERP
 ----
 {:1.12-storm
  {:dependencies [[com.github.flow-storm/clojure "1.12.0-9"]
-                 [com.github.flow-storm/flow-storm-dbg "4.2.0"]]
+                 [com.github.flow-storm/flow-storm-dbg "4.2.1"]]
   :exclusions [org.clojure/clojure]
   :jvm-opts ["-Dflowstorm.theme=dark"
              ;; change for your specific editor
@@ -210,10 +210,10 @@ If you use the https://clojure.org/guides/deps_and_cli[clojure cli] you can star
 [,bash]
 ----
 ;; on Linux and OSX
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}'
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}'
 
 ;; on Windows
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version """4.2.0"""}}}'
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version """4.2.1"""}}}'
 ----
 
 If you are a https://leiningen.org/[lein] user add the dependency to your project.clj `:dependencies` and run `lein repl`.
@@ -317,7 +317,7 @@ Then, modify your `deps.edn` dev profile to look like this :
                      ;; bring ClojureScriptStorm
                      com.github.flow-storm/clojurescript {:mvn/version "1.11.132-8"}
                      ;; add FlowStorm runtime dep
-                     com.github.flow-storm/flow-storm-inst {:mvn/version "4.2.0"}}
+                     com.github.flow-storm/flow-storm-inst {:mvn/version "4.2.1"}}
        :jvm-opts ["-Dcljs.storm.instrumentOnlyPrefixes=your-app-base-ns"
                    "-Dcljs.storm.instrumentEnable=true"
                    "-Dflowstorm.startRecording=false"]}}}
@@ -339,7 +339,7 @@ Whenever your need the debugger, on a terminal run the ui with your shadow-cljs.
 
 [,bash]
 ----
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :my-app
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :my-app
 ----
 
 and then reload you page so it connects to it.
@@ -365,21 +365,21 @@ To compile instrumented files :
 
 [%nowrap,bash]
 ----
-clj -J-Dcljs.storm.instrumentOnlyPrefixes=org.foo -J-Dcljs.storm.instrumentEnable=true -Sdeps '{:paths ["src"] :deps {com.github.flow-storm/clojurescript {:mvn/version "1.11.132-8"} com.github.flow-storm/flow-storm-inst {:mvn/version "4.2.0"}}}' -M -m cljs.main -co '{:preloads [flow-storm.storm-preload] :main org.foo.core}' --compile
+clj -J-Dcljs.storm.instrumentOnlyPrefixes=org.foo -J-Dcljs.storm.instrumentEnable=true -Sdeps '{:paths ["src"] :deps {com.github.flow-storm/clojurescript {:mvn/version "1.11.132-8"} com.github.flow-storm/flow-storm-inst {:mvn/version "4.2.1"}}}' -M -m cljs.main -co '{:preloads [flow-storm.storm-preload] :main org.foo.core}' --compile
 ----
 
 To run a repl that instrument everything under org.foo :
 
 [%nowrap,bash]
 ----
-clj -J-Dcljs.storm.instrumentOnlyPrefixes=org.foo -J-Dcljs.storm.instrumentEnable=true -Sdeps '{:paths ["src"] :deps {com.github.flow-storm/clojurescript {:mvn/version "1.11.132-8"} com.github.flow-storm/flow-storm-inst {:mvn/version "4.2.0"}}}' -M -m cljs.main -co '{:preloads [flow-storm.storm-preload] :main org.foo.core}' --repl
+clj -J-Dcljs.storm.instrumentOnlyPrefixes=org.foo -J-Dcljs.storm.instrumentEnable=true -Sdeps '{:paths ["src"] :deps {com.github.flow-storm/clojurescript {:mvn/version "1.11.132-8"} com.github.flow-storm/flow-storm-inst {:mvn/version "4.2.1"}}}' -M -m cljs.main -co '{:preloads [flow-storm.storm-preload] :main org.foo.core}' --repl
 ----
 
 Then run the _FlowStorm_ UI :
 
 [%nowrap,bash]
 ----
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}' -X flow-storm.debugger.main/start-debugger
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}' -X flow-storm.debugger.main/start-debugger
 ----
 
 And now refresh your browser page so your browser app connects to the UI.
@@ -395,7 +395,7 @@ First you need to add _FlowStorm_ dependency to your project dependencies, like
 $ cat shadow-cljs.edn
 
 {...
- :dependencies [... [com.github.flow-storm/flow-storm-inst "4.2.0"]]
+ :dependencies [... [com.github.flow-storm/flow-storm-inst "4.2.1"]]
 
  ;; the next two lines aren't needed but pretty convenient
  :nrepl {:port 9000}
@@ -426,10 +426,10 @@ so to start the debugger and connect to it you run :
 [,bash]
 ----
 ;; on linux and mac-os
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :my-build-id
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :my-build-id
 
 ;; on windows
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version """4.2.0"""}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :my-build-id
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version """4.2.1"""}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :my-build-id
 ----
 
 And that is all you need, the debugger GUI will pop up and everything will be ready.
@@ -462,7 +462,7 @@ For this you can start the debugger like before but without any parameters, like
 
 [,bash]
 ----
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}' -X flow-storm.debugger.main/start-debugger
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}' -X flow-storm.debugger.main/start-debugger
 ----
 
 And then go to your app code and call `(flow-storm.runtime.debuggers-api/remote-connect)` maybe on your main, so every time your program starts
@@ -515,10 +515,10 @@ So let's say you want to run two debuggers, one for your page and one for a webw
 [,bash]
 ----
 # on one terminal start your app debugger instance
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :my-app :ws-port 7722
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :my-app :ws-port 7722
 
 # on a second terminal start your webworker debugger instance
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :my-web-worker :ws-port 7733
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :my-web-worker :ws-port 7733
 ----
 
 Now you also need to configure your builds to tell them what port they should connect to.
@@ -593,7 +593,7 @@ Then modify the resulting deps.edn to add the FlowStorm alias like this :
 {...
  :aliases {:dev {:classpath-overrides {org.clojure/clojure nil} ;; for disabling the official compiler
                  :extra-deps {com.github.flow-storm/clojure {:mvn/version "1.12.0-9"}
-                              com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}
+                              com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}
                  :jvm-opts ["-Dclojure.storm.instrumentOnlyPrefixes=user"]}}}
 ----
 
@@ -1725,7 +1725,7 @@ After the tunnel is established, you can run you debugger UI like this :
 
 [,bash]
 ----
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}' -X flow-storm.debugger.main/start-debugger :port 9000
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}' -X flow-storm.debugger.main/start-debugger :port 9000
 ----
 
 and that is it.
@@ -1734,7 +1734,7 @@ If you need to connect the debugger to a remote process without a ssh tunnel or
 
 [,bash]
 ----
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}' -X flow-storm.debugger.main/start-debugger :port NREPL-PORT :runtime-host '"YOUR-APP-BOX-IP-ADDRESS"' :debugger-host '"YOUR-BOX-IP-ADDRESS"' :ws-port WS-SERVER-PORT
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}' -X flow-storm.debugger.main/start-debugger :port NREPL-PORT :runtime-host '"YOUR-APP-BOX-IP-ADDRESS"' :debugger-host '"YOUR-BOX-IP-ADDRESS"' :ws-port WS-SERVER-PORT
 ----
 
 == Docker
@@ -2227,7 +2227,7 @@ can start a debugger and connect to it by running :
 
 [,bash]
 ----
-clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.0"}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :your-app-build-id :debugger-host '"YOUR_DEV_MACHINE_IP"'
+clj -Sforce -Sdeps '{:deps {com.github.flow-storm/flow-storm-dbg {:mvn/version "4.2.1"}}}' -X flow-storm.debugger.main/start-debugger :port 9000 :repl-type :shadow :build-id :your-app-build-id :debugger-host '"YOUR_DEV_MACHINE_IP"'
 ----
 
 You also need to make it possible for the device to connect back to the debugger on port 7722. You can accomplish this by running :