Skip to content

Reporting Bootstrap Issues

Mike Fikes edited this page Mar 31, 2016 · 12 revisions

Ticket Entry

Please enter issues with self-hosted / bootstrapped ClojureScript

  • marked as having Minor priority
  • title prefixed with "Self-host: "
  • marked with bootstrap label

Minimal Repro

Do not rely on downstream bootstrapped environments to report or demonstrate issues.

Reproduction steps generally need to involve minimal code that exercises cljs.js, demonstrating the issue.

Oftentimes, it may be possible to do this with a couple of lines in a REPL. Here is an example exercising the cljs.js/eval-str API by simply issuing a couple forms in the shipping Nashorn REPL:

$ java -jar cljs.jar -m cljs.repl.nashorn
To quit, type: :cljs/quit
cljs.user=> (require 'cljs.js)
nil
cljs.user=> (cljs.js/eval-str (cljs.js/empty-state) 
  "(+ 1 2)" nil {:eval cljs.js/js-eval :context :expr} identity)
{:ns cljs.user, :value 3}

(Note: If you have Node installed, you can do the same by replacing cljs.repl.nashorn with cljs.repl.node in the above.)

For more complex situations, reproduction could involve additional code, or even a new self-host unit test that exhibits the problem. Information on the bootstrapped unit tests is here.

Clone this wiki locally