release 0.2.8

bhauman · Jun 6, 2020 · 178f58e · 178f58e
1 parent 4ec76d6
commit 178f58e
Show file tree

Hide file tree

Showing 21 changed files with 93 additions and 44 deletions.
diff --git a/CHANGES.md b/CHANGES.md
@@ -1,5 +1,30 @@
+# 0.2.8 Bug fix and build cleaning
+
+Fixed a major bug introduced in 0.2.7 that caused extra-mains to
+overwrite the builds :output-to. 
+
+Also added the `:clean-outputs` Figwheel option that will clean the
+compiler's output targets before compiling and starting the build.
+
+Also added the `--clean` command line option that does the same thing.
+
+Here are some examples of using the `--clean` CLI option:
+
+```
+# this cleans before building
+clojure -m figwheel.main --clean -b dev -r
+
+# this cleans all the builds
+clojure -m figwheel.main --clean
+
+# this only cleans the dev build
+clojure -m figwheel.main --clean dev
+```
+
 # 0.2.7 Further NPM support
 
+> This version has a serious bug when using auto-testing or extra-mains. Please use 0.2.8
+
 Pushed `:bundle` target support forward a bit further.
 
 * added `:bundle-freq` figwheel-option with `:once`, `:always` and `:smart` which bundles when `output-to` or `npm_deps.js` changes

diff --git a/README.md b/README.md
@@ -200,7 +200,7 @@ On Mac OSX with brew:
 Now launch a ClojureScript REPL with:
 
 ```
-clj -Sdeps "{:deps {com.bhauman/figwheel-main {:mvn/version \"0.2.7\"}}}}"  -m figwheel.main
+clj -Sdeps "{:deps {com.bhauman/figwheel-main {:mvn/version \"0.2.8\"}}}}"  -m figwheel.main
 ```
 
 This will first compile browser REPL code to a temp directory, and
@@ -224,7 +224,7 @@ available. So, you can get Rebel Readline behavior by simply adding it
 to your dependencies.
 
 ```
-clojure -Sdeps "{:deps {com.bhauman/figwheel-main {:mvn/version \"0.2.7\"} com.bhauman/rebel-readline-cljs {:mvn/version \"0.1.4\"}}}}"  -m figwheel.main
+clojure -Sdeps "{:deps {com.bhauman/figwheel-main {:mvn/version \"0.2.8\"} com.bhauman/rebel-readline-cljs {:mvn/version \"0.1.4\"}}}}"  -m figwheel.main
 ```
 
 As of right now using Rebel readline does create some startup overhead
@@ -245,7 +245,7 @@ directory of your project.
 Ensure your `deps.edn` file has the `figwheel.main` dependencies:
 
 ```clojure
-{:deps {com.bhauman/figwheel-main {:mvn/version "0.2.7"}
+{:deps {com.bhauman/figwheel-main {:mvn/version "0.2.8"}
         com.bhauman/rebel-readline-cljs {:mvn/version "0.1.4"}}
  ;; setup some development paths
  :paths ["src" "target" "resources"]
@@ -311,7 +311,7 @@ directory of your project.
 Ensure your `project.clj` file has `figwheel.main` dependencies:
 
 ```clojure
-:dependencies [[com.bhauman/figwheel-main "0.2.7"]
+:dependencies [[com.bhauman/figwheel-main "0.2.8"]
                [com.bhauman/rebel-readline-cljs "0.1.4"]]
  ;; setup target as a resource path
 :resource-paths ["target" "resources"]
@@ -449,7 +449,7 @@ ClojureScript searches for source files on the Classpath. When you add
 a `re-frame` dependency like so:
 
 ```clojure
-{:deps {com.bhauman/figwheel-main {:mvn/version "0.2.7"}
+{:deps {com.bhauman/figwheel-main {:mvn/version "0.2.8"}
         com.bhauman/rebel-readline-cljs {:mvn/version "0.1.4"}
         ;; adding re-frame
         re-frame {:mvn/version "1.10.5"}}

diff --git a/deps.edn b/deps.edn
@@ -4,8 +4,8 @@
         ;; DEV for now its easier to use cider with top level deps
         ;; com.bhauman/figwheel-core {:local/root "/Users/bhauman/workspace/figwheel/figwheel-core"}
         ;; com.bhauman/figwheel-repl {:local/root "/Users/bhauman/workspace/figwheel/figwheel-repl"}
-        com.bhauman/figwheel-repl {:mvn/version "0.2.8-SNAPSHOT"}
-        com.bhauman/figwheel-core {:mvn/version "0.2.8-SNAPSHOT"}
+        com.bhauman/figwheel-repl {:mvn/version "0.2.8"}
+        com.bhauman/figwheel-core {:mvn/version "0.2.8"}
 
         ;; server
         ring {:mvn/version "1.7.1"}

diff --git a/doc/figwheel-main-options.md b/doc/figwheel-main-options.md
@@ -632,6 +632,18 @@ Default value is nil
 
     :auto-bundle :webpack
 
+## :clean-outputs
+
+Takes a boolean value that if true indicates that
+figwheel.main should clean the output artifacts of the compile BEFORE
+building or compiling. I.E. :output-to, :output-dir,
+and :final-output-to all be deleted along with any extra-main, and
+auto-testing files.
+
+Default value is nil
+
+    :clean-outputs true
+
 # Rarely used options
 
 ## :open-url-wait-ms

diff --git a/docs/README.md b/docs/README.md
@@ -200,7 +200,7 @@ On Mac OSX with brew:
 Now launch a ClojureScript REPL with:
 
 ```
-clj -Sdeps "{:deps {com.bhauman/figwheel-main {:mvn/version \"0.2.7\"}}}}"  -m figwheel.main
+clj -Sdeps "{:deps {com.bhauman/figwheel-main {:mvn/version \"0.2.8\"}}}}"  -m figwheel.main
 ```
 
 This will first compile browser REPL code to a temp directory, and
@@ -224,7 +224,7 @@ available. So, you can get Rebel Readline behavior by simply adding it
 to your dependencies.
 
 ```
-clojure -Sdeps "{:deps {com.bhauman/figwheel-main {:mvn/version \"0.2.7\"} com.bhauman/rebel-readline-cljs {:mvn/version \"0.1.4\"}}}}"  -m figwheel.main
+clojure -Sdeps "{:deps {com.bhauman/figwheel-main {:mvn/version \"0.2.8\"} com.bhauman/rebel-readline-cljs {:mvn/version \"0.1.4\"}}}}"  -m figwheel.main
 ```
 
 As of right now using Rebel readline does create some startup overhead
@@ -245,7 +245,7 @@ directory of your project.
 Ensure your `deps.edn` file has the `figwheel.main` dependencies:
 
 ```clojure
-{:deps {com.bhauman/figwheel-main {:mvn/version "0.2.7"}
+{:deps {com.bhauman/figwheel-main {:mvn/version "0.2.8"}
         com.bhauman/rebel-readline-cljs {:mvn/version "0.1.4"}}
  ;; setup some development paths
  :paths ["src" "target" "resources"]
@@ -311,7 +311,7 @@ directory of your project.
 Ensure your `project.clj` file has `figwheel.main` dependencies:
 
 ```clojure
-:dependencies [[com.bhauman/figwheel-main "0.2.7"]
+:dependencies [[com.bhauman/figwheel-main "0.2.8"]
                [com.bhauman/rebel-readline-cljs "0.1.4"]]
  ;; setup target as a resource path
 :resource-paths ["target" "resources"]
@@ -449,7 +449,7 @@ ClojureScript searches for source files on the Classpath. When you add
 a `re-frame` dependency like so:
 
 ```clojure
-{:deps {com.bhauman/figwheel-main {:mvn/version "0.2.7"}
+{:deps {com.bhauman/figwheel-main {:mvn/version "0.2.8"}
         com.bhauman/rebel-readline-cljs {:mvn/version "0.1.4"}
         ;; adding re-frame
         re-frame {:mvn/version "1.10.5"}}

diff --git a/docs/assets/compiled/js/main.js b/docs/assets/compiled/js/main.js
diff --git a/docs/config-options.md b/docs/config-options.md
@@ -632,6 +632,18 @@ Default value is nil
 
     :auto-bundle :webpack
 
+## :clean-outputs
+
+Takes a boolean value that if true indicates that
+figwheel.main should clean the output artifacts of the compile BEFORE
+building or compiling. I.E. :output-to, :output-dir,
+and :final-output-to all be deleted along with any extra-main, and
+auto-testing files.
+
+Default value is nil
+
+    :clean-outputs true
+
 # Rarely used options
 
 ## :open-url-wait-ms

diff --git a/docs/docs/classpaths.md b/docs/docs/classpaths.md
@@ -147,7 +147,7 @@ Let's add the `cljs-src` path to our classpath with CLI Tools. In your
 ```clojure
 {:deps {org.clojure/clojure {:mvn/version "1.9.0"}
         org.clojure/clojurescript {:mvn/version "1.10.773"}
-        com.bhauman/figwheel-main {:mvn/version "0.2.7"}
+        com.bhauman/figwheel-main {:mvn/version "0.2.8"}
         com.bhauman/rebel-readline-cljs {:mvn/version "0.1.4"}}
  :aliases {:fig {:main-opts ["-m" "figwheel.main"]}}
  ;; define paths here
@@ -256,7 +256,7 @@ Edit `deps.edn`:
 ```clojure
 {:deps {org.clojure/clojure {:mvn/version "1.9.0"}
         org.clojure/clojurescript {:mvn/version "1.10.773"}
-        com.bhauman/figwheel-main {:mvn/version "0.2.7"}
+        com.bhauman/figwheel-main {:mvn/version "0.2.8"}
         com.bhauman/rebel-readline-cljs {:mvn/version "0.1.4"}
  :aliases {:fig {:main-opts ["-m" "figwheel.main"]}
  ;; add "resources" path here
@@ -383,7 +383,7 @@ This is just a simple matter as we just need to add `"target"` to the
 ```clojure
 {:deps {org.clojure/clojure {:mvn/version "1.9.0"}
         org.clojure/clojurescript {:mvn/version "1.10.773"}
-        com.bhauman/figwheel-main {:mvn/version "0.2.7"}
+        com.bhauman/figwheel-main {:mvn/version "0.2.8"}
         com.bhauman/rebel-readline-cljs {:mvn/version "0.1.4"}
  :aliases {:fig {:main-opts ["-m" "figwheel.main"]}
  ;; add "target" path here

diff --git a/docs/docs/code_splitting.md b/docs/docs/code_splitting.md
@@ -53,7 +53,7 @@ touch deps.edn
 Edit this script to look like the following:
 
 ```clojure
-{:deps {com.bhauman/figwheel-main {:mvn/version "0.2.7"}}
+{:deps {com.bhauman/figwheel-main {:mvn/version "0.2.8"}}
  :paths ["src" "resources" "target"]}
 ```