Skip to content

Reporting Bootstrap Issues

Mike Fikes edited this page Feb 1, 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 one of the REPLs that come with the compiler tree. Here is an example exercising the cljs.js/eval-str API by simply issuing a couple forms in the REPL:

$ script/bootstrap 
$ script/noderepljs 
ClojureScript Node.js REPL server listening on 57389
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} identity)
{:ns cljs.user, :value 3}

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