From eb3fc838a0828898410d8c5d61db3e0b05dba811 Mon Sep 17 00:00:00 2001 From: <> Date: Wed, 17 Apr 2024 08:06:10 +0000 Subject: [PATCH] [skip ci] --- 404.html | 57 +- api/index.html | 57 +- assets/images/social/inspector.png | Bin 0 -> 50364 bytes async-out/index.html | 57 +- babashka/index.html | 57 +- clj-java-decompiler/index.html | 57 +- clojure-lsp/index.html | 57 +- clojuredart/index.html | 57 +- clojuredocs/index.html | 85 +- commands-top10/index.html | 57 +- connect-sequences/index.html | 83 +- connect/index.html | 57 +- contribute/index.html | 57 +- custom-commands/index.html | 83 +- customizing-jack-in-and-connect/index.html | 57 +- customizing/index.html | 57 +- debugger/index.html | 59 +- emacs-keybindings/index.html | 57 +- eval-tips/index.html | 57 +- evaluation/index.html | 57 +- fiddle-files/index.html | 85 +- finding-commands/index.html | 57 +- formatting/index.html | 57 +- get-started-with-clojure/index.html | 57 +- getting-started/index.html | 57 +- hiccup/index.html | 57 +- images/inspector/inspector-view.png | Bin 0 -> 249872 bytes index.html | 57 +- inspector/index.html | 2050 ++++++++++++++++++++ jack-in-guide/index.html | 57 +- joyride/index.html | 57 +- krell/index.html | 57 +- linting/index.html | 59 +- live-share/index.html | 57 +- luminus/index.html | 57 +- merch/index.html | 57 +- namespace-form-auto-creation/index.html | 59 +- nbb/index.html | 57 +- notebooks/index.html | 83 +- nrepl_and_cider-nrepl/index.html | 57 +- output/index.html | 218 ++- paredit/index.html | 213 +- parinfer/index.html | 57 +- polylith/index.html | 57 +- pprint/index.html | 57 +- quirks/index.html | 57 +- re-frame-template/index.html | 57 +- rebl/index.html | 57 +- refactoring/index.html | 83 +- remote-development/index.html | 57 +- repl-window/index.html | 317 +-- reveal/index.html | 57 +- rich-comments/index.html | 309 +-- search/search_index.json | 2 +- shadow-cljs/index.html | 57 +- sitemap.xml | 125 +- sitemap.xml.gz | Bin 678 -> 685 bytes sponsors/index.html | 57 +- syntax-highlighting/index.html | 57 +- tao/index.html | 57 +- test-runner/index.html | 59 +- try-first/index.html | 57 +- vim/index.html | 57 +- when-clauses/index.html | 57 +- why-calva/index.html | 57 +- workspace-layouts/index.html | 57 +- wsl/index.html | 57 +- 67 files changed, 5082 insertions(+), 1569 deletions(-) create mode 100644 assets/images/social/inspector.png create mode 100644 images/inspector/inspector-view.png create mode 100644 inspector/index.html diff --git a/404.html b/404.html index f56767adc..76ab1d377 100644 --- a/404.html +++ b/404.html @@ -576,11 +576,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -597,11 +597,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -618,11 +618,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -639,11 +639,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -660,11 +660,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -681,11 +681,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -702,11 +702,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -723,11 +723,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -744,11 +744,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -827,6 +827,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/api/index.html b/api/index.html index ff5f2bef1..ee12f49b9 100644 --- a/api/index.html +++ b/api/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/assets/images/social/inspector.png b/assets/images/social/inspector.png new file mode 100644 index 0000000000000000000000000000000000000000..d2bb9c0af72ca245a086b9538ded1dd8f5165500 GIT binary patch literal 50364 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

    vK<8>6~!HTVg#G5U5)A_zDzUB zX?kiIkh>z=4FEa@@F4ZcDmA}5KtAY-J}LCiagQ4c3>TBH@ zEy!QCwDSlUZ5E0Te$k$jUoWRf9YZ)lsLI6)I)1#!+F>$zj|fI|WL*cFFC6|r%aPiQ zEvjU&!V;oFsP%~?+glmD4-ZejTi?v7OW@7q>RXn*_!vhFcMLnCQ24B#nyWODtNn;{^`|F0?saQYQZQ^?$qx%X?OGl5rU)BkuQS6LumTSDUmCX=L$VI zP*J`AiPyNUN=%@k3iEz#f7f;Hc}VR6W|^&e`XewX{CTmEftU>wAUKd# z{U(`y1!&M8tPmnRasSolCTs3PV;n*p3p7iO+=q5hpRv<**J&+7LjjJW9b9DL96k0= zz$qBQ|GpHNUyyuZmf0CZ-Y04RBBF5L{C%ncS)btN^`j5!Y+pf&HPg|MHxKz@A%%hLYG=!`kSFkAO0(YeM-k1kXF@_3$d^Qm zE@tpIq^^J7sf6y4%7g^@wBmh|DHnBW*VCia1KGbH6IYRj)P}x)wEd@Km^5^mcrufg zNMKyx0>P95ZV1eR`uP8{cE+iFXw0D-cm>(#o*Sxg3xXg%X(qA!vV(d9UPNWLS`3_H zKqN;qAxPtWeWpUA_9m?Pu@L$LNn?%=*S7396)vV&(}-sFhtG0N*aiHT;YiW z^s<_pdS^e4)IS#~uEM7yrjZVcYKV`;hg7V<`3g`RqoAXh_RUs5#H#o*T80m5t3N9n zF38b9%7lWVEDuTFkRT~Wwk%q5cr!xCAGBD^nsP@GX!3ya`KDRpf@Bv2`*cp2fVxq2 z+`+-gh?e2p4EcY!43;w=s)iL7PyDac{k=xM0F;K`dVqu)=uX1Wpx;d99cI9{K@1K1 zmyEs_B=WRih${7u2*F`-`4M7^5R4-DBD+^ZRBBPfuiD=G{x@lBHyM4Ls>&Cikc0~J zj`9ohG!K9|L`znAfO)<~%ctf2AQRN2*iPeDAH>Hz#43kOLJ%^;u5pb$_Bw`O{RD*~5{xnu(?7!>z^N3y~g-|80 zTV0@zPMcRPk5YOx9$YKXp|c@($1XtDEg-S0IEK4>U8tTs+*dnA>Ppb9X>ns4@>-}w zY?>G#z;OKRCgS$CGAHd{S)*u*v{=ssD^l{Si6B`25q8da-goc;MEY!ulAx9mpPrrm zP`mlh;t>@{rkoxeo@_si9uw_c~ACMY?xaNpe*;L`O&`RQXa_Y7sv^xdAXLg~USumT zfAmxbg6FV+aRZcSezF_>H_&qspp0wv>12NvI%t?zukS`1g4j^<@DWr@2~5up+&nF_ zrAN+^WEdgd_j}bfBwq(*(=z9~9itT%&|La+n02n76{&KaB+bb*#L$_3grslVdG%g@%6z8Hpp8bAQor8p| z0cbq{ufmxAMMm{lM%1I-+Z0f0-^Lt)>p~?s&75cGu7Wy|4@!ZW!p!#)sD%eiC4+Iu z$YPBQnc6(fP4TP2pE{F;sHNcLcg9q1zi)MRjn<+!@f<>)sjA{J0XfBQVm$!&SO1YA zij|xgC?0pmP%+~hGs>|a9p44F5z+$zC6(pjvaT%-*gx);EMB_Su(KP{#kI}x`7%#T z-GCaZ=sQ9XHv2eDsRI3hGBermnlIE0+myE2-ROMX++1q1_3#TQ9&<%Rm452Ga>HP3 z`H3yk2;u$=H+94eM)NTXYVZKAk z23SG4m}w9>-GISEHU-ceVM;@=E3wIMVjFL>4IK zNQQV=d<{odKm^EEdPgHd9t{N-7O%m?K@@s&LWhGW%WH76K<7RJ1Aq?BhF)@F*@LhT z#6_c1QGGt3Kn9^>zKMw>6vt{RxABHm0o*T=iZQMrmPcZrP#(N-auilD>*U(A>iQ_e zmmsZhv3eo$`PlmPa2*ko*e|W8I!N$`DTNfN5saO!_RX5!F@r^z*%^kWYgXM3-i)QW z)J26CJG8>pf4{<)Ndhkvk(F0!K-?V;#K}*Ws{(zvW=-v~%E69cgV%f2= zUPjFuc1zhFHb_zellVoUovZr~H33nUwG2u4lyhgMqT75;u&1y6-M(cBP=Je1W*k1k z4}SlIhzd9GWYNgmC^`H%>Et@$E0;h!r zw0VIkF#f>^4jEleUghTPxxp^b=;DlrlFhZDpd!k=?r`;wVFR{fa7H+E$~py$+B)}p z;aMMlDxV`l87ND<_p#&96!yxNMs&3(?ufhE>y{*MFhE7xd%D2cB=ji^$kUx4m^2rXGw?qI?nH=FF@2xhqz6MyXv^d*PZo&+FOv zYXO1OJ@9N`vwnQ{?<@#0T^lRMI7|3M=z2%J`+4=2~!uqeXNN4QxDk^tg z_!epKEQvkT42Ao-jYO_O-wPA60icUvnimfZ%i!cO{~eU#at5k=HTNSWJ6zc@`({MJ z4#M8qWyb*y27E22r2Go#@j#TXVNZ=HJZ+BXa!l^{Wx*x@=P%@~h{8n!jXM~{w0B;t z5wBIqKxe3ex)Db=fK*MA!nr0P{Ckd($Q!7E&PjdtaSM5s38>jJlZC-*k?c52nNkvn zdue~fGt06x^7j5NO4Gt_SLx+pm4^FJ0kbeL6yboJE|8GprlQ%55Y z?T;BmUfgci4vy=*NJhV|SOpk+N!X&ceZu;vJshaPR&rByTbN1)P8Cl&wMcrx+${{` z|JDbFv#AFN1{vVJEvhsTOJ(z8e@u(qi(H*XQGTzg%Mt_D zu{Ov7Dh5$X@>ePJRQ!VPJoZ5=;RlSUb~)vrB;W$6xu0sCR@wa9Jkh#;jSv;%tJ`sP%&(agap79t)<%vO$irbHG0oqzC+|0CFh31OSny zB~$Xu@msYaC8fR@iL-r52@s2;$(8oc7{|2T_>%4UXF0NjCx7=Mb=69q^vOOs=#7^4 z5(;&Vl886{Py)_3eW)Nz;HRZ|4LF<9^U+r(Q+4_#Oy2bPUm>GDHW(G&{Z%3ag@D|-eV37w%0H`3V z^3bHo;4Rh$5Ifoqw(aPcCa zYP&jd)pUlu)2lb4_f7{BC2Ntw`{(A5_sRW{*-`-yRdn9@<|AuvDrSs*A@b}Qjx5MY zYLlW0pb_^cLGl?XYLSL&5#d3!5dElCMhQb~X$zd^&7-|~y&Lu$qcNHa21mrYNQ!;j z2=x`nCIPlUc8^HC)~*b`$Tc5?FdrF7W5aL1oHGGSg&m36e?~0?F6Tso647J!hQM}e z`tBo(P2Z)xv0JRbXIxu9R_w+L0?{yRSA6)~r%I6|YfisXb?S_em2XG-xE~dRgyi6L!kQhoH6dy ziTXb`gzS2xv*Okj6dkKh_R5r%<`IpsVyo|AGWPYn&v#ZFG6F&JkLK|Eu{lp`e?!yVF2Q;IsDHsfj1L4W+--pqk=0A=p10hLIme z+y-Iw!x2v5upiPE`q6TXV29uEzqpEIJdi&Pj#oFG4@5v0R)g`DROF0{-)nmj?9UvF z)5-(AcU+gSfPj8U(9O~%0WsNEZtV(BSN@jN4&?eb!^AUGVaRg@cmxM+yxz)UREyum za+V_V<~4G#KO^nipaBEI3R(req98}P=JAD8V_;?~1OP0;2WYuLfM`JM@zc_oLr^+u zdqC=vb@mjrV%x{JB=n&GmiiBWzKbMcm;?siWU_-^i@5l`0HdH3R=MU1x2H8{$Xr%B zucRFzjGdqQrdBnUz`@EcDmx%I6Hsx@^TJ_FlYe?p6{30rz#>^O*bSa@AEuZ*wO|S| zv7Sdsm1WN)5kKi5bovs~q&2?{A<+a3G90iRV=ETxopd}FN6IXBJca-8WYglap_Kk^ z75nq$%CXt>eY^3TR6Ncso4nBD5J*@w5Y}0S#xC&()aOrsJK4{Za7B_xY3J1<#e&f{ z5b<}YPcAnN-!L5LMRtT*Hu>dp3l0bw&yt}jRO3!a%6#Rsxgq~fCG5_}E!Ty1?m@39 z5Ios#Xv+B9nPF>Rw*9llUWK4WYOtZ%VIaBcga)i~z#_P(wl|S=r4?i0p7R5b_t9SX z713~bUWfdJwCM3r3YS{|M`$2sp=(!vlK)UFLhI`>ZYavTrSD#*;}}X9m30}vW-Qp+ ze(;(Gj%jY(6xjBe4`oJIWSQ(~y$8hKeXI3@TSCVn`LTCPL>e^jI${eSitO49C%t{1 z>@{8qhC$0vK2@BJ-`?qSLm1&`!xz@5%dbZpD{M3sT3h)mpo!W2>wNF@Cz%gJkWQy! z=%dr71P%9)ZOTeEN2152r?ftgt7%!AsRE_(;Berr0kn@ph6Qim5E%Gg_u4jYA|6SJ zpqd#FDMENg*3xg7|6i37uBfkaeVgL9@cnSvPybXuIJ}M;)aKESYJ}pX1<~nz7SxxD zbe?M1U13Y`@+MyH+SOjZ{~`NBesNYc)V#WjoFaPBFM$6C?j};pqO{9cpBxgaQ`^8G zf&*k-#aNu5A8;Z)BZ=+$^)*~$N6CpRBHjS9vsI#@fKCf6AxO=M_IhR{xqc`X+n~Fxm6zIx*l7_6lk1(r0lV zyAKM!!u1!71XH_IeokjuOdj$ve{clIhO~$S3U6vhz8u;`b8?J!3dz8O_->w;M7cQuqdZATj=*K4f^1qv9sp{sDb2!n=~_so2!X~? zz26$0EN!8Xp$qSP3owQ=bq!)&^P45mYVAy+9>h;gaNHxwZ&I}+Qn~!N`gJ1aIhjitiMYag?yt07z2tT$V{d9{*&Bf2ugXC_pOw4EK zS=ni|Gg{Z%cW2tJAtOawPgwk5`Nir;ee&zK2_sq*+zL@~r0>|eZ*bw%F&*MVRB|)o zhT_hkMuEu(l7X+_t*z^ikWuz3*GaMU z5YnA|=eo$l!8XC*__kPXy6C|^=mxYUfxUHcN=6U&2-^uK8?vwA8PWVT=5eqJ0g! zB4uA|7CN1bfjUw^wV7=_Ith(G86y3-06!Sj;Au|};%Q7fFq0|EYFg8}i19Vd%h{77 zYZb69Xm3Nl3}_!HkvR@XWzD2N5*bt34EI6E^zJo{XuN>Z5_)eTL9`o|-fK3mmvE6` zp5HhyOTL)IV7#j^NDQsZQy=r!2tjhnX)!M`dS;SV^Jg-bvx%q5N$G>igr_u+p z{u)Z5Kxhg=Tx(Tz!xH4Km9_v$+$XtLpc|2C`X&AoSTeJ&f8vLb%b{=&l?PcOI-u2??(8HineJ1JZLCg;FXAZHCLY~v?@JA}F`K<4T5x`n zxa|CAuFA3f5>^ek0SY^?SpZ;x zW^iB+_FfP;k897B!T-AFMNG=OGSy43fS*UQ$!q_iTB{6Sjt8qzOVm9jKp!=_!@l-k z=dmCF?x8DS?Rlx|EC#?U&}}nbIZ{JnR58-CgQ16}A|vi0*fd3J zczCw(_TdMFh{%qn{IQLKaz$hTb!{Jm-h{=1^Bi`?_TzIU9iqM*6+0#?fPYiO+ zV<$GQ6;B-+MC3>Qtg43D=Y?q*@4SIr|Ix1Nk}wWEG9kLY{}=Mxc;Z3ON{g$l=5bub zU-tumhOoy@0-IT~~Q2w5MI)rSO3LHKz zkm3TMi;ppplbW;yF%hXYhV}E68H;PkxB@_SudaZ(6joMhM+6CIPg<5z+CVAc@ZC%6 zbxSLw5l=DIizM>M~A=Xe>~IF{es!}5w+8V^Ua@|AZB}6?G2!`&`*B#r;1<@n>Gd^j!1{d%f&Mts3!?8?;H!;nc1DT8A@x;B<*yyQ4 zm5M%e$qa}Cupl=-JN=I9Z!B>EJvf5(e!@EQix<8$3Lfk{**Dn?Y$U40CX5g;Cw^T~ zQDugUU7(QXAMZl@GDyu4bVWHLl7OAd02=7yr+8?!qmkfnTU10gnw# zg5a1FGNlgMzQhW-y-4W`WQq7gcaaHhbpVQQ0BOP-O(XZ6dsF7~TcKdsv4h4qRV!uJ zd5Cp9-sYz^BRk?=EZcw+KZ+_xHiiQ4k^K?m9wg{76n*0YGuu%)!+-k~l;t}MURDwQ z#eogr(tx*|0Wlj%o}_i!4c)(H=)wIT?et2; zCtoK~I{JB^C>Y1s%N51All^LfxauJyVL~!kt6`J5QuY|RSTNzi0bB#w)$qR8`+0sk z2v`D_)f?#lVilSTrpQX@JXgu1R?b~ch^)<*_%W$;Nm_?W2on!-XA+#=tc&}?_5#2l zaM2{(I&nT3vlicns=wHgb3ma3fThV!j(Gp(Y9|;i9_2TV)}>%9?=HZUcfjEbIWpr2GOY{VaSZ376z=G8xDjJo9QTGm ziizyJ4A$$9XET&W&@jAdFrwnvuBXV+_eqT3^46`FoJ10rSU1N=}Pf@I5j zHY;A;=dpRUEY8QWiB>@7%x48G_tM7#s{Zwx;pF_#`H&MVO_k}~X)*2ae?ki!o(;vRoridDLjsV(>0K zXjqGtks#-{s0wvkSjl0#p)kY_mWHZOi`JY}wgh5wYxqK1)-h$*Usi1+ABedjPrZt()32_L;q^XM&xw3lrih$`+vyDMZ{2jPS@AEA#2=Y?;IKxWSDk2G+`7YvcY&0iljdo5O0=UtyH3N?lye5^#F_Z zda=qkUBLZK3oCVxf1<(+rVbdk)(1ux~~Zy8Ky|r@O1p5VD~Zhmo*VDk999D!2H@jgDic z%q@=Wjy=r~A6EVp8R=iq)rhb*fdh=-Vl5Tt=%w+fK=cF87<%99Rv5nD1Mw%in@S6;n9Lk$;5(T1gpXFX}hV$^X+Ha`#q?vQ^r*|D1$l&VL?N3 zEDQn-jE;`^akz!WN_Q;@6QJdkl|^1J^aHkhrZ$!i{_M<9HHehCU=sIlp(~_9rn!jj z43FM?pHU6|C^p8UOUVa0PR+mzRV6?w6Qba^Nc1>#K?9|4$wYxt#_``;5_(5S?ESc~ z*{nyKW5ILVyvT@I*R2UITfroH_s*C)=nj50^JM|v?s@(yj=Sv+AHPm6@CRaVTeKbQ z@6(6P+O7Y1(ewc&gUs?F1~wKEoyt?r+#!Tptnkb3leV=m$MRB>u?@}bvs2#>Li4eF zJ%WoLr#~*bR1Z}yj^+)s>$>LNt}h80S)JS$S3473?UbBG^Eiz5?ZH(L&QQF$HD-uSdkroCUAp={m$V+#+dKh^fODF*kAAO{{Z9pa0R zJS_FLzZwk3Z*!>XZC{Ggvy*B)DM=Ooe1FzqV(8_3fn|qz!ft99(PNt4@NNEdlIg_l z_qOw_(`o(bu}-9}xmPRKx)59_>Y8;3>)&5rx7{n@6UwPSFxu(Sd%s<8>v<>i_3@#} z`P}EOWyST-r1qsYLYrBxp^2^R5P!{gpU&%g%mnWotHgJYn4+K%-nbOqvbW(bXG;8p z_lJ&N6ng{f?EaUo8bWJNq1pXU#!N~ML;5-A1s6}wt1L`jR=4R*Er%CAk3!g-maR-5 z^`r@}Y-~m6Y%KIVS(1)y^xh|pse(V4oPK@PwefUbm9pFU-sHDf-&qacNH#BJ`e2*y2oW{o*Ial-blD5XPmE8|$Bv%1U8Np#5uA0n zeSURlYHJzm4P8Nr>(HcKLkCBlK>ROhCAIrC1BuVGI6F6%rjF?mpHK8v?p@?4iU`CH zXzU__00lC!cCh_^SW+z z&(!0ZdWQJP@NHrGc3mDRo{_VJ@8WXd+*b%U`O?KdKQR@gi63C~Z_p{&k*vyHlyhF7 zGJBqYus#ma0y*hjw7Pna9!8PeYaJVG32-WCC@AO>QT^H2IeX5v%9gD>q)HiG`C|0- z;azi@Nn$ZZef8~B%hvRg?7d&(DkXCa65Y3-=GACQ(ow}X)B6{y6qNYQedb-9NnYPR zzt$Fb>nB_OK*)H*C-EZL;tgf4*=Ow=k(2XLrJuDD;yv?z_H{K6^HHv7P``e%uGTIw zVpf}I)=I-OafY+Mah&hdR>3m$Qp5S=f<*iXRVV%woi#g{>+c(r@9IV@q$#EV}GAWx1I1|v>8Rm>$ zAz3U-5KW9b%BkA0aagD-e9Q0ll%_Xj>V6_Lu4k&r)KFdBP(E5YWVW}=rLnpawPf?; zJi^kcV}m&&w^nh=FMWrHt&6GlCgJnRLi5Gq7ctlgKZI>XV<+WjelBiw4J-yPwn4eI7iu!&an81ob`3@wiTCQO2{~~wB7Gc)#3#`)x0Wot{Ysxo{c6< z5u|1H~N(V*5hQLc$Yx3(3PjaefHWFPGJbbMy~JYR+~*sbf(O>6x$gUJr9aZL z4@m0M%}-|7hS~9HQz}U6`8F^ju48AfAK7%sePzftm|dMd^!buG^t{ip1^@;LPW4wj=7qKda|IIrW9*xI{~Y5|$OS#0x*vEBB4d^k9WR zTr^+A_Ai&vT3vBiSiVx?s+8&0$w|1%r}|0>hlIcQQQ$+frbA`hjO@hqhS)(}g+qQd zOz%fzLp8g_KAUX;eq4HOs&@ytbmKB)Mi!D->`%*mHfZf!3y(9lH69I{?F+v)+uv{% zONc*Dy3A<$K_w%*8%N{;r`NT(Kl5>p;8OG((!O`D`WIGetFB}*COm1QKRvaRT&PHK z<#q-biVFx3E_iv zTApnuMY+%g4*eG)jPW+(tGAssz0o-3H-s}^kh4Y>s9z|1)FiR|I3Q@^Nbo$}CGBxF zDHV`RxN*+jd~fLB^gcGPwn^FgyKce5eQB)eyFz<)+hyH?yQ-w&?G~9Kwn5fA6;gW;W@F@TZ5v`pbJZ4KN78*DAS1O=&U`$=~M8 zHwdR`EN*|SAcDD}+;H?7^@`rG@#)o%nEP30htp~&l=ZaS6kX4?ixZU*9=|AwV1H0v z?nZtEv&8eD@6O_qKdNVmO>&Hy58+2}XPL(g2e=fc0`|o4-E+>6lnoO9^{3OQcl(V1B*%7eEIyId*VrAqC>rg?olyEw%F>j_v zit`aJbIMomH|TA7$X7jgM~-jdJJ=~LvD*QzPQuY2t%V=KD!9|*8Sf*d-{pD{K758a zD(uOEMI%bjy+((KyL3v8AHHp4)BcL*`iP51Y6~pa=f5sgVY^eUKdwXL{ykSo=68KV zd6TRs%Vvat%P`i-=9WBMuolHp8B5{sS3wK9;kySnnyekpwi&P99&lN-<#eGXJ4IzOZ1>x(P0`ChWe(6*! z54^F>a`uYv7Cccsic`xz?RRR|6}n$I{9E2ddrD$BC}S1*?5k)R<1QZ`2IWut%_}R__tJkj1dPH|PnGB6?6OEhKO*yZ!R=@}|gE zM2Gq`ZG1D&%=)NM%g!LXaqrBfl-Y6n9G93N&RR8kS!>wZUVK@N+YUgzGLmaHZbK-t zn8DjO9e%AeyxW!eQ za8)?neEiuPZO13eZ^BDIsZIIO+o^X)m*(lgtsI^79M#nu{b(I4DP}6jK--@yUZlM} zH4x;Opi;J;Ok;*CCr!cu`*wXS>s)rt(~S;IJ3{r&8TRn5nds+VO02LUSKPTu6!0K=nxE-#$Hn??)W5pjl*kaH|Px!o+C@&NQU|13yE<&W_QGs zsn+PYFqoOQ&v%R`^L3fj=h^szb4{E`+81ow<-Qt=qXiu%D3;BBpka3-7w^^{OvRG(WonrDY)ZvX$k6`A$B|{P4JqwdEQINOqrwR$_z{jqQ$Qsj)hbI$s zX3_~CTU1M`+)MD}s^8UmVlq!nr#S0dlz5m=W}1(uFeivN?__KvM=F8nD-4uBFIgje zr@!wsZe1e&`;ILX1^e&2XvzQj94+)NM8007UpKh)=UrnzX3?KFC*{e}WSx$%Vm33%V z&E0#P=GgL;e{M09H*7UzRzG-n)q&uf&ZNM(;?!|V&_}-Hfwvx>Il;qWh~-+ZnISH;_H)hG0A)H+HMeqb-nz@5DC(`?M+uv14 zuAtnJe<6J7RkqZted76?kLhD%!t`d+>qR5$8#I96bm$7Hr_0)?F1BvwUUbD|WJNwm z`kZT;dtOi|9Wmy0VTFNf_3_sY`NYZ{wsLeW6GG|cyf(P?F{@PcD~+H~UR)fz_|qfVt5b`BsQq%SPD;*#kvYRF%RVxvoBEzSaG^r-mo^d*EV+n$&1L% z(~B6a+P*^jC08`iptAb>H-U7!^_v##X<MXLtc)m_p6$)dAqRzen-aejunXi2+Mi^dFw z*(PM0E>F9E#XVb9*FU+d3jay>wuyTaTem%IB(5$-(~;dB70Bpx6BkM_yLdueneTys&A^RFiS;jKiV;W-_ zOM}4_Vi?ak`u?8fc>etT_Z-h39Y@D8)66xW>%7k8^?rXoeR%0nugm{CNC;=g5Tp*T zwaJim3Y;1**@m}K;(-C+XtA5Z@S()h00GI*=72jRUZHAgA-lSlKEPBLaq^nG5)T&}7605;pXt4#<_xov^dg3*8ObwAmiFMd8LH|Bx zlh^oFAv+#*hv=q`qehZNTuG+%Qewv_)~-n_H^C*UT4D37(>Y4MMMmO`#>twT=~*9o3(_-P)tw6l zCgl|G$-j<9g?9K%FBrF&sa?h%RxP(#=L~zwij9Kj`>Zbod-9hK^5yz4Hm~ip#0`+H zd*9`1LDrmyS!4g?3=6dq-y6ml z2V7BLycFq-W$egF2)Lh6yMmr+)PEc}gZwKN(>YZ7SFC4~R&h=A{P=en8r@|-U3j4U zj%vd3o-1wU2}KWFYa4=X1h-29+qM}0g2kr2>7a4DxJ~3+NFro2E(G-iy>Ots32)0z z!DiyiFa_AGim-1+gU@RW&(6ChO!Y zrUo|6S0FngZd0mn1M?O=L@2tZ&4`&PyC6MhCGCDPNjVvD%=9e;4sr4t!P{W8)5Ktu zFjysS=uenZl0P(9Uh*b^%8C{qh!*|oUq%Tgrfc%0ksf61wy(exBA z^RVgT&8eb2`8_~Iy6en~mI+AF9;QDbZ$8|PlfATUw9pW!g`sQLlIuV_@=Ky`UlG%H zoYwp-=&))XO3UqZ9HujoLs6)^p<|?>qp3;}w<@idjW=fE+P#F{SfR^kg_PW6;hrmR zr^-SgPEod!lAcSvF@<%PL9PI8DkOvNat~XEMeVfm7lvtH$@mQ|A{)XZWWB^F_ZL>h z+O5*i`^)ab4l0?zaPQ1a7*wp680S%Q*>$iPP9eP?=I(q^j=<9-P+i~KQ1F0zS7Qa- za6ecFWa7F@85+Cjn5Ld0}n&9vn_O2&*ZVuN9>-@Jy=+vorQST)LU zJ%Yk3-phJEX@Tq1)!QA&j zO?YPWFbtHoRa@yeADupI^T7)-7lA;A5c&tSh)5($TwP>&xX{2&L6&Q5Vp>z8gk8}qj_^qvTz z6eNhkZ#t?j?u=aO!$=MC0R(b~kIV_+h|OdU8wDj<7;mI(NGM)P-epgyO^DV6V?uxWI$xk4zTAmhue|x} zL(3Xg$lz|BNa~T23s~0f(eORN9d_B;&4=P_Dlgdpg{<|y><(hWGruyIgmR=phz@5S zSyXIru681MS){w#ViZ|p==pO4+o6!YB5Np3#ubEXU<>ag%ntvHD%fy?LXu|V<_)sZ zFoi)qmys${U1~!Nh`8@MROnZFaj-P9sy|3GEoWcZhGuEUkHcfhsNZfL0f#f{^!iZhm}~Eh@b0aDiukUz=u;<>bs##2xsQ*uHtWZd?}zJ=kxedB+6$B>7#8c>OPu>tWPYZB4$@{+{hQ z#9{}HX4#{2#&tvKjzi7gXEf6ZJwby3Cx<2<()~NJdoi7zahkm=t;+X*SPykZI8h6o z|7y7V&wG)_98_I~k3erUkIrrTN(z7Fs7(0hX9c2xkhScaZy;KmYej7-=S~cs$v6p_ z@5aLPkuQX!s!Ox7c8pQ>i1ah}e}p}SgoD7Yy9HZ#`5ucC))4IBUCcwJ77J?oMOrjmIwvf@0OMZ(yJoW2T% z1IS6>nQ%3hPm!8GZ_hDzE>VGUMbyFxojvy|hxX|)CSfn1uT)3k4vel`Q?D0&F=a0= zI<49}ubLi+qdBRm@ayC&`lMgp?6IGlx+(Hz18=PIN|zCT&+ODM?`nPG=}W}qaz}4< zJ4BF%-IUHrD#IFXDwB1xYyKX)vw*b^)0*}d0nXSFfwC>fXE9?(4UX9h=CF7c({qv{cIxLNEv6m;~KgKE*Me zTuMLu+(D>!k?x85Das$$Xq?R&C8DZk92)0TK>=}Y}!CphfyLHcNMJL@|&w#Opj zy9YU;G*EzjZ`x3bi??uAfKu2>dGYddN-DKGyQ^=+wdH8~i|*#kRsWmq zonEIh%0Lv#w-zy)B(bZxelH(J*H$vwbQs@!BCh;o3OW*^-=hkD3^^`^u+tbADaw}( zuhbN+V5M@pe7-@cpc3u1-Rh;Dvw>n+*fXtmW-laU=d{WM5i?_|(*#{pc3Mr!g02ij2Y`AU{DQnbAB zJb5^$K!e%*tmuWvr)OyggdL@wspP8O{EtT;g`IqSS^YqNYiN6h9CvlHN{?~+VXBIf z;YsSng=v12_rz`+w@OM{iBZ?GAe?JZkBqxp26yNC?JssZrX4*ab0FngD(|)`pNQG} z^J!gjDNKE2H1eanaFcSAx{-xJ=cDrhj;S@090* zEb;o~Kkwh!kBq56(-GS|&yVr8vPAMUS6|O&&J{QstnDcekuY0kQ);8yT-r_@rn@0p zUpyU3QkQ_)9sC&XPHQ(@vtv#w9?<$(pubecpQK;a$$75wf{g?%7IU30(x+k-#XD?} z5E}pFvO?s|x~~&rnO+uo%I3@hWko-W)aoF5@9Eh2Cpy@ki-en*)!-{Bx2sp4d^Pjq zo0(lRhI{$!c{cZZ3r$)2^=k*rt=T(A6kc=wG@tD*R+QJT$q6X3Bz3@~ga2nm%+IGjlXBoy z!ZX;A%Pg13)fw0)>r2}c4!l;=azf{-pWC~TLg?|toAqUac_E8gKa2Gge{kFX`jTt! zvfH~c-6l^v>`;1X623_Ka5Wp34hH8AONytRDLuzWqG*jFc5&61W>Cc9+s$=F9W$Xx2E zedVk_(%=)5U#X%LXzE~=`$8X1-O;Y7qFd>0az`PTgUSuL;jJC9k>1;GJlByHM?z*k zZyPTB+EChmXhPii%7(9fMJ}3Zl%b)-d{Rgn-svsooK{gv^y?2{2F|c9ZfCJiRbFDSs_-xBvz4fyGThy|Uu@ep557n! zKVa3m6rZS#hV~=6ep*p7`rd8*;gLlroXhpFo2RPU+d1iq`B>7eSV`xfoxQS$WKd3M z=-RLp$pRi3qGczsvl;9$`hC^)Sg?43`3TZCbmy#=rL6uprbL?fpWK@`>tX+`&h6d4 zpn}HeCBD{`DxY;eTXOc1wPdsDW%aZr|L(|JsmbgE7294q?;pE=Au1MnZvWv8w}DA_ z;syhAT5Rf)jt>;6cbJdLi4ml1tW#L4LniqF{ ziOU@6G8RVEnZTfNg>B@xvif>!#o{&8F)jy^#(NjW;01io93%N-lxXRksvpxP?)ynd z<_LqS;Q2f-b_gL@g-3Cw`(3$M_;5gkjqFgNX2nG-no9G3C5<(-S}J;|mz8%(!&3(2 zoVCh{wuiNKJ0EEZHWa@eDU!ks;=p{Dlt^Quzw9f#!O8&(+y)3ErsgUW-Keo;Zl}^Yq|SaH2tIL~$I5 z@F~(bI?<{q*ez=O<(fBDns>>zL1{ta!_mm>jfo=rkJY7SJ5=5Gq0T-i;!>@1`W7z? zDH;3=ttJnJP_=V}Zu9sxm=^4sf{JT4a4!hGz7eTXm#dYJDOX)wOg(}ySS1dNh7>w} zmW9F;lfRBc7`*%GHJro8uUkNFT^#mRr#9MO6O2kkm>B zLDT8uu;{s)#V7y++WgbD)axS9jL^F}*>>FoE(5K+kQ@hcni4VE#!D1W$gU07nZTKy zYBl_wY||tMhhUo0*=uK5NBsb@wzlMWQk7+U(s&nTZM6pKSNYg|gaNp6ScV32-4t@E zh>B;=sitN{>oSyLTkY%jdOMv-MbBs!xO;t9C_PV(LJv(Y;#Jc(roR5yiHKV>Z*ikq zCq}@D(6|5l<`H0lEOdd$27cI4IsR9SWZjKUtf|ua1ijxP6Wn&Wxq0)*u3Cxi)Lw0? zOFLLi8vGkqFCEloXJM}2k{Z4JrVxNe)>ZdeoMRazu^^K}A+KjYmM3`jOk=DN%aI9O zJPzz)l%y&&r!zyYkG!|99m5<4fDEWbx6?8;n#vv-mzV zLncNFlY@>ap)AC-n#t(_?>V*f!U}+FDe-|Zp$oXNz~*cptBjhU-(ZCmam(2RghGwA zP%jXT;QVME666=COBn1cUX?Mv%@gFEaV?{#S4l5PrJ`6Mm9ugT-6rnIM%Vjy+1+=SV4Z`4ATho2cR@q z%reo?x5o~Q7X4vu8nYj)zbb?Y^Upcf7U~w!Y!M2rw#Z8FfoC$&|E3?;GF@r4^~6s; z5F7G1=iZ}u1KHmMW;iEi0wf-z!lRykCII)Yk+_ZCtvcscjUw@r*H&{W@a0xsG{*_^!ne7el8SgoK4CluoadoDG%{uMNxFgu^IJPM@8_b1^nuUEBY z#-|*Qnf4M3)RH_#5aa{!GUJLT=6Q>fIS%05HdeIvNAS)&Bd419b0L!3Ch56;BU}?D z6VLN7oAW5Y(K4*iWfzq8L^OCyZ>3L~(aj!&W)_`3Bl1Rd)%Maw<)6QHnsaf0sH4)%z>f@nvl{uXKv+eeH&2K zyUxt@7S}S`K*Cg=g6q(I!E~noX&~U?Fs5Hu8^TaWBip8xqkQz72$+j~1MA_*!ezO2 zlg`?XWS|$zpDGN@T19lOlUrT3(!))GoE3@Tf!MX3D)HHjkwF_bm0fCuYC`09oUTU( zS~NW8o)z$qBAr{1Dj3Z`vz%xI@l2{;X$c@b1HIy1yKVVZjTff#=Be_F=YUkNr%+D0_x7pU(3UJ+sb5MpU+4VGmp*)* z>TQ+X>IT35^IlT&!HA8P>2j|14=H*FTH4N~ER)g@3!n;2>`Gr`EC1mU|6Z$;bA0U> zr^UlSz`hjmdslRK^3Nz`eGTPnwRo@XZSWdH-UnCT_=j*so7}j-AW2JBQw{QF!7yJW z{@E@AQA6j(e|NIgCa*FyDlgRSlfEJFP2Ta~Do$LlPD>^72S``fLH2o7?@)%eS;AQz zoI97na*=5)&|6;M|N1CcnCmtkY3Q@)L|2fEA{k4|@fiO8r4G2^VLMF>O29BlPrP@% z`f40WoTY}WbIOi$zz2&hOzO1KvfsR_y7!X+G>ekVx((O zSlrjefo|zTs%v+t4zIt4&NewE;S~y?kL7eA<#cCNKwi=VU-BYTVP|Ar?r=(ER_a)X zc6M4l*qgw`FNk;!Ml|y9ly_G+e?>vNr_KQbnR^}x4n3JAy$Jah@vv2D>2%ZIjYyX|AOUvk?y0;`~O zTHP=?fH+S3Qz>f{Qr7sESU;=t35n# z5^45F+gv#E`OyC~SP>uZo!@7`!DdFp)#u%u z+QXvmw4qh3L+l%cA-nRvb( z3j*Fwt&bHdQ>8nAhcwfy0BS5=(Jg4qKmRUs;xZvXVSY6tIm>-7?{MZa7t^!TW=TOB zNs`*s!9HB8u+XRcs^cK$RgFeN+ix`TRl97HNfczNKRmYOJ(ltn{blm!qWuVzemZr= ziUTaALP?I-J?UkauE~Z!-WkR*;{|3xXq{Va`ROi0o$B8w|2K6kZ6Yd%rU~t!Vb>FP z<)7_4WCb2a5j*dY+;&FR=0aT(0)h&|efO@LAU}iS9-9e2a{RtrT(P$4GCnK_An1hC zO$7l!s%W~rxg-KI-N_`9jKI5};P4j$?)@p>+1Ai}Yn5lz4&F`~?`?$PL22Ke4Ks^q zA(p%VX4G?3WhlZ}2cg5N)h1mLR>gy}vWIRUuz9Yrcb!*j9X)bDFo0VKPQq1e`2n_1 zCa1WW>kBAThGjHCV4#Y@PKt5vJu;R+-<(;B#sna5(yag)%cJCWPFNgPcHjGAu{_u) z^|D)a*(gYNC_=dfJ2AUr(Q+{PI08$Wi-V~aXkzebWc?*9++|~yI1+8Ywes6OCmZlP z{y=F%O8a9DOrE)C8Z2u}O$t<6u3f1#Fi>CD8e)Tam?bGqKt819DmA7)$J>y)fB+e@ z)+B!KWu9d=oY~+Fl7?Nlkl2vRr6Sto9?Y)6So!~xS|3-t6+4)ROe^g85moQd_kLR& zhvCP7L=UE{aKCO$5SIkp%(NdmOdkdbNi`>Oz(W}?x~*YL(*6&u6?HxyU@x9 zoi;Wz!>zvvwx|;=Emo3K=qh&a|AMX9Y75^hSjs(9dB>#Gp`aZkg^pg2tuJd>4cR8a z9;UB1G_bMb@e2nb?T7xyta)5uGp=6sxYgcVZ6y=VqMO1iGIm~%CY;bBpok_+#+!){ zVsuQ#H=J;yAN<1G3<`azM_NWDkhLqNV5XN6%iiPrWcII?|GL6pW>|ox{r#CXPi`8uxJO`;&{#3u)RV*cKLjhq>X%qSH zbsqVM;%q+WO{Bql#|r(h;R6l8$KIwQoz>YszNIB6eHM&*V)3vBp!>%nJo86>6d zLD~}lCfH3i`rYE%9Uo&^LiB_6ym6xJkjB=Pi#PY$p7-)!8H7P?j+Rs;S%XOrj!JVE zJ@Mc{Al~RZ=wDmh%-c>9+jvVHMx2F~$*}U6dnSTXzQ`SAzMydRlO$nC0EhgioE4p` z!Dw3n5g0v{o{LY2=f}Ypa_q_E!|eYP6dM1$-+M~^>jAcbJMz|kN$G+liCn>57%Af9` z1sVk4mA{35C03r5KjjCW@jGpQM~c*Ntl8#cD^4ms@}2&@{BHSAFlVzv#^>(Rr;-)o z6!V<^j&wqFL>R*@IZ8TryQPh57kI#CQFMpVYC{U$%X=jl1$W+w*tvuQ;mcdhq~GZO zxUCK4@)$hCFkrzR%lIW&-4gD3RpEkz3?ZDbH?8E)1v*sgdQZ1}BI^o1uGO zi2TeB4dV`XOxz-aRbIDk>;J@k^Nq~EP(YqsJwiU^+2`0%xuJv2M6zSh+5@3`oJByg z9J27!M;UKqL4k)m6d!Z6#cOMlk}%mLQ5us@q|hsW*Kpn)7KTCX%2l@6)O^2JkX1r} z8-QHuo&}9juBx2$RjIU8-7j3`5`(jJf|&$k4MXrkpWa%-ZN9&6T1^kF%K>6vwJVJ3 zm@^jmDl>+A4Kd_p5*7PF+{EXFpIls<30g`_>9=>~symptt{2_VEJF9E=nt~pe+dNg z6(BjkyPo~T*2^XrMa%OZ4(4O81x3`ydL#g40eZpM9m}6z^9IM - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@

  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/babashka/index.html b/babashka/index.html index d46af75af..04ec896b2 100644 --- a/babashka/index.html +++ b/babashka/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/clj-java-decompiler/index.html b/clj-java-decompiler/index.html index 3396d865c..5370d5c4a 100644 --- a/clj-java-decompiler/index.html +++ b/clj-java-decompiler/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/clojure-lsp/index.html b/clojure-lsp/index.html index 86da146a5..12026886b 100644 --- a/clojure-lsp/index.html +++ b/clojure-lsp/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/clojuredart/index.html b/clojuredart/index.html index e2386adb2..ec3189134 100644 --- a/clojuredart/index.html +++ b/clojuredart/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/clojuredocs/index.html b/clojuredocs/index.html index 0f99c74b5..b53d984cb 100644 --- a/clojuredocs/index.html +++ b/clojuredocs/index.html @@ -16,7 +16,7 @@ - + @@ -615,11 +615,53 @@
  • - + - Rich Comments Support + The REPL Window + + + + +
    • + + + + + + + + + + +
  • + + + + + Evaluation results and outher output + + + + +
    • + + + + + + + + + + +
  • + + + + + Inspect Evaluation Results and more @@ -820,32 +862,11 @@
  • - - - - - The REPL Window - - - - -
    • - - - - - - - - - - -
  • - + - Evaluation results and outher output + Debugger @@ -862,11 +883,11 @@
  • - + - Debugger + Pretty Printing @@ -883,11 +904,11 @@
  • - + - Pretty Printing + Test Runner @@ -904,11 +925,11 @@
  • - + - Test Runner + Rich Comments Support diff --git a/commands-top10/index.html b/commands-top10/index.html index 7f9f5b129..725a11d52 100644 --- a/commands-top10/index.html +++ b/commands-top10/index.html @@ -664,11 +664,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -685,11 +685,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -706,11 +706,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -727,11 +727,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -748,11 +748,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -769,11 +769,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -790,11 +790,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -811,11 +811,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -832,11 +832,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -915,6 +915,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/connect-sequences/index.html b/connect-sequences/index.html index d46c935e8..6ba845ba1 100644 --- a/connect-sequences/index.html +++ b/connect-sequences/index.html @@ -615,11 +615,53 @@
  • - + - Rich Comments Support + The REPL Window + + + + +
    • + + + + + + + + + + +
  • + + + + + Evaluation results and outher output + + + + +
    • + + + + + + + + + + +
  • + + + + + Inspect Evaluation Results and more @@ -928,32 +970,11 @@
  • - - - - - The REPL Window - - - - -
    • - - - - - - - - - - -
  • - + - Evaluation results and outher output + Debugger @@ -970,11 +991,11 @@
  • - + - Debugger + Pretty Printing @@ -991,11 +1012,11 @@
  • - + - Pretty Printing + Test Runner @@ -1012,11 +1033,11 @@
  • - + - Test Runner + Rich Comments Support diff --git a/connect/index.html b/connect/index.html index ea9427bc4..04e10df08 100644 --- a/connect/index.html +++ b/connect/index.html @@ -799,11 +799,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -820,11 +820,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -841,11 +841,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -862,11 +862,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -883,11 +883,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -904,11 +904,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -925,11 +925,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -946,11 +946,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -967,11 +967,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -1050,6 +1050,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/contribute/index.html b/contribute/index.html index 9ee8a4e27..5c34e3665 100644 --- a/contribute/index.html +++ b/contribute/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/custom-commands/index.html b/custom-commands/index.html index c256a9616..c294bac9c 100644 --- a/custom-commands/index.html +++ b/custom-commands/index.html @@ -615,11 +615,53 @@
  • - + - Rich Comments Support + The REPL Window + + + + +
    • + + + + + + + + + + +
  • + + + + + Evaluation results and outher output + + + + +
    • + + + + + + + + + + +
  • + + + + + Inspect Evaluation Results and more @@ -847,32 +889,11 @@
  • - - - - - The REPL Window - - - - -
    • - - - - - - - - - - -
  • - + - Evaluation results and outher output + Debugger @@ -889,11 +910,11 @@
  • - + - Debugger + Pretty Printing @@ -910,11 +931,11 @@
  • - + - Pretty Printing + Test Runner @@ -931,11 +952,11 @@
  • - + - Test Runner + Rich Comments Support diff --git a/customizing-jack-in-and-connect/index.html b/customizing-jack-in-and-connect/index.html index 632df6596..9d4c7f45a 100644 --- a/customizing-jack-in-and-connect/index.html +++ b/customizing-jack-in-and-connect/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/customizing/index.html b/customizing/index.html index db9c247ac..74dce0eee 100644 --- a/customizing/index.html +++ b/customizing/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/debugger/index.html b/debugger/index.html index 4a1a048eb..f5c535725 100644 --- a/debugger/index.html +++ b/debugger/index.html @@ -13,7 +13,7 @@ - + @@ -615,11 +615,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -636,11 +636,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -657,11 +657,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -678,11 +678,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -699,11 +699,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -720,11 +720,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -741,11 +741,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -762,11 +762,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -783,11 +783,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -1128,6 +1128,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/emacs-keybindings/index.html b/emacs-keybindings/index.html index 12ee9b4cf..4beaa5b41 100644 --- a/emacs-keybindings/index.html +++ b/emacs-keybindings/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/eval-tips/index.html b/eval-tips/index.html index 27f709687..ce856c226 100644 --- a/eval-tips/index.html +++ b/eval-tips/index.html @@ -778,11 +778,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -799,11 +799,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -820,11 +820,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -841,11 +841,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -862,11 +862,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -883,11 +883,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -904,11 +904,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -925,11 +925,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -946,11 +946,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -1029,6 +1029,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/evaluation/index.html b/evaluation/index.html index 564b62cac..65bc6d9d0 100644 --- a/evaluation/index.html +++ b/evaluation/index.html @@ -778,11 +778,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -799,11 +799,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -820,11 +820,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -841,11 +841,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -862,11 +862,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -883,11 +883,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -904,11 +904,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -925,11 +925,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -946,11 +946,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -1029,6 +1029,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/fiddle-files/index.html b/fiddle-files/index.html index f4bf2f216..5c824470b 100644 --- a/fiddle-files/index.html +++ b/fiddle-files/index.html @@ -13,7 +13,7 @@ - + @@ -615,11 +615,53 @@
  • - + - Rich Comments Support + The REPL Window + + + + +
    • + + + + + + + + + + +
  • + + + + + Evaluation results and outher output + + + + +
    • + + + + + + + + + + +
  • + + + + + Inspect Evaluation Results and more @@ -886,32 +928,11 @@
  • - - - - - The REPL Window - - - - -
    • - - - - - - - - - - -
  • - + - Evaluation results and outher output + Debugger @@ -928,11 +949,11 @@
  • - + - Debugger + Pretty Printing @@ -949,11 +970,11 @@
  • - + - Pretty Printing + Test Runner @@ -970,11 +991,11 @@
  • - + - Test Runner + Rich Comments Support diff --git a/finding-commands/index.html b/finding-commands/index.html index e818b430d..706bf8985 100644 --- a/finding-commands/index.html +++ b/finding-commands/index.html @@ -673,11 +673,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -694,11 +694,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -715,11 +715,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -736,11 +736,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -757,11 +757,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -778,11 +778,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -799,11 +799,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -820,11 +820,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -841,11 +841,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -924,6 +924,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/formatting/index.html b/formatting/index.html index 4f5e9282a..dcf39d037 100644 --- a/formatting/index.html +++ b/formatting/index.html @@ -772,11 +772,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -793,11 +793,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -814,11 +814,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -835,11 +835,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -856,11 +856,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -877,11 +877,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -898,11 +898,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -919,11 +919,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -940,11 +940,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -1023,6 +1023,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/get-started-with-clojure/index.html b/get-started-with-clojure/index.html index add6314dc..3164b83b6 100644 --- a/get-started-with-clojure/index.html +++ b/get-started-with-clojure/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/getting-started/index.html b/getting-started/index.html index 2f0382a5a..4308a1ada 100644 --- a/getting-started/index.html +++ b/getting-started/index.html @@ -742,11 +742,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -763,11 +763,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -784,11 +784,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -805,11 +805,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -826,11 +826,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -847,11 +847,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -868,11 +868,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -889,11 +889,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -910,11 +910,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -993,6 +993,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/hiccup/index.html b/hiccup/index.html index 39c9334d2..7f00acf77 100644 --- a/hiccup/index.html +++ b/hiccup/index.html @@ -615,11 +615,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -636,11 +636,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -657,11 +657,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -678,11 +678,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -699,11 +699,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -720,11 +720,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -741,11 +741,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -762,11 +762,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -783,11 +783,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -866,6 +866,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/images/inspector/inspector-view.png b/images/inspector/inspector-view.png new file mode 100644 index 0000000000000000000000000000000000000000..2209bb8781edc624b5c4a281e9ba42584830341e GIT binary patch literal 249872 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�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

    ;gl-eJ z%@jFv2&*E2!mz;gP~e?n;GL}`Q60z`HeUx$#5)a95HbkFGn{nszR26VY~XW+8deK9 z#&AqA#52+yzu~U?;0S4j2S%SP_*tUfRpiSN%rG}#8KSV43i`1jHS{vV|Gu97V~tHg zps=l=G?EqY2P%y^@=k+RyT}73)-t9o@8uP0SFgm^$UA}sozVyV-E?E9wiJ> zy9W9YpaZWJ+!@<~j){4i!kil>2gZPdA{^-!Ks5Q+oHCiBW0_$=&dzUx&9gbj^E*)l z6cP*u>h`@0p$9%QidJLdfA=c?AWmK?g3pRji&8McwupJUe%pUKY4AI-N41>beeT9O z$fq3a3TcG;w4uO5C+bRlR*hQt@5U)o8Yny-_#NloL-8vz$ss|$p&&3QGeW4*#yxNB z=kFh_Lb3=lv)D2In}_9AyZ1Y-0t}jo80o*b{2p5Hbf&B*-MXODo9t|9?c&FUiFnkJ zJEtTpzIY4O6<>sSZ9j6HpSNtb8H!rRNRea6#9pP?uWh2eFQ+yVh(2`F{qs&l*_(Il z?klLQ)2;>_fr*g|o($5dMDuiO9-r8##)S`}1&|1H5o60t0|;-LwT;&wGp~qE>X(t1 zWr+QJN_2yaIh3UHjlG$~gv~o)W)7uN4+>YWKC=_Sa<*hP!yYPjD?`s|EQsK$XLM2y z)1o4k%z-1{pRDJq>t<%l{M^O#+suR3r5ikL}X;tp^H6lzT2A-x6fAC-C&K0Pf6iWSZCKMec-ftJUKSZ zo}H(bt<*g>RkBE+{pH!`vJdYxabmNfoON~T(+!%tl5NhcAEiS{7|G!nNyDejBIhX& z^d4Q$)L9Ep~I}Fl7$q=mVqx1Gq8<_G9E&U zrKC`%HWu|fxt|}|>3&Q@W<8cFV^G2~)o0T~PV>8JuRQC= z5`8ny<1jYTch_k}cXaDwb>}A|m24v=?ff?W`M${DUD!TEdShp#|2(6&B;A4c=l$3> z9jRHFo0#JnkGJiJ{-7giD&=iOkZ)!eZD1NYQe+A^3INQQzC$~hAyX1ZL`X;-y3iAc zyC@OeKDWQy2k3@VeT+GPwmln;V60=hU#CN}F9>H)6uGOmd23<@zbIk&d9SKY4Uf!l zrW!GmIe$g09uXqGu^i6=V+(qTpldtL z#hxIF7lV6`;g-=IwHjn`C-D{knf)PBx>jJl(=w#Er-xzDjamkYGv>xx$xUhbd{^OIzc=jMICbfBTQ#$L_G-oH9(zrg2)vlh=b zYPYmb=D7mc{mbO6)cU)Pb0G>vE5>zRWm<@gilUZ7M&ss3+y`pyv7-S!@Dvou$_n>Tw)0s~^fB@qHN$l!9VW+D%lqDQOh9TveikP$WLpiB%f zV_#kHqbO0)AL`dWp*Nq(EeHq>Bx@w|q>JY;c+|@{Lk?xrD;+TRGvPh-Wid9?L%VwV zd9JVyuvH-MCa-V-)k+*Go*0oBMy(8m1C0Q{FYA$78QG2LTlUDz{i>EY3;X&%=MBNBm6mZ8~Oe!uZzQ04wjQ1@8hRPf8YJtAnfly)JwxyC2} zE1ttJ>hPmrbCY6@)Y_liK|IjE9u*(@T72nvNxx&ezHmYgVo@=#(`G`_1d_oQt*FeG zT9)wRt{*RU)_-gdnS8TY3=@eU7bZSPX!6`4!y2B6zLl0@z-oSgbGL`+C zBk6(@7^B1wTs#XJ-%Rt+QT!gx_Q!(p0m(&Wmcu4(4V6S53#E$sKXWJk0ROwo4wbeX zH~qg94tnLcN(^QW4-~Ce&mmOpq-q8P=5r2TrEdA!;)zu8<|5Zg`FbPtfuPu0r!%cE zI+liu?Rga&Z-f8cEXB-g2XzHwXy}S?0zG%8qx3^DaWRAiu_#|MzmYrvFGg&2t5aio zNMSwIp$yWP6e~j$AswT{V%}AkUi}5gYtGiEx!Ro!w8i*dRHzTzepTJ{w-(dS)KxO` zluX$ZxzqdZ&{fK!Y{k@i1v@h0qH=QVphXs{=P$Yu&4={JkuE}<<6C>wTts9~UGD_E zK@3~zZ3I^R`c`o#7J(W}@#ME)rZn z9FzoKE82MNhFlK!l^V4glM2dJ|PPX-Ef`9V?T*L`#4|Nga#a7Q~x>Aor zke2S);~&i!&M3y<`5}s3iUW}xSLtvNkPU+}Ff?PQOj=S&&oka%_WV0+DWiw9I+IpY8h7~kb7*uRDP6L8`2je(L?{4*5G~T;|ZUE*QGnNS_4;U-!N|T z%N3)?98IhuEIslgDg265XZla~a`J{Zne}8(dXBY0xJSfnQ^v^wASy1!-4!!1q?$G_ zkw|I~796SpOr4hbnLEP&S}_oGz#+OpnXgr)6iy-h!?06rVhkWOQ394uo|wT-Hn9T! z?^gGLU2ct3$9%Z2^fIK9p4hJ)q*h$^(D(jm3aMK3W2vz@T`Yd~K*}?T{}SvvmtC)H zT;zwvkDFT%=(Ui_8})SUFG^f5pXuNL8m@!E>b}Dps&eZ$=~DRaRIGTzBcEENU27z~ zD;@9Z4A?$kd7u>PIg-*P$JqKY(D=jkff{s{$E|NzBc?8UzcSd(MNlQS(>c>Z3aKj( zzaAqG5+ZF;2v8c7Xkj2RM#-*0*7C!RY3z*5EA`H@%jr+|%ir9r0Vp?_(REo4_1)cikqpzne%Mc6NRaLYInr z>%R>gzR`o%#)nfy5JHa#-+x59JrVx=j~fUx`;j0dB;;C&f(emnXhRk&I+ne1qHdQ1oiPDL7?^D-!?u;Yvk0H2WsB5tz{e( zKSkG^+sLOLth_gfy(SDHVqVJpfsSS1mqGr!2B8#T0Z%B9>o^tyrJIf<|7~Y$7=eKZ z=)A+A9R8Tdbd!)Vp8+)>KtTC-if-6fQP7Bn%C{26)IBR4<#+Kc5ZLx6+{_*Hhe4kv|%HX*d z1v(b<`G7gq@7CH^1P&AMh>D1qnCxlncFS!n79p3mqpUa;dRZ;2tZ(fQDT9Jz*f=XcoY=~DtT9G^gPUMwh=UoepOzqfTX#edu=Ul$>i|-3 zC`^L|dE`0moqHu!H_}~6y~v9;;&tAyn8>>23G1dt`1&z|oC(37#hT(W^g)F%>G+!G>4?9uQWoW$^w$Qa1D zpBAqZ0zn`B0qz{uU$p?nML(>U_Qc=PE}oCPHC%X99CB}!L$@Mu;`Fg;1^4(+XABVN zSf3*ADoh6<=?Cqih5!`>!NfEi(x>v@BIx$f$j8yVP$0yeplbY5#96&w1CoO!E0}+j z8?I*$=Eldkmu8BT8~+pRrnB z+`(*mJaYc%>{e;*n#bXQ^m~#e-|L8q?(B6Jrc_r-AaGK_VSBMht$kW(Y-hh4wkBZT zao46G4j}k*&GPyz4f-qXt-0L4MedOE4%)P|$#O z<66LNaCMh!P2&~UPwn1&2NcdEQ8j_Dmch3|Um^>Ad>t6TJ~_(6^cy{exwi22_~4M` z-nw)mjb_cG=aRUcLy5kS)~(oCx!}6M3!Gz`kkfn}_(z`SeR?#sv?kkU0z_^b&wsFN zDVu}tXo2oD?tAcAzH~=1Rt#y6ko%r}BQ1!$nA0L5{Toon<0Udj@T}$Lh17bfUyNN; z-kv@TozPA5izyiIv-r98xo&h%(se0<;v;!ir;~)X~tl{hDG71zUv=!5_hOgAK zSu1xY3LlTW6l8lbEvA2zZ zRS3uMBiM{ZZK52yLC*(keb!laXQ8Adic9rrr5C*lkUOvgNar)hO7~e{CXi4SK#ZQB z5)r*%Hk!Vrz6jhZjY+CKZZ??-1yM@7%;dLXBTR zUDg7z+?Esp`l;N-NDwDC+SOsRbUz=m{w()3<;RGGMEmhF;oZa$H?bp2()3btDAQqk zgjzI1myYa%2LWvFM0Gh56-Tkn`(=G>$Jd=@>wnD8oxP>CW1b5*zM1{5Q%dgm72 zT`}?VbE5b6<-7*9o}i)g^4BA{oz=4^2ezZ2Ai_8=|B{Ga($YPp&FQTRC?avs+Ei%$ z|3n0fuc>ONMe|R;7K{i7%4rXK{h8FMONNThPlR+AWdJz@He_uU=E1pP?9Kqx4W7?v z+--bEy15SDQwNY!E@yfN3%)9F_IEA#Ou@hUXv0hg9}**<$)cWVzNvGUC^2SacxgyrZt5mcL^<3|FAAa*aI=oUc|2>z6th!~&qK?uj zNDt8*>LGnBdVBT6UwuWUvZ`Qj8;`1HQQ)P;*t#G_VmEK1zFD8xvurMO~ul<4EYG6~Yevgh~84kYegfO(`XmDIF&^ zSGpw5icU!AQ7{$>r{308{j^oAxhvGq2JArfw~*SbL1OogLivvT(+;2quc>t?0$KSj zV~bU3LFn&}`+nMOeDfNXcwyZFxZF)aty+C<1E7|75N-qcUNw>41VdKCn(y{*r&ow1 zou#dvS;&Yh$SJ)YD{z-9nfmFd%{%RnBd-T25KY2zWU*9Vx=-*GqijN`UOAfw8T8vh z-_$kI{LrobS6M#5p{YKaXVr*WCch_6MnYs@4@q( zkRf~hBYY}O(8@q9uQ?GV*tDZqrddh6I>RNiCBxz;lv!zji?JSv7-9k&lZNJrP8fl# zu8h*~Dwai(UuqtKwpiPdg6W*ylKHTl^j`Tp_f)qM%Dx|&GA9$@c;a4uD+`M4J(E#D zhJQf^!LGJAg2>Zuv z(wZHre@%dcs%FO|zfrgstv;IJ6q$S6_a64@D%NLsq+-sMdesOlKxbSsD*qSI;)S+7 zK-!ApSG5Pw71_D@-Kuyop^6_4T5vW_P`m?fBb{D7H&pOmq2=coR?L;z-h=auZTs}S z%v>K6VA?1bxn8asthEFc2|wL8xpQdv`dUA+sCTtX4aj-5-f%*Qntwb-#sNV;AR>;% zr}(cc$u_EiFS{cy5{Zhw55H5?qWX2FU{l_0*%#Ej7%tS0rpH~B-FiDmARj$q23bN8 z7vEsC3{O<~^h~>QJ-j9gDADW?CasaO(UAb%@d8nICjKWskxDEFF%}TQWy0M)i2jz&>GKyJ(JJhl04RJNi?D|LU-54k0C|Mbv)(24is?NN7^~znVC#*BAA( zKoN%r^DPJ{&+TPuLV_-Lo;PiBO=(YzKxnClc`=hz8Gw1{qN_EXO2EL;8et-dzF>j~ z*X~z%$L00bl4C0A!6+rfQFYc;t*I*M4C#v*sjcB+eFe=h7XWJO+Z$2n3lWVbP4&C+42(f zcyY1l!-4>~9KBG@C9QxXS_d@%K?ER#G(eKKvT6V-oUBdNu(b8?*`z*+S})hLqd$wv z4v8|>eYa1}ST?@b8yp|DLE~OwWy>P#GxMz;8Q%yK{1rDN;uAiD+P9$x--tTy5eHfcS@zHnXEmzt@F%Y6}ySV)+%sLsVsV|uS z+TEovj|EA*H-gkQWg#4yB6sLWFq161Fod*$$^6n$YgWvmbi>tl=fPSXmZA=>%zaj1 zQ=bdi$p9HWHCgdW zisMqUAzxcKp8fn$tzp;!P8>LvTRk)1KdPc6{!pEy&OcYRf>N2}DT6Xc=a|uz?`1 z5W9d)24#(rZFnSq#OZ0h3s776UIi3t(n}nP|G?OyJ`ta*v4HvEx+OtpKeVRvJVtl#QXsy4{zXmjl@ z-6sk=o%8cLOVg%t;d}$i1AlZZC%hq~hjShxwzppRp74IQ_Wc8GvG*vxStJJsKQFwP zl2B1m1HOp{J|8WX8OPV33og)|TYA$NQuMXO4Ddpe?p_r-w?F~4GHb&et<)NH49Cw- zIaXx@d7GpX(}FXBv7jPW`%j9K4!{|uH7{sV`+1sAEmGu6G(KIj}7_^^y9 zEP(aadJlFd=sFjPjbd8<%4<#_s|bnt`98Y7|3yD@WwN;yR{EUV(T)cwWMjiv4ufG_ zRb^28L^8PgIo6pqp_RhoW%8c@;pe0rgUCg$iw_{NsX<(^MTa95ljs(du5=2!Y!lt{L{UM1nBOtndQtHaPm1)ix`Bk z1K>P-B;0+qc*%E$U1mk*l@A#-@xChze`6vo?+ZxDdaf_b&ODgeZqG7g$qC})!C`}x zk;Y#V&$Qpn}r-F!1T0oJeEA{;~Xe*SRM&U%RqB0zm(~jSq zgxc_`5~Y1+P#ZoPVt}GeQ%kWg<+!Wl2~P`o;8X4^49sUrycO>MaN;3=qcg6M;$mJj zKNx8c*}9DhKZgbVnt2+@0EmyjePyOX6zTMhAVl z?N`G_k{tJROh3-#JB~<7X#6oUbO?>_7J!>pXb|#a&aHLfD@5+b*z8og1Xzx>WRJfM zNl>R+(Pi8QeoPFL|L=4aGn@#+;;`^3Vaaw{A?^88;<2AdVf<0;HNqbj{M0DHu2fSX zBXcW=<~P+7z>8fF1mM;%L~`XS(Mgm+AXaYv$=(o=rc27$okl$GJrSjKLMRi)&EKM4 zuwRJXpGb0HkET5|0WX1b<)?dUQG4E%)T(VoPX@k6N@6}IS#cl~UF{jUpyL^NxqgHTflikwr9Z5j5@N8s{o85zPp-o&@?0j*)nZ%d1zP+CCP&IbM~kDxZ{p z(|cb;$?E^3oo508Z$eTGM&292a){_VCz*H5>*7WjoDZ4;0bnj3D~QZ4{&Jk75P8N& z)tG*+vnx&TlO}JEM%=gap8Gj|*9KX|^`)M;anK#Qfepyo`WtQmbZH9VmZ_v+`tjQ^ zl?^@giPTBHJ^VX)QHK0qz|q;g5W6uG`7?b&DBV=pU1W~@uYdDE;M^eia2|Ov_z2Jd z_$|Nv=@~otX~w{9tc%)hm}SHj>hDQd!@pZ-88)CLzc|A{Al)N#)+&@MOs`vaj2dEL@C6yp^#(pzu88QUWBFn{fJ z*egWE4(k5kZ{HpSX_GY5wIjNV90djVvFi?cRfImRw*3S{@Zs}ldE6ERbd%8(O6-vN zK3*XP?LI$ak*{};_1+p2^NuZV<&#H!wa;8I+kkLYh~LQHgaRC-^4^tMw1;^c!f!JUR-q=Fg_~jFkWZ_4(hQh*aj^m1JqVB;Hsu`sSKo*hy9Ng@= zel$&f!=TfvAP0UAX-*{IHyRMQ|5B$BSMO|meg_Tg6O%_(6ktgM)yv%E%||jSA4p2J z{y4U$17#bM$r&#$;x-Il3DRbQ>dM3hS(( zqJqsHYAajI!37=Ffeqq(;OGfAEV8jY4@24M52`e%Y>J;cEdp5fLj*(_#M@D{%7Yf* z?RBAZ^P1J-{}@29J@0=CDWGQu@}ZRfL=ibY^N6q)HTYVKefTg&3Y;lbpF5^I=*nXL zmD#ppu`;Y3f0C{UNk^x9dhCSZ3E}eHb6rn&gsd7-N}POpX>h-i!zJX>%0co=VCId|AB@H~8{M9Z?kyPN^B;%P0tE0R+d# zjvOUeAezN8w?~MOURGtm2T|Ief^kEqh@90&Gl{B*ntLLio4oJ{QRIdQLJE5IFD|i; zN)d>lV$A+q1a1I9doFh13hzlW&5J7bFNzjk zgYp88UVxrEr;h%)QxMmDte3`Q=B=^ z4`S5GOo=zqF)YM|JyVtjmV}MM3&@6p+6QIPds8THb!CtEw+aTDMg+skfQD z_lRD=`{a`@nd1F{xn_*e*jV-s#t#0_sUZoRUzyb(KxVao`x(`0Dc|`=xj}}>y@N!t zu6Ynl4RMu4vGz=In+%G<6)99rJ2PMO^rrbm5?`*x5S;RUug2^=e;ABs*h$GTK2&RV za~@gJ3phMbVZcLwjFo=fm2H_Gru1bV)b772`O=eI-E4?M7ZW z;6Z>)3C8=30Ob$G)YCvmVPQru1`8M3GT=$J-mYCjXobF)B|0YYYwk>Hii0RMC+}?c zbidf)QKahr!EESFd`nL6&7=0^d&m_&&`3ALH0*BTg;o+ewN?55#TY|{F|bTKG$Z2* z#%0vhVruU9a+G5F zSL&}36zW$qfI{!FGk3GruX*V^<6-I{k}yC2A)z|576Af9?v?(#QS`d_6-Hs5*slg_ z(9(5C;w+VCx7Fk4e*RTdCfSCnxmCpD&AWTrU9(?*qsGnA1m5IhqWKutgk@^jzaw!h zrk^gY1}UK~E1olB67^JYf*)w+hhxE@EJ1ixf+s1h{ZX2+_xh&=l9xq=8I(PsBuJQ+ zvv{&KRr69vI9jII;jG)`KoT$A+(>N(U%l&Z?7$U-9T+78nu3RVF&y@^C;h%XxOSUy|nxdVs{Q~!sdq0$T4dZXr;^>|m+Qtwye50T^tak&{U8?+_zR-au=mlb0_L?6fRF>fTfC*#==~CaVBFuHw(k@!2w7+UAd%ifsl6Ce+^^Ppe)P-eKS3l5E zYCz3+NQWK+F~1op8F`gnJp(<1FvG}PE3WYJY-2b4uWi^Xow>9_nZ zybcqIy=a-vXFl9PVfc!kaE16W>LVZQ|NaZ)9x6U6YVaML+t1C|rKC{ANC=XI2$L`u zdp;0gYl{~+hOw#kOwKy~Zw>gjrujmNY#|U1@A1Rq z-RfC45|9)ZPLo31D-VnOQBV95v&5{gvLp+wowJH(%IXK7Y<$yA9rN=}>eA(4<&TEz z=iBd>Uq8p#b9A;bq;;W1FUja25}#zSE*qb3Afzzg?Acw9+rEZ;82)SpCj$y53blK; zM-OLUAUt7u0b|3_fe5mt58RB05Q2rC4-d^0#w9!Iz6LWs)2AxlDaMitph%jih>bM- znt$CTi;MTfp}5v!_l&F5`UK`FqDAaUl9Yljqw;D}*!?8nWKdfEXs+S6vjLj%HB`|D zBY?^7T6(k(omlgu)TPGRY0cg>->z>wmqy5@|F6-XX=40}Dt=ucs8+vy}`UCc`dW5)HPCFAwB@H&{eS zG5NV$i+*NTM%64OLgEmY@aMvO2~V2ol+R|g^Ixs~`!WXq1KYy7hlMp-dK=3q5slhK zYGzvavk$~!j&lNE)vQydQf@HiHhr$j$y(rpOB;O=sYcxe>=kEbodUef9_5!iaRpMJ ze=%_HW>-K0=?DLOrS+|VLmc9;AEl1o?^`F9= zqW;H)?u(f28M5j!%$tyjhHtU|*i&FQpwj4CFf5{Hn$<=q^*5*udj4q%Bc{Ke4t(H_ z`TbE6Tr7o|EtY>UL4S;m^0;sbezkM8XMPo@iDV$nel(pp1) z?IXwp-v8<`1pPKTAU1Y|32S7wBXs%C)dJwd5wE`{Zrpio29 zD&_yz=eFXm;9^Zh?e03UL669o_*?$h42lpwMyY4?xEN2sK)?Jv7xzCK<_wnXQTKOF z_D?=DBw-U+|F{6b{2qmX7I~pATiylF$wpR~{gZ)0Y&u5_+=u|V?AOF`H znQ;bZn|OKRaZ+$#;IXIFM2bCV;=RR2%l|q1Ul5bC_RhyP1S4RE62r;{>_!TK&B*_? z1`;7I)EEH|LWotX9Bh=@2XdIzb9rK*VyLeu81b84-O%+Il!~D2Ys4gAqM`9C)Wc5C zi|6cb3SDGAJFsG8qH(@~i&eikU8OE(F_~Lg`%^pB-dtnpxhEy@vBXaAQjyeB$HDq# zsJO%;M5OW`Ey!2&w7ZCvk_+UUMIq<{b_*Y$kJ_uO@R-8|8R8o`dbf?GmX_W~IA{`+ zq^TI8P=Ap^OS|$7qxl1#G>0wQ-cAzrR&d@3z}@uQ8n5_v@*pG{Qgi*&I%`qQk566wS&GXuzUQUx zEl!^cBm$+iARo}tZ)dHPt@MVk*AYEBT^IKB?SZEK7U$w!-iJxYWL& zj0#-rvP0ERrRGg+H^u0~7ALEhEBap4Cz_w0+?9PRa%-~IE&M`@i~X6WLIN9JY<|DY zn$6*uQkB7b&DD}}a!X#Y7hHJ~67) zTrdo7@*1o;jsL)QI690~`y$KAqL!1R#pnLmzKX=Fk#jP4XA0V$P|Y+M@kKuM{5{s} z=gF5hu1gR%hObY+-Y-TRn2S<%O~|$Nn|`dWDC#A_o8HS|SLEx~$rdW3I7lBc+0N!D zH9OZ+hB5xm_CVNBl~rIbi5WT63pJv-O)q->A7y9Z7ggV`dl^ASKo}aN29Rz+Lb{Re z4h8A%ZlsZr?(UH8PNk)kPH7lA2hQ@@@3Z$g`}02gobwkjto4igzOL_euL&0#zVwIr z$08VUlkah+hS&N)1PveI=_j20pfIdm>-5|0R~0(#0i=8Yj){6H22^)lm1ZY#swEaL zT3oM~M>Ba6D)pO*t@0D^&cuaa#yZ33;{LegTYD;B1g0)B`Fz~6d{WMEt+iOy4e$=a zWN)NZLX^t-Y`8}6QUR1o_Ju%d@pEuP8*bkG=A6WI)~QV6pBuX5_3vy`g)GID(r@Bv zy|W7rh3|2$avoQgo-E42@*=@#O=~1>WMQ1JCX!4ykp|>36U zm7)3Z{ayQod*(mgjzV9-Vmt^4H!n)(N@c>ZsPNDzD2^t68*om1!ybIT7Jjb;ncW#> z{8hZji(8L4@?8AO+FGOejDnzq_E5$SHS~!ECet}iP;rP*a$*ix5&pkltEbgId;Kub{2f(JfAx|Obb=DT1xuP z)#!d5=~D&P<9AK>7`^_os&%?*!~LQ(Z8;!uI|A-~pYI2|zhU1~;VIcBaWINl79`FQ zqx-=F20KjE+5RpVGvb=CtlqfINLobpefgc@=3sh48xvr}~nWIiROPh(W=nlTa(0%MJAv z4+7?E+-77Hy||?SUDs3;!O=|M9jFS50k7zGe|&p-ZoU1Zd$E42131<`dC09$&Q>K~ z)4@Beu+(gL6(cBDL>YU*E|DLvBzL(zq7v_NUh%h)2|u;$WKJb+`Q1W5{xFwFR&U2^ z?KM9NJfnE)#SDlxc&p5WXZNx`;=J3n6ANtvv$68WgoKutVX4i*@diFFBBGa|8wJz~ zU;0>@Q%P?GM)ptD1Y($9pkEA=X~*`558csP7$>WTuJpSGo=J(T*H;FO*Q5JFwm(@B zY=hzohQlXM9cBs*W~Uz7IeQCq@pi^{=%Ic(-96$Z+EMd3n3%#j?1d9i`*WbEDf7FI z&?g;M`*kX@Z4MKs5jYGsUT-+V&cpZ@6!pYBOA(u4Q8y?^ zt{TV{Ifj$v#aw!pm+rj2J)kU8}xeo zkB#7^e4Fj)U99?fm5RzdF%=l6-yDL(wCRwVstm--zr!MPc-O}6o}6N-)jNYZi)X#A zvNJlX2m~5)cT?|ENY@Rr@Nhf+JoR8$z<_}`?cVxJQnf@*Q1-|6jIxD0gfz_jAMaTI z_n1IiTw@99DS)Da!8+5$<}z#Uu$@U!?bx6Y?QD$m?cgB7K^d*Zq6u{`V^Ni(kR zxZyceVgr}U@gue-1@tqP%H^8X&ojZO+oR|f+<7~U&{a1aTGgP^xpGn0x){~kPoZ{8 zX}z0C)*mT8+Q!i$iwX@9E2s8U>E&AD%g=kSkTbAgqa{>^bDeAz_}SSlC~&w+$xP|x z%Vx>B(LqbfwCJ>oDAha~1^Yjz2^mB|SY7Lano)xrY2GBZ>34qXUuC7ot3G6HcXN)JI@yS@)VxL;)9_bkSXn}K)h^bX z`Wtd6L%oosP?$yS#hB=RCy5J@Xk?OgZuOOMUoJJCTa1z^GVj(n+&PHVa~WPrsea2T zfv~m)=T*JxwLMth4;-zmuQmV0wY2mrVZk}348+5r7^4BYb3ZQIiZ6K2V{hXNw-KId zke)e|#nryZ;XVP%i@>uTlb>4JZwrYs7EMtt3;t}F?Mh%mJgV^Y&Je7tiwCwIOamk52L zMx=Zgnk6?>dn_;&(~)}B?lS+RzGZMqS*VH3K4K!IkIwo-T;z+jpHUVnel~j5&uIoO zOwPtWN6|x}NurmzkM8b-3-k3Ri6+^PT}?mt-NCO$??&+!WU7m1R&U~K-PBO-wjthA zCHbNY1^ccAdn6%m88z_BZ#!7vEg#!jhK>ivNe~b~gM+n~3t?<789z*HfYu*du>3u} zcD3L8{Qk3l-$V$hzJlz6L=HWoXjOi5ArS>J-C8f06s4bT4l4jdhU?2~eMY6712n$Hii#Fp-)sh?vaX3NUU+(+?w#l%w8|GxKFX%FItOv zK(c+t^|K&tz|0*YUwsD7?uMKk$2N;zi>%jH=(9%okDL0OYzSxI*i#EDM~oncC{N{~ z1Goh37EVf=uQUaX!0@vBRl~B#q0Wvo|==As%e_3ekO|$guMC6ZJF>Yc)3n@;O_NgS*mgPIcO8^)! zo5IN3xvv)79R+EJ)|6J%*$FrIx8(88{wVi}+A>+MwYcjxTyPw`oX9`or1Ts&Z|wuZ z5(R?r7N-C`Zw1qQKWJmC=iN)|NAqyJ*A_2~r$ugY%5F#t#*$UagYo-@W*dUWYC38a zOa~=!As>lCeDs8UANUN6+#*gBEQQ2N>u@5geZKA3)OlJLm+wu{AQm+A`b=Y~2<9Wy zPlYw?xjY7=XxIq*J~oFzQA((6Q{GM=oM{ z7nIstQ+!xsJ85@!*Ueav)!iRPd+7E)+1MIm#04Z}g;T$Jc|Sb~Jq|_uM(cb0O9~+6 zai{jk6p#>EgRc8N{Zq@={R&b75}7olD%sRA?!OZ6*(`|o-5in?>5Gp?3S1OsTB1c$7<~ zet0i7F}_K{xMPqc9^rQw6Xl8vLuSp3QwntpKvULJ#8@k`eYC zE2jf8EgyfQSqS4R9L&vq$Q_I)iKowFVuWCAQ~29JQPx+BzQ<%7Ej5=sXHgRu`PfVr z0aloNJ%`6l>&ZN`DzQ z{Y3jVdUE&spVU?V_kYyofCMofphul9)T4>Lf{H{$Jc{l(wYVN<4j(T!TVjNh40_>k za{64u$i2C2>V{p?)k5)EGV#<)n5d*;6gNead7R_Gts7QE26OGQAdyTja@AHFQTw*R z$on4}PV$XO!9J=zb?4l$8OJA?XyoMX&VXdG3?_8I%W2hK*Nn_{Rl|BEC!RGX09}Vu z9^Gn;I)qQ&R5pCs|Ik!<)=hx<5Lx7ih?yi5S5k8D!uYWxy^*Pbm`Et`dfN8 z6PR+9GOv!XCAkK_gw|!LQTjD+pl$YD9t!w%R-k>B#gCod&Z^vBPtyp?G{q*Ry*e~ zkuNw zAZULyn6GiPoq9R1KW#QrP3ks#l_VnGBB%`srN1gMUivD7Z~maGLx46cZBy=- z^t6pc@$&fY3n#p7EUKcd3Xs{s%6xtk?549EJtrt8u{RiB6>LQbzHvfdW=9Rtvp!s< zcjyEub<=K#Eq$N5+3;LClAr2er?X9&_s~p6cI|yWVC4L&ejy63gXt~(g$ILbIw;C5 z>`MfU9c*+i(E!RFXv;bNVW5-fF<(A-VbmX`V9vgU=^dKIjnprb98cePSQWB&)259w zyxBl{JQDRn72(7C!@0vY%IVQ9TCct_vgOy&E#J$`)r44w^~j0TB&S82{QNLSa)Vj4 z1uALa)rQ)vuE$?lG(aN9?viv$r*$IbM5N%(pLZ1W+zulm*rUu zSUVJ#ZCq5|mm<@vd13LdMLG3iSS@KLK%h8A4YQLJQs3or3{5;OP(T?(m`wgw5Bt4C z8g*F1E%R7n8K`HE4sN!PYb#gQyI*j|B^cqnfES%N^F@%W0>AiEeQQ+Vx;7~o=aq&; z+!nC$5fMW_zHa7fvxhFat1RL|CO8pEUnNPPhYo?ew??lvtpB}U;J+jM=b4F!hfnGl zTT9@-l9M?7=sH|h)h>}huTf;hGa_oAodNf}ngF_%)`fiIc8Y#!NF05h)k00|<-t68 z;nNeE7F1v_Gz@%7dcf}4M7`Ut@r=Dj@ zklS)WoGE04y2h5Ce{j0nL%J<>XP(qBcqj%2SA?)yRDNRB-W|5#U*^>K_Hx=`RkwO6 zJS^+S@i4XfVz3~W9X0g5VAd$VY?#Wth|-#yhsq)*WcutSj}kDw;#l1V$M&{&;h!YI zu1KMYzck^9389^l*j{AwC5vP1QWrRkGC;Bies^WQmv66HVWQ{3E~5_jycHEI)~%r4 z8ZnL#|I8|})@Zwbc;`sbg7RnGm4_k2_(H8to(zuQV|FE3!|gi&!BUZcWutFS#L_(Y z6thAE{LS8*uB!jD%%5738uHx?kn3!?kk_7oK;O66CC#kv*3lPAGZFl;Aga-5Wtitb z-bbKI6#A{oV;P%<1(7`A)yhTzkHyh8lGgY+;MBTLqnXEq9erA{`%(I+vF1ez%ahaO zYp{GedSHp|5$Q=k1rwD{X2jL|AwmpqUPIon=p1duf}~!h$pL*C)g@P(xJ`?5|70GD zh=ITBOVn7;;T~Js_20Oy58uuvQ??bV_l}h_Fs#4j(l}R%N#&3HPbHTV0=eYaqH00Q zDC~4&{l@9{IbBs}6+P5T@B?FiC}v>kY_XhH?bgJ?xtiF}b*HRqqdybl_jxtJ$w^B8 zuu&2cBt$(vw^K1U(sV&nBJxVIbg9(;P^(-!Yz~^916n3}s_-fC;Y!_4axSU4=Q=wV zPipRSnPXt zs`Ya6b=6YCyQz=)q$)0<4b>EiK(%OLU2Jn@+t=Y*^`d|(ul3gjrRhoOv<1w|Tk9hV z7+i)Z4`?%ca3yR*BXT~T2Id-XvOhJ{Otr8xp#HU`G{u#DbhbY493?oWmwY-8RwZn@ z2d&*praT(!%y<40NE+37A((A(7!rDMZ9PI}GMoa%yS|BLK*$lRxKu6Mr>)j-i-p)}Lu-#UYLr`RW-)$5 zQfFQ3i`GzMd&=JO{Li8WoxH!41vIs~`_kA4I`Jn?eN%kTIyM#Twj*5AnxcLff1@d_ z%;E{+guiE3HWa>)H&EX7IF4`zOV-+t*|AyQpKYEzWf}=H?ODv;!lzSTyiNp(6u90^ zEy#I>>3zWAkPsa{y~+I&q$ov8fZJiT1r&VS)LXPA@89SAJqtiP1-RoC0GWxh?3t`k zXc8;kg^q*v0rIm20}jqRAFbjG2A(YjjV$SzdU&w0WE&-zX`II>VFBxzM4pFH{C@%czoQc6fKR~)c3TySAV~ z6mHsShgt}VhBaM}%ZDt$$0iRtMp3n=g8FG(eOsV2zO~9l)fgu!Ivl2%61?-p&6PXR zK0M#>b{fNmf8-XJ}@ zEA^%|a$-9QTZ)6Bof@>|@8@0m!7b9ei!ZY6$LfBRpI^)yuwJ0y?=7gh=6x)v2Og?( zzG~B?Ct~W19aQl0!bUhca^o-kf%wMgMK^YD>4831TB6s|j7|MZANo39Y!M=VMu

    You can control the default via the calva.redirectServerOutputToRepl setting. It defaults to true. Setting it to false before connecting the REPL will result in that 2. and 3. will not get printed in the Output window. It will then instead be printed wherever the REPL process is printing its messages, usually the terminal from where it was started (the Jack-in terminal if Calva started the REPL).

    +

    See also#

    + diff --git a/paredit/index.html b/paredit/index.html index 5aee2af07..2268a30a8 100644 --- a/paredit/index.html +++ b/paredit/index.html @@ -661,6 +661,30 @@
      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 literal 0 HcmV?d00001 diff --git a/index.html b/index.html index ef2b5a1a1..4e9dc50b8 100644 --- a/index.html +++ b/index.html @@ -720,11 +720,11 @@
    1. - + - Rich Comments Support + The REPL Window @@ -741,11 +741,11 @@
    2. - + - Fiddle Files Support + Evaluation results and outher output @@ -762,11 +762,11 @@
    3. - + - Refactoring + Inspect Evaluation Results and more @@ -783,11 +783,11 @@
    4. - + - Custom REPL Commands + Fiddle Files Support @@ -804,11 +804,11 @@
    5. - + - Custom REPL Connect Sequences + Refactoring @@ -825,11 +825,11 @@
    6. - + - Clojure Notebooks + Custom REPL Commands @@ -846,11 +846,11 @@
    7. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -867,11 +867,11 @@
    8. - + - The REPL Window + Clojure Notebooks @@ -888,11 +888,11 @@
    9. - + - Evaluation results and outher output + ClojureDocs Integration @@ -971,6 +971,27 @@ +
    10. + + + + + Rich Comments Support + + + + +
      11. + + + + + + + + + +
    11. diff --git a/inspector/index.html b/inspector/index.html new file mode 100644 index 000000000..71bc22abb --- /dev/null +++ b/inspector/index.html @@ -0,0 +1,2050 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + Inspect Evaluation Results and more - Calva User Guide + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      + +
      + + + + + + +
      + + +
      + +
      + + + + + + +
      +
      + + + +
      +
      +
      + + + + + +
      +
      +
      + + + +
      +
      +
      + + + +
      +
      +
      + + + +
      +
      + + + + + + + +

      Unfold that data#

      +

      All REPL evaluation results are added to the Calva Inspector, a tree view that lets you expand and collapse Clojure data structures. (This happens in addition to results being printed to the configured Output Destination.)

      +

      The Calva Inspector

      +
      +

      Only for realized data

      +

      Results are added to the inspector after they have been processed by your pretty printer, if you have pretty printing enabled. This means that maxLength and maxDepth applies. The inspector can't be used to explore infinite sequences.

      +
      +

      UI/Features#

      +

      The inspector view can be placed in the left or right side bars, or in the bottom panel. It can also be placed as a section in an existing side bar view, or in split with any existing bottom panel view.

      +

      Inspector items are not expandable until you make them so with the Inspect Result Item button. This is because parsing and building the structure for the tree can take a little while and we don't want it to lock the UI for you when you edit and evaluate code.

      +

      Speaking of buttons. Items in the view have context commands that show up as buttons on hover. The Inspect Result Item button is one of them. All rows in the inspector have a Copy button, letting you copy the data at any folding level to the clipboard.All root items also have a clear button for removing the item from the inspector.

      +

      The view itself has two buttons, one for clearing all results and one for pasting whatever is on the clipboard as an inspector item.

      +

      Commands#

      +

      There are four commands for the inspector:

      +
        +
      • Calva: Reveal Inspector. Reveals/shows the inspector. Default keybinding is ctrl+alt+o i
        • +
      • Calva: Add Selection or Current Form to Inspector. Adds the current form (without evaluating it) to the inspeector. If there is text selected, will add that text instead. (Only the first selection, if there are multiple). There is no default keybinding for this command.
        • +
      • Calva: Clear All Inspector Results. You can use the command or the button for this in the view. No default keybinding.
        • +
      • Calva: Paste as Inspector Item. Same as the view button. No default keybinding.
        • +
      +

      The command for adding the current form to the inspector has a command ID of calva.addToInspector. The command takes an optional argument, a string to be added. This is meant for Joyride scripts that want to add things to the inspector.

      +

      Configuration#

      +

      There is only one setting for the inspector: calva.autoOpenInspector controls wether the view is revealed as part of connecting the REPL to Calva. It defaults to false.

      + + + + + + + + + + + + + + + + + + +
      +
      + + + + + +
      + +
      + + + +
      +
      +
      +
      + + + + + + + + + + \ No newline at end of file diff --git a/jack-in-guide/index.html b/jack-in-guide/index.html index 23c4f1e1e..ff8fda19d 100644 --- a/jack-in-guide/index.html +++ b/jack-in-guide/index.html @@ -613,11 +613,11 @@
    12. - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
    13. - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
    14. - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
    15. - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
    16. - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
    17. - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
    18. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
    19. - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
    20. - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
    21. + + + + + Rich Comments Support + + + + +
      22. + + + + + + + + + +
    22. diff --git a/joyride/index.html b/joyride/index.html index 9d5c4f9d8..47e263997 100644 --- a/joyride/index.html +++ b/joyride/index.html @@ -613,11 +613,11 @@
    23. - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
    24. - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
    25. - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
    26. - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
    27. - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
    28. - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
    29. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
    30. - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
    31. - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
    32. + + + + + Rich Comments Support + + + + +
      33. + + + + + + + + + +
    33. diff --git a/krell/index.html b/krell/index.html index da0bf9f77..fed55633e 100644 --- a/krell/index.html +++ b/krell/index.html @@ -613,11 +613,11 @@
    34. - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
    35. - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
    36. - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
    37. - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
    38. - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
    39. - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
    40. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
    41. - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
    42. - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
    43. + + + + + Rich Comments Support + + + + +
      44. + + + + + + + + + +
    44. diff --git a/linting/index.html b/linting/index.html index e8ed8fca3..ea484e1c8 100644 --- a/linting/index.html +++ b/linting/index.html @@ -16,7 +16,7 @@ - + @@ -664,11 +664,11 @@
    45. - + - Rich Comments Support + The REPL Window @@ -685,11 +685,11 @@
    46. - + - Fiddle Files Support + Evaluation results and outher output @@ -706,11 +706,11 @@
    47. - + - Refactoring + Inspect Evaluation Results and more @@ -727,11 +727,11 @@
    48. - + - Custom REPL Commands + Fiddle Files Support @@ -748,11 +748,11 @@
    49. - + - Custom REPL Connect Sequences + Refactoring @@ -769,11 +769,11 @@
    50. - + - Clojure Notebooks + Custom REPL Commands @@ -790,11 +790,11 @@
    51. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -811,11 +811,11 @@
    52. - + - The REPL Window + Clojure Notebooks @@ -832,11 +832,11 @@
    53. - + - Evaluation results and outher output + ClojureDocs Integration @@ -915,6 +915,27 @@ +
    54. + + + + + Rich Comments Support + + + + +
      55. + + + + + + + + + +
    55. diff --git a/live-share/index.html b/live-share/index.html index 5cc40d907..1eecd3aa5 100644 --- a/live-share/index.html +++ b/live-share/index.html @@ -613,11 +613,11 @@
    56. - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
    57. - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
    58. - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
    59. - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
    60. - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
    61. - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
    62. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
    63. - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
    64. - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
    65. + + + + + Rich Comments Support + + + + +
      66. + + + + + + + + + +
    66. diff --git a/luminus/index.html b/luminus/index.html index 824718971..60acc180f 100644 --- a/luminus/index.html +++ b/luminus/index.html @@ -613,11 +613,11 @@
    67. - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
    68. - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
    69. - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
    70. - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
    71. - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
    72. - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
    73. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
    74. - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
    75. - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
    76. + + + + + Rich Comments Support + + + + +
      77. + + + + + + + + + +
    77. diff --git a/merch/index.html b/merch/index.html index ffa510e95..40c801a8e 100644 --- a/merch/index.html +++ b/merch/index.html @@ -611,11 +611,11 @@
    78. - + - Rich Comments Support + The REPL Window @@ -632,11 +632,11 @@
    79. - + - Fiddle Files Support + Evaluation results and outher output @@ -653,11 +653,11 @@
    80. - + - Refactoring + Inspect Evaluation Results and more @@ -674,11 +674,11 @@
    81. - + - Custom REPL Commands + Fiddle Files Support @@ -695,11 +695,11 @@
    82. - + - Custom REPL Connect Sequences + Refactoring @@ -716,11 +716,11 @@
    83. - + - Clojure Notebooks + Custom REPL Commands @@ -737,11 +737,11 @@
    84. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -758,11 +758,11 @@
    85. - + - The REPL Window + Clojure Notebooks @@ -779,11 +779,11 @@
    86. - + - Evaluation results and outher output + ClojureDocs Integration @@ -862,6 +862,27 @@ +
    87. + + + + + Rich Comments Support + + + + +
      88. + + + + + + + + + +
    88. diff --git a/namespace-form-auto-creation/index.html b/namespace-form-auto-creation/index.html index 83c573108..5fb0c02a9 100644 --- a/namespace-form-auto-creation/index.html +++ b/namespace-form-auto-creation/index.html @@ -13,7 +13,7 @@ - + @@ -615,11 +615,11 @@
    89. - + - Rich Comments Support + The REPL Window @@ -636,11 +636,11 @@
    90. - + - Fiddle Files Support + Evaluation results and outher output @@ -657,11 +657,11 @@
    91. - + - Refactoring + Inspect Evaluation Results and more @@ -678,11 +678,11 @@
    92. - + - Custom REPL Commands + Fiddle Files Support @@ -699,11 +699,11 @@
    93. - + - Custom REPL Connect Sequences + Refactoring @@ -720,11 +720,11 @@
    94. - + - Clojure Notebooks + Custom REPL Commands @@ -741,11 +741,11 @@
    95. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -762,11 +762,11 @@
    96. - + - The REPL Window + Clojure Notebooks @@ -783,11 +783,11 @@
    97. - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ + + +
    98. + + + + + Rich Comments Support + + + + +
      99. + + + + + + + + diff --git a/nbb/index.html b/nbb/index.html index 70deb1943..6d79f45a6 100644 --- a/nbb/index.html +++ b/nbb/index.html @@ -613,11 +613,11 @@
    99. - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
    100. - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
    101. - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
    102. - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
    103. - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
    104. - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
    105. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
    106. - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
    107. - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
    108. + + + + + Rich Comments Support + + + + +
      109. + + + + + + + + + +
    109. diff --git a/notebooks/index.html b/notebooks/index.html index 9fdf5f258..aba6f7d15 100644 --- a/notebooks/index.html +++ b/notebooks/index.html @@ -615,11 +615,53 @@
    110. - + - Rich Comments Support + The REPL Window + + + + +
      111. + + + + + + + + + + +
    111. + + + + + Evaluation results and outher output + + + + +
      112. + + + + + + + + + + +
    112. + + + + + Inspect Evaluation Results and more @@ -807,32 +849,11 @@
    113. - - - - - The REPL Window - - - - -
      114. - - - - - - - - - - -
    114. - + - Evaluation results and outher output + Debugger @@ -849,11 +870,11 @@
    115. - + - Debugger + Pretty Printing @@ -870,11 +891,11 @@
    116. - + - Pretty Printing + Test Runner @@ -891,11 +912,11 @@
    117. - + - Test Runner + Rich Comments Support diff --git a/nrepl_and_cider-nrepl/index.html b/nrepl_and_cider-nrepl/index.html index 2ac047dbc..17cb2ac76 100644 --- a/nrepl_and_cider-nrepl/index.html +++ b/nrepl_and_cider-nrepl/index.html @@ -613,11 +613,11 @@
    118. - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
    119. - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
    120. - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
    121. - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
    122. - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
    123. - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
    124. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
    125. - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
    126. - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
    127. + + + + + Rich Comments Support + + + + +
      128. + + + + + + + + + +
    128. diff --git a/output/index.html b/output/index.html index b79f3b101..9456ac4f9 100644 --- a/output/index.html +++ b/output/index.html @@ -16,7 +16,7 @@ - + @@ -615,11 +615,11 @@
    129. - + - Rich Comments Support + The REPL Window @@ -633,18 +633,94 @@ + -
    130. - + +
    131. + + + + + + + + + + + + + Evaluation results and outher output + + + + +
      132. @@ -657,11 +733,11 @@
    132. - + - Refactoring + Inspect Evaluation Results and more @@ -678,11 +754,11 @@
    133. - + - Custom REPL Commands + Fiddle Files Support @@ -699,11 +775,11 @@
    134. - + - Custom REPL Connect Sequences + Refactoring @@ -720,11 +796,11 @@
    135. - + - Clojure Notebooks + Custom REPL Commands @@ -741,11 +817,11 @@
    136. - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -762,11 +838,11 @@
    137. - + - The REPL Window + Clojure Notebooks @@ -780,85 +856,39 @@ - - - - -
    138. - - - - - - - - - - +
    139. + - Evaluation results and outher output + ClojureDocs Integration - - - -
      140. + + + + + - - - + + Debugger + - - + + @@ -871,11 +901,11 @@
    140. - + - Debugger + Pretty Printing @@ -892,11 +922,11 @@
    141. - + - Pretty Printing + Test Runner @@ -913,11 +943,11 @@
    142. - + - Test Runner + Rich Comments Support @@ -1923,6 +1953,15 @@ +
      143. + +
    143. + + + See also + + +
      144. @@ -1977,6 +2016,11 @@

      REPL process output (stdout and s
    144. Anything printed to stdout and stderr by the REPL process

    • diff --git a/search/search_index.json b/search/search_index.json index dc3d07cf4..cc352c008 100644 --- a/search/search_index.json +++ b/search/search_index.json @@ -1 +1 @@ -{"config":{"lang":["en"],"separator":"[\\s\\-\\._]","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Welcome!","text":"

    Calva is an integrated, REPL powered, development environment for enjoyable and productive Clojure and ClojureScript programming in Visual Studio Code. It is feature rich and turnkey. A lot of effort has been put into making Calva a good choice if you are new to Clojure. Calva is open source and free to use.

    "},{"location":"#getting-started","title":"Getting Started","text":"

    Let's start a REPL!. \ud83d\ude80 Also see Get Started with Clojure

    "},{"location":"#how-to-contribute-to-calva","title":"How to Contribute to Calva?","text":"

    I'm glad you asked! Please see How to Contribute and The Tao of Calva

    "},{"location":"#calva-patrons","title":"Calva Patrons","text":"The right kind of different"},{"location":"#calva-gold-sponsors","title":"Calva Gold Sponsors \u2665\ufe0f","text":"Scale your growth on mobile MAKE. DO. SHIP.

    Please see this statement from Cognitect about the importance of supporting open source developers.

    See Sponsors for information about sponsoring Calva.

    If your Company benefits from Calva's existence and you see it as an important in the Clojure and ClojureScript ecosystem. please consider sponsoring!

    "},{"location":"#features","title":"Features","text":"

    Calva includes inline code evaluation, structural editing, code formatting, code navigation, a debugger, linting, syntax highlighting, Clojure aware rainbow brackets, a test runner, refactoring support, and more.

    "},{"location":"#have-questions-and-feedback-need-help","title":"Have Questions and Feedback? Need Help?","text":"

    Easiest way is to chat with us and other Calva users. Please join the #calva channel on the Clojurians Slack. If you haven't joined that slack workspace, you can get an invite here.

    If you're a beginner to Clojure(Script), the #beginners channel of the Clojurians Slack is very active and helpful.

    "},{"location":"#please-star-the-calva-repo","title":"Please star the Calva repo!","text":"

    Happy coding!

    "},{"location":"api/","title":"The Calva Extension API","text":"

    Calva exposes an API for use from other VS Code extensions (such as Joyride). The API is in an experimental state, while we are figuring out what is a good shape for this API. It is also rather small, and will grow to expose more of Calva's functionality.

    ","boost":7},{"location":"api/#accessing","title":"Accessing","text":"

    To access the API the Calva extension needs to be activated. The API is exposed under the v1 key on the extension's exports, and split up into submodules, like repl, and ranges.

    When using Joyride you can use its unique require API, for which one of the benefits is better lookup IDE support. When using the API from regular ClojureScript, you'll pick it up from the Calva extension instance. (Which you can do from Joyride as well, but why would you?). Here is how you access the API, with an example of usage as a bonus:

    JoyrideClojureScriptJavaScript 
    (ns ... (:require [\"ext://betterthantomorrow.calva$v1\" :as calva]))\n;; OR\n(require '[\"ext://betterthantomorrow.calva$v1\" :as calva])\n\n(calva/repl.currentSessionKey) => \"cljs\" ; or \"clj\", depending\n
    (def calvaExt (vscode/extensions.getExtension \"betterthantomorrow.calva\"))\n\n(def calva (-> calvaExt\n             .-exports\n             .-v1\n             (js->clj :keywordize-keys true)))\n\n((get-in calva [:repl :currentSessionKey])) => \"cljs\" ; or \"clj\", depending\n
    const calvaExt = vscode.extensions.getExtension(\"betterthantomorrow.calva\");\n\nconst calva = calvaExt.exports.v1;\n\nconst sessionKey = calva.repl.currentSessionKey()\n
    ","boost":7},{"location":"api/#repl","title":"repl","text":"

    The repl module provides access to Calva's REPL connection.

    ","boost":7},{"location":"api/#replcurrentsessionkey","title":"repl.currentSessionKey()","text":"

    Use repl.currentSessionKey() find out which REPL/session Calva's REPL is currently connected to (depends on the active file). Returns either \"clj\", or \"cljs\", or nil if no REPL is connected.

    JoyrideClojureScriptJavaScript 
    (def session-key (calva/repl.currentSessionKey))\n
    (def session-key ((get-in [:repl :currentSessionKey] calvaApi)))\n
    const sessionKey = calva.repl.currentSessionKey()\n
    ","boost":7},{"location":"api/#replevaluatecode","title":"repl.evaluateCode()","text":"

    This function lets you evaluate Clojure code through Calva's nREPL connection. Calling it returns a promise that resolves to a Result object. It's signature looks like so (TypeScript):

    export async function evaluateCode(\n  sessionKey: 'clj' | 'cljs' | 'cljc' | undefined,\n  code: string,\n  ns = 'user',\n  output?: {\n    stdout: (m: string) => void;\n    stderr: (m: string) => void;\n  },\n  opts = {}\n): Promise<Result>;\n

    Where Result is:

    type Result = {\n  result: string;\n  ns: string;\n  output: string;\n  errorOutput: string;\n};\n

    As you can see, the required arguments to the function are sessionKey and code. sessionKey should be \"clj\", \"cljs\", \"cljc\", or undefined depending on which of Calva's REPL sessions/connections that should be used. It will depend on your project, and how you connect to it, which session keys are valid. Use cljc to request whatever REPL session \"cljc\" files are connected to. Use undefined to use the current REPL connection Calva would use (depends on which file is active).

    An example:

    JoyrideClojureScriptJavaScript 
    (-> (p/let [evaluation (calva/repl.evaluateCode \"clj\" \"(+ 2 40)\")]\n      (println (.-result evaluation)))\n    (p/catch (fn [e]\n               (println \"Evaluation error:\" e))))\n
    (def evaluate (get-in [:repl :evaluateCode] calvaApi))\n(-> (p/let [evaluation (evaluate \"clj\" \"(+ 2 40)\")]\n      (println (.-result evaluation)))\n    (p/catch (fn [e]\n               (println \"Evaluation error:\" e))))\n
    try {\n  const evaluation = await calvaApi.repl.evaluateCode(\"clj\", \"(+ 2 40)\");\n  console.log(evaluation.result);\n} catch (e) {\n  console.error(\"Evaluation error:\", e);\n}\n
    ","boost":7},{"location":"api/#handling-output","title":"Handling Output","text":"

    The output member on the Result object will have any output produced during evaluation. (The errorOutput member should contain error output produced, but currently some Calva bug makes this not work.) By default the stdout and stderr output is not printed anywhere.

    If you want to do something with either regular output or error output during, or after, evaluation, you'll need to provide the output argument to evaluateCode(). (The stderr callback function works, so this is the only way to get at any error output, until the above mentioned Calva bug is fixed.)

    An example:

    JoyrideClojureScriptJavaScript 
    (def oc (joyride.core/output-channel)) ;; Assuming Joyride is used\n(def evaluate (fn [code]\n                (calva/repl.evaluateCode\n                 \"clj\"\n                 code\n                 \"user\"\n                 #js {:stdout #(.append oc %)\n                      :stderr #(.append oc (str \"Error: \" %))})))\n\n(-> (p/let [evaluation (evaluate \"(println :foo) (+ 2 40)\")]\n      (.appendLine oc (str \"=> \" (.-result evaluation))))\n    (p/catch (fn [e]\n               (.appendLine oc (str \"Evaluation error: \" e)))))\n
    (def oc (joyride.core/output-channel)) ;; Assuming Joyride is used\n(def evaluate (fn [code]\n                ((get-in [:repl :evaluateCode] calvaApi)\n                 \"clj\"\n                 code\n                 \"user\"\n                 #js {:stdout #(.append oc %)\n                      :stderr #(.append oc (str \"Error: \" %))})))\n\n(-> (p/let [evaluation (evaluate \"(println :foo) (+ 2 40)\")]\n      (.appendLine oc (str \"=> \" (.-result evaluation))))\n    (p/catch (fn [e]\n               (.appendLine oc (str \"Evaluation error: \" e)))))\n
    const evaluate = (code) =>\n  calvaApi.repl.evaluateCode(\"clj\", code, \"user\", {\n    stdout: (s) => {\n      console.log(s);\n    },\n    stderr: (s) => {\n      console.error(s);\n    },\n  });\n\ntry {\n  const evaluation = await evaluate(\"(println :foo) (+ 2 40)\");\n  console.log(\"=>\", evaluation.result);\n} catch (e) {\n  console.error(\"Evaluation error:\", e);\n}\n
    ","boost":7},{"location":"api/#ranges","title":"ranges","text":"

    The ranges module contains functions for retreiving vscode.Ranges and text for pieces of interest in a Clojure document.

    All functions in this module have the following TypeScript signature:

    (editor = vscode.window.activeTextEditor, position = editor?.selection?.active) => [vscode.Range, string];\n

    I.e. they expect a vscode.TextEditor \u2013 defaulting to the currently active editor \u2013 and a vscode.Position \u2013 defaulting to the current active position in the editor (or the first active position if multiple selections/positions exist, and will return a tuple with the range, and the text for the piece of interest requested.

    Custom REPL Commands

    The ranges function have corresponding REPL Snippets/Commands substitution variables. It is the same implementation functions used in both cases.

    The functions available are:

    ","boost":7},{"location":"api/#rangescurrentform","title":"ranges.currentForm()","text":"

    Retrieves information about the current form, as determined from the editor and position.

    Corresponding REPL Snippet variable: $current-form.

    See also about Calva's Current Form on YouTube.

    ","boost":7},{"location":"api/#rangescurrentenclosingform","title":"ranges.currentEnclosingForm()","text":"

    The list/vector/etcetera form comtaining the current form.

    Corresponding REPL Snippet variable: $enclosing-form.

    ","boost":7},{"location":"api/#rangescurrenttoplevelform","title":"ranges.currentTopLevelForm()","text":"

    The current top level form. Outside (comment ...) (Rich comments) forms this is most often ((def ...), (defgn ...), etcetera. Inside Rich comments it will be the current immediate child to the (comment ...) form.

    Corresponding REPL Snippet variable: $top-level-form.

    ","boost":7},{"location":"api/#rangescurrentfunction","title":"ranges.currentFunction()","text":"

    The current function, i.e. the form in \u201dcall position\u201d of the closest enclosing list.

    Corresponding REPL Snippet variable: $current-fn.

    ","boost":7},{"location":"api/#rangescurrenttopleveldef","title":"ranges.currentTopLevelDef()","text":"

    The symbol being defined by the current top level form. NB: Will stupidly assume it is the second form. I.e. it does not check that it is an actual definition, and will often return nonsense if used in Rich comments.

    Corresponding REPL Snippet variable: $top-level-defined-symbol.

    ","boost":7},{"location":"api/#example-rangescurrenttoplevelform","title":"Example: ranges.currentTopLevelForm()","text":"JoyrideClojureScriptJavaScript 
    (let [[range text] (calva/ranges.currentTopLevelForm)]\n  ...)\n
    (let [[range text] ((get-in [:ranges :currentTopLevelForm]))]\n  ...)\n
    const [range, text] = ranges.currentTopLevelForm();\n
    ","boost":7},{"location":"api/#editor","title":"editor","text":"

    The editor module has facilites (well, a facility, so far) for editing Clojure documents.

    ","boost":7},{"location":"api/#editorreplace","title":"editor.replace()","text":"

    With editor.replace() you can replace a range in a Clojure editor with new text. The arguments are:

    JoyrideJavaScript 
    (-> (p/let [top-level-form-range (first (calva/ranges.currentTopLevelForm))\n            _ (calva/editor.replace vscode/window.activeTextEditor top-level-form-range \"Some new text\")]\n      (println \"Text replaced!\"))\n    (p/catch (fn [e]\n               (println \"Error replacing text:\" e))))\n
    const topLevelRange = calvaApi.ranges.currentTopLevelForm();\ncalva.editor.replace(topLevelRange, \"Some new text\")\n  .then((_) => console.log(\"Text replaced!\"))\n  .catch((e) => console.log(\"Error replacing text:\", e));\n
    ","boost":7},{"location":"api/#document","title":"document","text":"

    The document module provides access to the Clojure/Calva aspects of VS Code TextDocuments.

    ","boost":7},{"location":"api/#documentgetnamespacedocument-vscodetextdocument-string","title":"document.getNamespace(document?: vscode.TextDocument): string","text":"

    document.getNamespace() returns the namespace of a document.

    Example usage. To evaluate some code in the namespace of the current document:

    JoyrideJavaScript 
    (calva/repl.evaluateCode \"clj\" \"(+ 1 2 39)\" (calva/document.getNamespace))\n
    calva.repl.evaluateCode(\"clj\",  \"(+ 1 2 39)\", calva.document.getNamespace());\n
    ","boost":7},{"location":"api/#documentgetnamespaceandnsformdocument-vscodetextdocument-ns-string-nsform-string","title":"document.getNamespaceAndNsForm(document?: vscode.TextDocument): [ns: string, nsForm: string]","text":"

    document.getNamespaceAndNsForm() returns the namespace and the ns form of a document as a tuple.

    Example usage. To evaluate the ns form of the current document:

    JoyrideJavaScript 
    (calva/repl.evaluateCode \"clj\" (second (calva/document.getNamespaceAndNsForm)))\n
    calva.repl.evaluateCode(\"clj\", calva.document.getNamespaceAndNsForm()[1]);\n
    ","boost":7},{"location":"api/#pprint","title":"pprint","text":"

    The pprint module lets you pretty print Clojure code/data using Calva's pretty printing engine (which in turn uses zprint).

    ","boost":7},{"location":"api/#pprintprettyprint","title":"pprint.prettyPrint()","text":"

    Use pprint.prettyPrint() to pretty print some Clojure data using your Calva pretty printing options. It accepts these arguments:

    The function is synchronous and returns the prettified text.

    JoyrideJavaScript 
    (println (calva/pprint.prettyPrint \"Some text\")))\n
    console.log(calvaApi.pprint.prettyPrint();\n
    ","boost":7},{"location":"api/#pprintprettyprintingoptions","title":"pprint.prettyPrintingOptions()","text":"

    Use to get the current pretty printint options:

    ","boost":7},{"location":"api/#vscode","title":"vscode","text":"

    In the its vscode submodule, Calva exposes access to things from its own vscode module instance. It gets important in some situations.

    ","boost":7},{"location":"api/#vscoderegisterdocumentsymbolprovider","title":"vscode.registerDocumentSymbolProvider()","text":"

    This is the [vscode.languages](https://code.visualstudio.com/api/references/vscode-api#languages).registerDocumentSymbolProvider() function from the Calva extension. Use it if you want to provide symbols for Clojure files together with the ones that Calva provides. (If you use the vscode.languages.registerDocumentSymbolProvider() function from your extension (or Joyride) you will provide a separate group.)

    JoyrideClojureScriptJavaScript 
    (-> (joyride/extension-context)\n  .-subscriptions\n  (.push (calva/vscode.registerDocumentSymbolProvider ...)))\n
    (-> yourExtensionContext\n  .-subscriptions\n  (.push ((get-in calva [:vscode :registerDocumentSymbolProvider]) ...)))\n
    yourExtensionContext.subscriptions.push(calva.vscode.registerDocumentSymbolProvider(...));\n

    Deprecation candidate

    VS Code is still creating a separate group, just with the same name as Calva's, so this API is not good for anything, and we will probably remove it.

    ","boost":7},{"location":"api/#feedback-welcome","title":"Feedback Welcome","text":"

    Please let us know how you fare using this API. Either in the #calva or #joyride channels on Slack or via the issues/discussions sections on the repositories. (Whichever seems to apply best.)

    ","boost":7},{"location":"async-out/","title":"Viewing Async Output While Working On Node Projects with shadow-cljs","text":"

    When working on NodeJS projects with shadow-cljs and Calva, async output does not always appear in the Calva output window. To work around this problem, follow these steps:

    1. Run the command \"Calva: Copy Jack-in Command Line to Clipboard\", then paste the command in a terminal and run it.
    2. Wait for the message shadow-cljs - nREPL server started on port <some-port>
    3. Issue the command Calva: Connect to a running REPL server in your project, ctrl+alt+c ctrl+alt+c. For project type select shadow-cljs, accept the proposed localhost:<some-port>, and for build select node-repl.
    4. Load a file from your project with the command ctrl+alt+c Enter. Evaluating forms in Calva will show results in the output window. Synchronous stdout output will be printed in both the output window and in the terminal where you started the repl. Some asynchronous output may show up in the output window, but all will appear in the terminal.

    If you use an integrated VSCode terminal to start shadow-cljs, all stdout will appear in the Calva window with your code. Alternatively, you can use an external terminal, which is especially nice when using a second monitor.

    For a discussion of this problem and other connection options, see issue #1468.

    "},{"location":"babashka/","title":"Using Calva with Babashka","text":"

    Since Babashka can be started such that it is an nREPL server, Calva can connect to it and a lot of the features will work.

    Calva can also start Babashka and connect its REPL for you, using the Jack-in command.

    Don't expect complete support

    Babashka's nREPL server is still a bit limited compared to a full cider-nrepl enhanced \"regular\" Clojure nREPL server. Things like function signatures, and more do not work.

    This might of course improve in the future, especially if you provide some PRs towards the Babashka nREPL.

    ","boost":5},{"location":"clj-java-decompiler/","title":"Decompiling and disassembly made easy","text":"

    If you need some piece of Clojure code to execute as fast as possible you will often benefit from examining the code generated by the Clojure compiler from your code. There is a really easy to use tool for that: clj-java-decompiler. You can make the use of this tool super convenient with Calva custom command snippets.

    "},{"location":"clj-java-decompiler/#prerequisites","title":"Prerequisites","text":"

    Add com.clojure-goes-fast/clj-java-decompiler as a dependency to the project.

    "},{"location":"clj-java-decompiler/#the-custom-snippets","title":"The custom snippets","text":"

    You can add some Calva custom commands configuration to be able to decompile or disassemble any Clojure code in your editor with a keyboard shortcut. Here's an example configuration:

        \"calva.customREPLCommandSnippets\": [\n        {\n            \"name\": \"Decompile current top level form\",\n            \"key\": \"d\",\n            \"snippet\": \"(require '[clj-java-decompiler.core :refer [decompile]]) (spit \\\"decompiled-$top-level-defined-symbol.java\\\" (with-out-str (decompile $top-level-form)))\"\n        },\n        {\n            \"name\": \"Decompile current form\",\n            \"snippet\": \"(require '[clj-java-decompiler.core :refer [decompile]]) (spit \\\"decompiled.java\\\" (with-out-str (decompile $current-form)))\"\n        },\n        {\n            \"name\": \"Disassemble current top level form\",\n            \"key\": \"b\",\n            \"snippet\": \"(require '[clj-java-decompiler.core :refer [disassemble]]) (spit \\\"bytecode-$top-level-defined-symbol.class\\\" (with-out-str (disassemble $top-level-form)))\"\n        },\n        {\n            \"name\": \"Disassemble current current form\",\n            \"snippet\": \"(require '[clj-java-decompiler.core :refer [disassemble]]) (spit \\\"bytecode.class\\\" (with-out-str (disassemble $current-form)))\"\n        }\n    ],\n

    Now, with the cursor anywhere in a top level defined function, you can spit out a file with the Java code generated for that function by pressing ctrl+alt+space d. For the byte code, press ctrl+alt+space b. The files will be generated in the same folder as the Clojure file and be named decompiled-<function name>.java and bytecode-<function name>.class, respectively.

    To decompile or disassemble the current form (or selection) press ctrl+alt+space space and pick the desired command from the quick pick menu that pops up. You can add key to these too if you want even quicker access, of course. The filenames for the results will here be named without any function name suffix, because there is often no function name that can be used.

    See this video for a demo.

    "},{"location":"clojure-lsp/","title":"Clojure-lsp","text":"

    Calva uses a mix of static and dynamic analysis to power the experience. A lot of the static abilities come from clojure-lsp. This enables you to check something up in a project, with a lot of navigational and contextual support, without starting a REPL for it. (And once you do start a REPL you'll get even more capabilities, enabled by the dynamic analysis.)

    Which clojure-lsp does Calva use?

    Calva defaults to using the latest clojure-lsp released. To use a different version of clojure-lsp, see the configuration section. Calva does not use the clojure-lsp installed on your system, unless you set the path for clojure-lsp to the installed binary in your settings. You can see what version is being used by running the Clojure-lsp Server Info command, which will also show the version of clj-kondo that's being used as well as other info.

    "},{"location":"clojure-lsp/#the-lsp-server-lifecycle","title":"The LSP server lifecycle","text":"

    By default you won't need to install/setup anything as Calva handles that for you by automatically downloading the latest clojure-lsp binary. It can take a while for clojure-lsp to start, especially the first time opening a new project, as clojure-lsp (via clj-kondo) indexes the project files.

    Calva is able to automatically start the clojure-lsp server for you and can be configured to start the server under various different conditions. These behaviours can be configured through the calva.enableClojureLspOnStart setting, which takes the following options:

    "},{"location":"clojure-lsp/#always-use-first-workspace-root-default","title":"\"always-use-first-workspace-root\" [default]","text":"

    When set to \"always-use-first-workspace-root\" Calva will attempt to start the clojure-lsp in the root of the first workspace folder if it is a valid clojure project. If it is not a valid clojure project it will fall back to starting the fallback server.

    This is the default auto-start behaviour.

    "},{"location":"clojure-lsp/#when-workspace-opened-use-workspace-root","title":"\"when-workspace-opened-use-workspace-root\"","text":"

    When set to \"when-workspace-opened-use-workspace-root\" Calva will start the clojure-lsp in the root of all opened vscode workspaces. All Clojure files in a workspace will be serviced by the clojure-lsp server running in that workspace. This behavior requires that you are opening workspaces with a valid Clojure project in the root (the directory must contain a deps.edn, project.clj or shadow-cljs.edn file).

    "},{"location":"clojure-lsp/#when-file-opened-use-furthest-project","title":"\"when-file-opened-use-furthest-project\"","text":"

    When set to \"when-file-opened-use-furthest-project\" Calva will attempt to start the clojure-lsp server whenever a Clojure file is opened. The LSP server will be started in the outermost valid Clojure project or will fall back to starting in the workspace root if no valid Clojure project can be found. A directory is considered a Clojure project if it contains typical Clojure project files such as a deps.edn, project.clj, or shadow-cljs.edn file. When working in a mono-repo style project or in a multi-workspace VS Code configuration you may have multiple LSP servers running, one for each independent Clojure project opened.

    Opening files that do not belong to a workspace folder

    When opening files that do not belong to any of the workspace folders currently open then Calva will fallback to starting the fallback clojure-lsp server

    "},{"location":"clojure-lsp/#never","title":"\"never\"","text":"

    When set to \"never\" Calva will never attempt to automatically start the clojure-lsp server. In this case you are responsible for manually starting the server. More advanced users might want to do this in order to have more control over which projects have a clojure-lsp server running for them. To manually start the clojure-lsp server you can run the calva.clojureLsp.start or the calva.clojureLsp.manage command and pick the project root. You can also click the clojure-lsp status bar icon to open the Management Menu.

    Additionally Calva has commands for:

    Note that the download command will download the configured clojure-lsp version regardless if it is already installed or not. This can be useful when some earlier download has failed resulting in that clojure-lsp can't be started. NB: It will not download anything if calva.clojureLspPath is set to something non-blank.

    "},{"location":"clojure-lsp/#fallback-server","title":"Fallback Server","text":"

    As a fallback behaviour Calva may start a clojure-lsp server in a temporary directory and use this to service lsp requests for clojure files that do not belong to a valid clojure project. This will show up in the management menu looking something like:

    Any files that are handled by this server will have limited classpath analysis and lsp features. It is therefore recommended to setup your project as a clojure project (by creating a deps.edn file in the root, for example).

    "},{"location":"clojure-lsp/#status-bar","title":"Status bar","text":"

    In the status bar Calva will show an indicator with the clojure-lsp status. This status will track the currently open project, showing the status (stopped, starting or active) for the relevant clojure-lsp server.

    You can click on the status-bar item to open the clojure-lsp management menu which will look as follows:

    The menu shows which clojure-lsp servers are active and which are stopped. Selecting a project will allow you to start/stop/restart the server for that project.

    "},{"location":"clojure-lsp/#ignoring-lsp-cache-files","title":"Ignoring LSP cache files","text":"

    Clojure-lsp stores its project analysis information in your project. Git users can add these lines to their project root directory .gitignore:

    .lsp/.cache/\n.lsp/sqlite.*.db\n
    "},{"location":"clojure-lsp/#configuration","title":"Configuration","text":"

    For information about how to configure clojure-lsp, see the settings page of the clojure-lsp docs.

    "},{"location":"clojure-lsp/#changing-the-version-of-clojure-lsp-used-by-calva","title":"Changing the Version of Clojure-lsp Used by Calva","text":"

    By default, Calva will use the latest released clojure-lsp. You can change the version of clojure-lsp used by Calva by setting the calva.clojureLspVersion property to a version of clojure-lsp found in its GitHub releases. This can be helpful if you're debugging an issue with clojure-lsp or you want to try out a feature of a new release that Calva does not yet use. However, you must remember to reset this setting in order for Calva to automatically use newer versions of clojure-lsp that are released with new versions of Calva.

    Example:

    \"calva.clojureLspVersion\": \"2021.04.07-16.34.10\"\n

    Special \u201dversion\u201d values

    Apart from the actual versions you can use two special values for this setting:

    "},{"location":"clojure-lsp/#using-a-custom-clojure-lsp","title":"Using a Custom Clojure-lsp","text":"

    You can set a path to a custom clojure-lsp to be used by Calva by configuring the calva.clojureLspPath setting. This should be an absolute path to a native binary or JAR file.

    Example:

    \"calva.clojureLspPath\": \"/usr/local/bin/clojure-lsp\"\n

    Will override any calva.clojureLspVersion setting

    When calva.clojureLspPath is set, the binary at the path will be used uncoditionally, and the calva.clojureLspVersion setting will be ignored.

    "},{"location":"clojure-lsp/#extra-commands","title":"Extra commands","text":"

    clojure-lsp provides many useful [commands], and Calva has configuration for most of them. The clojure-lsp team works fast and sometimes Calva might miss some command. And Calva's configuration only really work for clojure-lsp commands that take no argument, or where it makes sense to prompt for the argument. Therefore Calva provides a generic command id, clojure-lsp.command which can be used with keyboard shortcuts and that allow for providing arguments that way. (The command can be used from Joyride too, of course.)

    When using the command, provide the args as an tuple of [command-name, arguments], where arguments is an array of any arguments after file-uri, row, col which are common for all clojure-lsp extra commands and are provided automatically by Calva, based on active text editor and where the cursor is. It can look like so when binding a shortcut for extract-function:

        {\n        \"key\": \"ctrl+alt+r f\",\n        \"command\": \"clojure-lsp.command\",\n        \"args\": [\"extract-function\", [\"new-function\"]]\n    },\n

    Note that even though extract-function takes only one argument, you should still provide it via an array.

    "},{"location":"clojure-lsp/#troubleshooting","title":"Troubleshooting","text":""},{"location":"clojure-lsp/#viewing-the-logs-between-the-client-and-server","title":"Viewing the Logs Between the Client and Server","text":"

    If something doesn't seem to be working correctly, and you suspect the issue is related to clojure-lsp, a good place to start investigating is the request and response logs between the LSP client and server. In your settings, set clojure.trace.server to verbose, then in the VS Code output tab, select the Clojure Language Client output channel.

    It may be helpful to clear the output channel, then perform the action with which you're experiencing a problem, then read through the log for clues or paste the logs into a related issue in the Calva repo.

    "},{"location":"clojure-lsp/#server-info-command","title":"Server Info Command","text":"

    You can run the Clojure-lsp Server Info command to get information about the running clojure-lsp server, such as the version the server being used, the version of clj-kondo it's using, and more. This info is printed to the \"Calva says\" output channel.

    "},{"location":"clojure-lsp/#opening-the-server-log-file","title":"Opening the Server Log File","text":"

    You can open the clojure-lsp log file by running the command Calva Diagnostics: Open Clojure-lsp Log File. The log file will only be opened with this command if the clojure-lsp server is running and has finished initializing. If you need to open the file when the server is failing to run or initialize, see the clojure-lsp docs for information on the file location.

    "},{"location":"clojure-lsp/#server-initialization-failed","title":"Server initialization failed","text":"

    If clojure-lsp fails to start with \u201cServer initialization failed\u201d messages, it could be because the path to your project contains non-ASCII characters, or that the system PATH variable has been corrupted. (Or something else, of course.)

    See this issue for some findings about it: Issue #2251: Server initialization failed error

    "},{"location":"clojure-lsp/#related","title":"Related","text":"

    See also:

    "},{"location":"clojuredart/","title":"Using Calva with ClojureDart","text":"

    Since ClojureDart is Clojure, Calva just works with it. Calva is also automatically configured to make VS COde treat .cljd files as a Clojure code.

    ","boost":4},{"location":"clojuredart/#dart-clojure-conversion","title":"Dart->Clojure Conversion","text":"

    Similar to when using ClojureScript you will often find examples for Dart and Flutter written in, you guessed it, Dart. And then you will often wish there was a converter, because manually transpiling can be a bit tedious and error prone. Luckily you are in the Clojure community, and such a converter is provided:

    There are several ways you can leverage this converter, and since you are using Calva, a very convenient way is available. There is a command Calva: Convert Dart code to Clojure/ClojureDart. This command takes whatever text is selected and uses DartClojure to convert it. Lacking a selection, the command will use the whole file.

    The workflow demoed in the video is something like so:

    1. Open a new untitled file/tab
    2. Paste your Dart/Flutter code in this file (VS Code will probably automatically figure out that it is Dart code, even if that doesn't matter for the converter.)
    3. Run Calva: Convert Dart code to Clojure/ClojureDart
    4. An, untitled, Clojure tab will open with the converted code in it.

    NB: The conversion will not always work. DartCLojure is work in progress. See the project repo for limitations and scope. Often when conversion, the error message will give you a clue to what is problematic. Try adjust your code selection and you will probably be able to get at least some help from the converter.

    Speaking of WIP...

    ","boost":4},{"location":"clojuredart/#work-in-progress","title":"Work in Progress","text":"

    ClojureDart is very new and being super actively developed. Some feature are still missing. Like a REPL. Once that is added we will also add ClojureDart jack-in and connect support to Calva.

    ","boost":4},{"location":"clojuredart/#happy-clojuredart-hacking","title":"Happy ClojureDart Hacking!","text":"

    Please feel welcome to the #clojuredart and #calva channel at the Clojurians Slack for questions, suggestions and support.

    ","boost":4},{"location":"clojuredocs/","title":"ClojureDocs integration","text":"

    clojuredocs.org is the goto place #1 for finding out more about Clojure core(-ish) functions, macros, etcetera. It contains the doc strings from the functions and adds crowd sourced examples of usage and see alsos. You can surf for quite long on that site without getting bored. \ud83d\ude04

    You can surf ClojureDocs in Calva

    Calva integrates this information in two ways:

    1. Commands for requesting the ClojureDocs information for a symbol under the cursor:
      • Print clojuredocs.org examples to Rich Comment, default keybinding: ctrl+alt+r d
      • Print clojuredocs.org examples to OutputWindow, ctrl+alt+o d
    2. ClojureDocs information is included in the symbol lookup hovers, where each example has two buttons:
      • To Rich Comment
      • To Output Window

    That means that if you just want to glance at the examples, you look in the hover. And when you want to bring the examples to the REPL to play with them, you can do so very easily.

    ClojureScript support

    ClojureDocs information is available both for Clojure and ClojureScript files. However, clojuredocs.org only keeps info for Clojure. Thus: All information Calva shows about a symbol will be about the Clojure respresentation of that symbol. (The symbol might not even exist in ClojureScript.)

    ","boost":4},{"location":"clojuredocs/#clojuredocs-repl-surfing","title":"ClojureDocs REPL Surfing","text":"

    Since the ClojureDocs information includes see-alsos, you can go for super interactive ClojureDocs surfing right in the file you are editing. Say you have this function:

    (defn trim-text\n  \"Returns text without surrounding whitespace if not empty, otherwise nil\"\n  [text]\n  (let [trimmed-text (clojure.string/trim text)]\n    (when-not (empty? trimmed-text)\n      trimmed-text)))\n

    Then you hover on when-not and scroll down a bit in the hover:

    That first example would be interesting to play with, right? Click To Rich Comment and you will get:

    (defn trim-text\n  \"Returns text without surrounding whitespace if not empty, otherwise nil\"\n  [text]\n  (let [trimmed-text (clojure.string/trim text)]\n    (when-not (empty? trimmed-text)\n      trimmed-text)))\n\n(comment\n  ;; = when-not - Example 1 = \n\n  ;; build tuples over sets with the same cardinality \n  (map\n   #(when-not (= %2 %3) [%1 %2 %3])\n   (iterate inc 0)   ; a lazy list of indices\n   [:a :b :c]\n   [:a :a :a])\n  ;;=> (nil [1 :b :a] [2 :c :a])\n\n  ;; See also:\n  when\n  when-let\n  if\n  )\n

    There you can evaluate the (map ...) form using alt+enter, modify it and evaluate again. You can also hover over map, iterate, or any of the \u201dSee also:\u201d symbols to find more fun examples to play with. And so on and so forth.

    See these two tweets for some videos of early versions of this functionality:

    Please retweet!

    ","boost":4},{"location":"clojuredocs/#quirks","title":"Quirks","text":"

    Some of the ClojureDocs entries have text that is not really Clojure code, and sometimes even structural errors. This can break the structural integrity of your Clojure file. If you run into trouble trying to heal things, you can always use Undo until the Rich Comment is gone.

    ","boost":4},{"location":"commands-top10/","title":"The Top 10 Calva Commands","text":"

    There are not all that many Calva commands. You can learn them all if you like, but here are the most important ones to know about for effective Clojure/ClojureScript coding:

    There are also two commands for bringing over the current form and the current top level form over to the repl window:

    You can also switch the name space of the output/repl window to that of the current file: alt+ctrl+c alt+n

    "},{"location":"commands-top10/#some-more-commands-to-try","title":"Some More Commands to Try","text":"

    See also:

    "},{"location":"connect-sequences/","title":"REPL Jack-in and Connect Sequences","text":"

    Many projects grow out of the template phase and call for custom developer workflows involving application start commands, customized REPLs, and what have you. Even some templates add this kind of complexity. To make Jack-in usable for a broader set of projects, Calva has a setting keyed calva.replConnectSequences which lets you configure one ore more connect sequences.

    NB: Connect sequence configuration affects Calva's Jack-in menu in the following ways:

    1. With no sequence configured, Calva will prompt for the built-in sequences it has that seems to match your project.
    2. When any number of connection sequences are configured, Calva will prompt for your custom sequences, as well as the built-in sequences. Whether built-in or custom, only sequences relevant to your project will be included in the prompt.
    ","boost":6},{"location":"connect-sequences/#settings-for-adding-custom-sequences","title":"Settings for adding Custom Sequences","text":"

    A connect sequence configures the following:

    The Calva built-in sequences also use this format, check them out to get a clearer picture of how these settings work.

    Force the project type menu to show

    The convenience of autoSelectForJackIn/Connect can be an inconvenience when you want to use another project type/sequence for a project. For this reason, the calva.connect and calva.jackIn can be provided with an option disableAutoSelect, which forces the project root and project type menus to show. See Options for the Connect Command and Options for the Jack-in Command for more on this.

    Path segments

    projectRootPath and nReplPortFile both take an array of path segments. This is to make the paths work cross-platform. If you can't be bothered splitting up the path in segments, put the whole path in the first segment, though please note that if you use Windows path separators, these will not work for users with Linux or macOS.

    ","boost":6},{"location":"connect-sequences/#custom-command-line","title":"Custom Command Line","text":"

    Custom command lines are there to bridge the gap to those situations where standard Jack-in command lines don't reach. Like:

    1. You want to provide command line options to a supported tool, which Jack-in does not provide
    2. Your project has some script through which it is started
    3. The REPL is provided by some tool that Calva does not know of
    4. Any other reason...

    A custom command line is executed from same directory as the REPL project root (See projectRootPath, above), and can be as simple as my-repl-jack-in-command. You can use a relative or absolute path to your command line.

    If your custom command line starts a REPL of a project type that is not \u201dknown\u201d/built-in to Calva, use custom as the projectType for the connect sequence.

    ","boost":6},{"location":"connect-sequences/#custom-command-line-substitutionsplaceholdersenvironment-variables","title":"Custom Command Line Substitutions/Placeholders/Environment variables","text":"

    You can use placeholders in your command line, and Calva will substitute them before executing the command. All these placeholders will also be provided to your script via environment variables with the same names (except dashes will be underscores in the env variable names):

    nREPL dependency versions:

    Paths:

    Depending on the project type Calva will also look for these placeholders:

    ","boost":6},{"location":"connect-sequences/#example-custom-jack-in-command-lines","title":"Example Custom Jack-in Command lines","text":"","boost":6},{"location":"connect-sequences/#start-a-babashka-repl-via-wsl","title":"Start a Babashka REPL via WSL","text":"

    Calva has a built-in jack-in sequence for starting a Babashka REPL and connect to it. It works as long as the bb process is on the same host as VS Code/Calva is running. So if you want it to run in WSL, but VS Code is running on your computer you need to start bb slightly differently. These settings in your VS Code settings file will give you a jack-in option that works for this:

      \"calva.replConnectSequences\": [\n    {\n        \"name\": \"Bashbabka (WSL)\",\n        \"projectType\": \"custom\",\n        \"customJackInCommandLine\": \"bash -c 'bb --nrepl-server JACK-IN-NREPL-PORT'\",\n    },\n  ],\n

    If you place it in your user settings you will have access to it from any workspace.

    ","boost":6},{"location":"connect-sequences/#an-exampleskeleton-script","title":"An example/skeleton script","text":"

    This script doesn't actually start a REPL, it's provided more for giving you an idea about what it could look like, and as a starting point for your real scripts:

    #!/usr/bin/env bb\n\n(require '[clojure.string :as str])\n\n(defn parse-args [args]\n  (loop [args args\n         parsed {}]\n    (if (empty? args)\n      parsed\n      (let [[flag value & rest-args] args]\n        (case flag\n          \"--aliases\" (recur rest-args (assoc parsed :aliases value))\n          \"--cider-nrepl-version\" (recur rest-args (assoc parsed :cider-nrepl-version value))\n          (do (println \"Unknown parameter:\" flag) (System/exit 1)))))))\n\n(defn process-args [args]\n  (let [aliases (str/split (:aliases args) #\",\")\n        cider-nrepl-version (:cider-nrepl-version args)\n        project-root-path (System/getenv \"JACK_IN_PROJECT_ROOT_PATH\")]\n    (println \"Aliases:\")\n    (doseq [alias aliases]\n      (println alias))\n    (println \"CIDER nREPL version:\" cider-nrepl-version)\n    (println \"JACK_IN_PROJECT_ROOT_PATH:\" project-root-path)))\n\n(def parsed-args (parse-args *command-line-args*))\n\n(when (= *file* (System/getProperty \"babashka.file\"))\n  (process-args parsed-args))\n

    It's written in Babashka to encourage you to write your shell scripts in a civilized language. \ud83d\ude00 See the article Changing my mind: Converting a script from bash to Babashka for a small success-story about this mindset. See also bash2bb.

    The script reads JACK-IN-CLJS-LAUNCH-BUILDS and JACK-IN-CIDER-NREPL-VERSION from the command line, and JACK_IN_PROJECT_ROOT_PATH from the environment. It could be configured for use in a custom connect sequence like this:

        \"customJackInCommandLine\": \"../../custom-jack-in.bb --aliases JACK-IN-CLJS-LAUNCH-BUILDS --cider-nrepl-version JACK-IN-CIDER-NREPL-VERSION\",\n

    Note how in this case the REPL is started two directories \u201ddown\u201d from the workspace root where the script resides.

    ","boost":6},{"location":"connect-sequences/#example-sequences","title":"Example Sequences","text":"

    Whether you just want to speed up your workflow or encode some workflow/mechanics into it, it's often the case that you can create a custom sequence that helps.

    ","boost":6},{"location":"connect-sequences/#minimal-menus-with-full-stack-shadow-cljs-repls","title":"Minimal menus with full stack shadow-cljs REPLs","text":"

    Minimize the amount of selecting from the Jack-in/Connect menu when working with a full-stack shadow-cljs + deps/lein project:

        {\n      \"name\": \"backend + frontend\",\n      \"projectType\": \"shadow-cljs\",\n      \"cljsType\": \"shadow-cljs\",\n      \"menuSelections\": {\n        \"cljsLaunchBuilds\": [\n          \":app\",\n          \":test\",\n        ],\n        \"cljsDefaultBuild\": \":app\"\n      }\n    }\n

    See shadow-cljs + Clojure with Calva: The basics for how Calva and nREPL work with ClojureScript.

    ","boost":6},{"location":"connect-sequences/#polylith","title":"Polylith","text":"

    This is the connect sequences used in the Polylith Real World App. The (start) sequence lets you jack-in to the project, and starts the Real World App without any prompts. The (connect) sequence can be used if you prefer to start the REPL manually, and want to connect without prompts.

        \"calva.replConnectSequences\": [\n        {\n            \"projectType\": \"deps.edn\",\n            \"afterCLJReplJackInCode\": \"(require '[dev.server] :reload) (in-ns 'dev.server) (start! 6003)\",\n            \"name\": \"Polylith RealWorld Server REPL (start)\",\n            \"autoSelectForJackIn\": true,\n            \"projectRootPath\": [\".\"],\n            \"cljsType\": \"none\",\n            \"menuSelections\": {\n                \"cljAliases\": [\"dev\", \"test\"]\n            }\n        },\n        {\n            \"projectType\": \"deps.edn\",\n            \"name\": \"Polylith RealWorld Server REPL (connect)\",\n            \"autoSelectForConnect\": true,\n            \"projectRootPath\": [\".\"],\n            \"cljsType\": \"none\",\n        }\n    ],\n    \"calva.autoConnectRepl\": true,\n

    The calva.autoConnectRepl, when set to true, makes Calva, at project open, look for the nRepl port file and automatically connect the repl if the file exists. Therefore, you can leave the app running when you close the project in VS Code, and Calva will reconnect when you open the project again. (Alternatively, maybe you just need to reload the VS Code window and not lose the REPL state.)

    ","boost":6},{"location":"connect-sequences/#minimal-menus-with-full-stack-depsedn-and-figwheel-main-repls","title":"Minimal menus with full stack deps.edn and Figwheel Main REPLs","text":"

    Setting for a full-stack application. It starts the backend server when the CLJ REPL has started. Then proceeds to create a custom CLJS REPL (calling in to the application code for this). And then connects to it.

    {\n    \"calva.replConnectSequences\": [\n        {\n            \"name\": \"Example Sequence\",\n            \"projectType\": \"Clojure-CLI\",\n            \"afterCLJReplJackInCode\": \"(go)\",\n            \"cljsType\": {\n                \"startCode\": \"(do (require '[cljs-test.main :refer :all])(start-nrepl+fig))\",\n                \"isReadyToStartRegExp\": \"Prompt will show\",\n                \"connectCode\": \"(do (use 'cljs-test.main) (cljs-repl))\",\n                \"isConnectedRegExp\": \"To quit, type: :cljs/quit\",\n                \"printThisLineRegExp\": \"\\\\[Figwheel\\\\] Starting Server at.*\"\n            }\n        }\n    ]\n}\n
    ","boost":6},{"location":"connect-sequences/#juxt-edge","title":"JUXT Edge","text":"

    Here is an example from the JUXT Edge project template. It adds two sequences, one for when only the Clojure REPL should be launched and one for when the customized Edge cljs repl should also be connected. The Edge backend + frontend sequence specifies that the web app should be opened by Calva, making cljs repl connection more stable, and also adds menuSelections to skip the launch aliases prompt.

    {\n    \"calva.replConnectSequences\": [\n        {\n            \"name\": \"Edge backend only\",\n            \"projectType\": \"deps.edn\"\n        },\n        {\n            \"name\": \"Edge backend + frontend\",\n            \"projectType\": \"deps.edn\",\n            \"cljsType\": {\n                \"dependsOn\": \"Figwheel Main\",\n                \"startCode\": \"(do (require 'dev-extras) (dev-extras/go) (println \\\"Edge Figwheel Main started\\\") ((resolve 'dev-extras/cljs-repl)))\",\n                \"isReadyToStartRegExp\": \"Edge Figwheel Main started\",\n                \"openUrlRegExp\": \"Website listening on: (?<url>\\\\S+)\",\n                \"printThisLineRegExp\": \"\\\\[Edge\\\\]\",\n                \"shouldOpenUrl\": true,\n                \"connectCode\": \"(do (require 'dev-extras) ((resolve 'dev-extras/cljs-repl)))\",\n                \"isConnectedRegExp\": \"To quit, type: :cljs/quit\",\n                \"buildsRequired\": false\n            },\n            \"menuSelections\": {\n                \"cljAliases\": [\n                    \"dev\",\n                    \"build\",\n                    \"dev/build\"\n                ],\n            }\n        }\n    ]\n}\n
    ","boost":6},{"location":"connect-sequences/#plain-depsedn","title":"Plain deps.edn","text":"

    A deps.edn sequence that does not promote the ClojureScript repl at all (leaving it a Clojure REPL), and leaves that up to you to do interactively. (Could be useful while you are developing a custom cljs repl.) The example is for when adapting a Figwheel Main repl.

    {\n    \"calva.replConnectSequences\": [\n        {\n            \"name\": \"Do not promote to cljs\",\n            \"projectType\": \"deps.edn\",\n            \"cljsType\": {\n                \"dependsOn\": \"Figwheel Main\",\n                \"connectCode\": \"\\\"Don't promote me bro!\\\"\",\n                \"isConnectedRegExp\": \"Don't promote me bro!\"\n            }\n        }\n    ]\n}\n
    ","boost":6},{"location":"connect/","title":"Connect Calva to Your Project","text":"

    When connected to your project's REPL Calva lets you evaluate code, supporting Interactive Programming. The REPL connection is also used to provide IDE functionality through the dynamic knowledge about the project that the REPL enables. The REPL communication depends on that your project has an nREPL server running, and that the cider-nrepl middleware is enabled.

    For the easiest way to provide your project with these dependencies, the recommended way to connect is to use the so called Jack-in command.

    ","boost":7},{"location":"connect/#jack-in-let-calva-start-the-repl-for-you","title":"Jack-in: Let Calva Start the REPL For You","text":"

    This way Calva can make sure it is started with the dependencies needed for a working Clojure and/or ClojureScript session. This is often referred to as Jack in (because that is what it is called in CIDER).

    Jack-in supports both CLJ and for CLJS, and has built-in configurations for Leiningen, deps.edn, shadow-cljs, Gradle projects, as well as for the CLJS repl types: Figwheel Main, lein-figwheel (legacy Figwheel), shadow-cljs, and ClojureScript built-ins for both browser and node.js. Using jack-in provides your development environment with all the dependencies you need for Calva to work.

    It works like so:

    1. Open your project in VS Code.
    2. Issue the command Start a Project REPL and Connect: ctrl+alt+c ctrl+alt+j.
    3. Answer the quick-pick prompts telling Calva about project types and what profiles to start. (See the Jack-in Project Types and Profiles wiki page for more info if needed.)

    See also: Workspace Layouts

    About project roots

    You must have a project file, such as project.clj for Leiningen, or deps.edn for deps.edn, or shadow-cljs.edn for shadow-cljs, or settings.gradle/settings.gradle.kts for Gradle in the directory opened in VS Code in order for jack-in to work. If, after adding the project file, you experience an error during jack-in that says something could not be located, make sure you have the correct dependencies in your project file. For example, when using the Figwheel Main project type, you should have com.bhauman/figwheel-main in your project dependencies.

    See also below, regarding multiple projects in a workspace

    ","boost":7},{"location":"connect/#aliases-profiles-builds","title":"Aliases, Profiles, Builds","text":"

    When Jack-in starts it will depend on the project type, and whether ClojureScript is involved or not, and if it is, what kind of ClojureScript project, what will happen next. Calva will analyze the project files and will then give you prompts with selections based on what is found there.

    You will need some basic knowledge about the project and the project type terminologies to answer the prompts.

    There are ways to tell Calva the answers to these prompts beforehand, so that Jack-in can be a zero-prompting command. Read on.

    ","boost":7},{"location":"connect/#customizing-jack-in","title":"Customizing Jack-in","text":"

    The main mechanism for customizing your Jack-in, including automating menu selections, and custom CLJS REPL types is Custom Connect Sequences. See also Customizing Jack-in and Connect

    ","boost":7},{"location":"connect/#connecting-without-jack-in","title":"Connecting Without Jack-in","text":"

    If, for whatever reasons, you can't use Jack-in with your project (possibly because the REPL is started as part of some other job) all is not lost. Old fashioned Connect to a running REPL is still there for you. For all features to work in Calva while connecting to a running REPL, your environment needs to have REPL related dependencies set up.

    However, just as before it can be tricky to get the dependencies right. Consider using Jack in to inform yourself on how to start your REPL to Calva's satisfaction. When you use Jack in, Calva starts a VS Code task for it and the command line used is displayed in the terminal pane used to handle the task. Reading that command line tells you what dependencies are needed for your project.

    Even better: Copying that command line gives you the command to start the REPL with the correct dependencies.

    All this said, I still recommend you challenge the conclusion that you can't use Jack-in.

    Copy the Jack-in command line

    There is a Calva command for copying the Jack-in command line to the clipboard. It will copy the command line including commands to change to the current REPL project root, avoiding hard-to-detect errors when starting the REPL in the wrong directory.

    The Generic Project Type

    A reason to use the connect to a running REPL way, can be that Calva does not have a built in connect sequence/project type for the particular REPL you want to connect to. Maybe it is something like Lingy which doesn't yet have a built in Calva connect sequence. As long as there is an nREPL server to connect to, you can Connect with Calva, using the Generic connect sequence/project type. (You can also create a connect sequence with a custom command line, and use Jack-in anyway.)

    See also Customizing Jack-in and Connect

    ","boost":7},{"location":"connect/#starting-the-repl-from-application-code","title":"Starting the REPL from application code?","text":"

    If your project is setup so that the REPL server is started by the application code, you will need to get the cider-nrepl middleware in place. See the cider-nrepl docs about embedding nREPL in your application.

    ","boost":7},{"location":"connect/#auto-select-project-type-and-project-root","title":"Auto-select Project Type and Project Root","text":"

    You can make both Jack-in and Connect stop prompting you for project type and project root path in projects where you always want to use the same. See Connect Sequences.

    ","boost":7},{"location":"connect/#monorepos-multiple-clojure-projects-in-one-workspace","title":"Monorepos / multiple Clojure projects in one workspace","text":"

    If the workspace is a monorepo, Polylith repo or just a repository with more than one Clojure project, Calva will start the connect sequence with prompting for which project to start/connect to.

    ","boost":7},{"location":"connect/#shadow-cljs","title":"shadow-cljs","text":"

    Please see the shadow-cljs page.

    ","boost":7},{"location":"connect/#troubleshooting","title":"Troubleshooting","text":"","boost":7},{"location":"connect/#jack-in-and-main-opts","title":"Jack-in and :main-opts","text":"

    When Calva starts the project REPL and connects to it (a.k.a. Jack-in), this is done by starting an nREPL server. For deps.edn projects this by default means that Calva will add -m ... with options that starts the server.

    However: If you choose an alias at Jack-in that specifies :main-opts, it will make the Clojure CLI to add main opts and Calva will then not override these by adding -m ... to the command line. This means that an alias that specify :main-opts must result in an nREPL server being started, or else Calva won't have a server to connect to. Calva won't further analyze this, but will just warn you at Jack-in.

    If you don't know if an alias starts an nREPL server or not, by all means, try it, if you have reasons for using that alias. You will notice if Jack-in works or not. If it doesn't work, you will need to run without that alias, or fix what happens when that alias is used so that an nREPL server is started. See https://nrepl.org/nrepl/usage/server.html about ways to do this.

    ","boost":7},{"location":"connect/#command-not-found-errors-when-jacking-in","title":"Command Not Found Errors When Jacking In","text":"

    If you get command not found error when Calva tries to start your project, and you know you have the command installed, it's probably because VS Code starts from an environment where the command is not on the $PATH. It can look like so:

    lein update-in :dependencies conj '[nrepl,\"0.8.3\"]' -- update-in :plugins conj '[cider/cider-nrepl,\"0.25.8\"]' -- update-in '[:repl-options,:nrepl-middleware]' conj '[\"cider.nrepl/cider-middleware\"]' -- repl :headless\n/bin/sh: lein: command not found\nJack-in process exited. Status: 127\n

    The fix is to always start VS Code from the command line:

    $ code\n

    You might need to first run the Shell Command: Install code command in PATH.

    This will also make sure your REPL has access to the environment you probably expect it to have access to. See below.

    ","boost":7},{"location":"connect/#go-to-definition-not-working-for-java-definitions","title":"Go to Definition Not Working for Java Definitions","text":"

    On some systems, the Java source may not be installed along with the JDK. The source must be present on your system in order to navigate to Java definitions. See this comment for more details.

    ","boost":7},{"location":"connect/#environment-variables-are-not-readable-from-repl","title":"Environment Variables Are Not Readable From REPL","text":"

    If you've added environment variables in your OS, such as in your ~/.bashrc file (Linux), in order for them to be read in a REPL created by Calva's jackin command, VS Code must be started from a shell where the environment variables are defined. For example, if you can open a bash terminal and run echo $SOME_VAR and see the value there, then open VS Code from that terminal with code <project path>.

    ","boost":7},{"location":"connect/#viewing-the-communication-between-nrepl-and-calva","title":"Viewing the Communication Between nREPL and Calva","text":"

    It may be helpful to view the messages sent between nREPL and Calva when troubleshooting an issue related to the REPL. See how to do that here.

    ","boost":7},{"location":"contribute/","title":"Contribute to Calva","text":"

    There are many ways to contribute:

    Be creative!

    "},{"location":"contribute/#please-star-the-calva-repo","title":"Please star the Calva repo!","text":"

    Happy Coding! \u2764\ufe0f

    "},{"location":"custom-commands/","title":"Custom REPL Commands","text":"

    Calva supports configuration of custom command snippets that you can evaluate in the REPL at will. This is useful if your workflow has you repeatedly evaluating a particular piece of code. There are two ways to use these:

    1. You can use the setting calva.customREPLCommandSnippets to configure it. Then either bind keyboard shortcuts to them or use the command Run Custom REPL Command to access it. The command will give you a menu with the snippets you have configured.
    2. You can bind a keyboard shortcut directly to a custom command snippet by inlining it in the shortcut definition. See Binding Keyboard Shortcuts

    Joyride

    For some use cases you might be better served by/want to combine these with using the VS Code Extension API, and that of Calva, or any other extension, through Joyride.

    The calva.customREPLCommandSnippets is an array of objects with the following fields (required fields in bold):

    There are also substitutions available, which will take elements from the current state of Calva and splice them in to the text of your command before executing it. They are

    ","boost":4},{"location":"custom-commands/#user-and-workspace-settings","title":"User and Workspace Settings","text":"

    Settings from your User (global) level and the workspace are merged.

    With these User settings:

        \"calva.customREPLCommandSnippets\": [\n        {\n            \"name\": \"Call Current Form\",\n            \"key\": \"c\",\n            \"snippet\": \"($current-form)\"\n        },\n        {\n            \"name\": \"Call Current Top Level Form\",\n            \"key\": \"t\",\n            \"snippet\": \"($top-level-form)\"\n        },\n        {\n            \"name\": \"CLJ Test Top Level Defined Symbol\",\n            \"repl\": \"clj\",\n            \"snippet\": \"(clojure.test/test-var #'$top-level-defined-symbol)\"\n        },\n        {\n            \"name\": \"CLJS Test Top Level Defined Symbol\",\n            \"repl\": \"cljs\",\n            \"snippet\": \"(cljs.test/test-var #'$top-level-defined-symbol)\",\n            \"key\": \"tab\"\n        }\n    ],\n

    And these Workspace settings:

        \"calva.customREPLCommandSnippets\": [\n        {\n            \"name\": \"Remount CLJS App\",\n            \"key\": \"r\",\n            \"repl\": \"cljs\",\n            \"ns\": \"example.app\",\n            \"snippet\": \"(start)\"\n        }\n    ],\n

    Issuing Run Custom REPL Command will then render this VS Code menu:

    The default keyboard shortcut for the command is ctrl+alt+space space. (Beware: on MacOS it may conflict with the default shortuct for Input Sources - Select next source in Input menu.)

    ","boost":4},{"location":"custom-commands/#binding-keyboard-shortcuts","title":"Binding Keyboard Shortcuts","text":"

    There are four ways to bind shortcuts to custom commands:

    1. Use a predefined key shortcut. These are predefined as ctrl+alt+space <something>, where <something> is one of:
      • The digits 0 through 9
      • The English letters a through z
      • Arrow keys right, left, up, or down
      • One of tab, backspace, ,, ., or -
    2. Bind calva.runCustomREPLCommand to a shortcut with whatever code you want to evaluate in the args slot. You have access to the substitution variables here as well.
    3. Bind calva.runCustomREPLCommand to a keyboard shortcut referencing the key of one of your calva.customREPLCommandSnippets. (If not using any of the keys mentioned in 1.)
    4. Bind calva.runCustomREPLCommand to a shortcut with a customREPLCommandSnippets in the args slot. You have access to the substitution variables here as well.

    Here's an example shortcut entry for the 4th option:

        {\n        \"key\": \"ctrl+cmd+u alt+enter\",\n        \"command\": \"calva.runCustomREPLCommand\",\n        \"args\": {\n            \"ns\": \"user\",\n            \"snippet\": \"$current-form\",\n        }\n    },\n

    This would evaluate the current form in the user namespace. Please note that this Custom REPL Command will not show up in the custom commands menu mentioned above.

    ","boost":4},{"location":"custom-commands/#custom-repl-hover-snippets","title":"Custom REPL Hover Snippets","text":"

    Calva supports custom snippets that will display their result inside the tooltip. They will only work when connected to a repl, since they eval code in it. This is mostly useful for tooling authors that want to integrate with calva. Be careful with these, since they will be executed anytime Calva displays a tooltip. So they should be fast and probably not have any side effects.

    The hover snippets accept the same inputs as the Custom REPL Commands, except for the hotkey:

        \"calva.customREPLHoverSnippets\": [\n        {\n            \"name\": \"eval text on hover\",\n            \"repl\": \"clj\",\n            \"ns\": \"example.app\",\n            \"snippet\": \"(str \\\"$hover-text\\\")\"\n        }\n    ]\n

    With this setting anything the mouse is over will also be shown inside its tooltip. There are now also hover- versions of most substitutions. Those currently only work inside the hover snippets.

    ","boost":4},{"location":"custom-commands/#configedn","title":"config.edn","text":"

    :customREPLCommandSnippets and :customREPLHoverSnippets can be also be configured in your user config at .config/calva/config.edn realative to your system home directory, or .calva/config.edn relative to the workspace root. Three things to note about this:

    1. None of these two configs get synced through VS Code Settings Sync.
    2. Changes to workspace .calva/config.edn will be automatically noticed by Calva, and refresh the config. This will not happen with the user config file.
    3. Internally in Calva, the settings are keyed on the snippet :name entry, and if you change the name, the old entry won't be removed until the VS Code window is reloaded.

    As for 2.: There is a command Calva: Refresh REPL snippets from User config.edn.

    There is also a command to open the User config.edn, for convenience: Calva: Open REPL snippets User config.edn. This command creates the file if it doesn't previously exist.

    ","boost":4},{"location":"custom-commands/#snippets-inside-deps","title":"Snippets Inside Deps","text":"

    A new experimental feature lets library authors ship snippets inside their jar files. These accept the same options as above but should be placed in \"resources/calva.exports/config.edn\" inside the jar.

    {:customREPLCommandSnippets\n [{:name \"edn test\"\n   :key \"a\"\n   :snippet ($current-form)}]\n :customREPLHoverSnippets\n [{:name \"edn hover\"\n   :snippet (str \"$hover-tex\")}\n  {:name \"edn hover show val\"\n   :snippet (str \"### EDN show val\\n```clojure\\n\" (pr-str (eval (symbol (str \"$ns\" \"/\" \"$hover-top-level-defined-symbol\")))) \"\\n```\")}]}\n
    ","boost":4},{"location":"customizing-jack-in-and-connect/","title":"Customize Jack-in and Connect","text":"

    Since Jack-in and connect both are about connecting the REPL, and only differ in how the REPL is started, many settings and configuration points are shared between the two concepts. A major customization point is Custom Connect Sequences, which are relevant for both Jack-in and Standalone Connect scenarios.

    This page lists some more Jack-in and Connect configuration options.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#auto-evaluate-code-on-connect","title":"Auto-evaluate Code on Connect","text":"

    You can have Calva evaluate code whenever a REPL has been connected via the calva.autoEvaluateCode.onConnect setting. It has two entries clj and cljs:

    Set either of these to null to disable the feature for that REPL type. (The Settings linter will complain, but it works.)

    For Clojure this is in addition to afterCLJReplJackInCode

    There are two mechanisms for evaluating code when a Clojure REPL is connected. The afterCLJReplJackInCode setting of custom connect sequences, and this calva.autoEvaluateCode.onConnect.clj setting. There is no fundamental difference between them. This one has a default function of auto-refering in the Clojure REPL utilities. And it will be run before the connect sequence after-Jack-in code.

    All configured code is concatenated

    If you configure this both in User/global settings and in a Workspace, the workspace configured code will be concatenated on the user level code. Meaning both code snippets will be evaluated, first the User level code, then the Workspace level code. Also null disables the feature:

    ","boost":7},{"location":"customizing-jack-in-and-connect/#auto-evaluate-code-at-filenamespace-loadevaluation","title":"Auto-evaluate Code at file/namespace load/evaluation","text":"

    You can also make Calva auto-evaluate code when a file has been loaded in the REPL (via the Calva command for loading files). You add code for this via the calva.autoEvaluateCode.onFileLoaded setting. Like with onConnect you provide code for clj and cljs separately.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#customizing-connect","title":"Customizing Connect","text":"

    If there is an nRepl port file, Calva will use it and not prompt for host:port when connecting. You can make Calva prompt for this by setting the boolean config calva.autoSelectNReplPortFromPortFile to false.

    With the setting calva.autoConnectRepl you can make Calva automatically connect the REPL if there is an nRepl port file present when the project is opened.

    With this and the below mentioned auto-select options you can make connect a prompt-less experience. See: Connect Sequences.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#options-for-the-connect-command","title":"Options for the Connect Command","text":"

    The calva.connect command takes an optional options argument defined like so:

      options?: {\n    host?: string;\n    port?: string;\n    connectSequence?: string | ReplConnectSequence;\n    disableAutoSelect?: boolean;\n  }\n

    Where ReplConnectSequence is a Connect Sequences. If you provide a string it needs to match against a built-in or custom connect sequence. With disableAutoSelect you can force the connect menus to be provided even if a custom connect sequence is set to be autoSelected.

    You can provide these options from keyboard shortcuts or from Joyride scripts.

    Here's a keyboard shortcut for connecting to a running REPL bypassing any connect sequence with autoSelectForConnect.

        {\n        \"command\": \"calva.connect\",\n        \"args\": {\"disableAutoSelect\": true},\n        \"key\": \"ctrl+alt+c shift+c\",\n    },\n

    A Joyride command for connecting to a REPL on port 55555, without being asked for project type:

    (vscode/commands.executeCommand \"calva.connect\" (clj->js {:port \"55555\" :connectSequence \"Generic\"}))\n
    ","boost":7},{"location":"customizing-jack-in-and-connect/#customizing-jack-in","title":"Customizing Jack-in","text":"

    The main mechanism for customizing your Jack-in, including automating menu selections, and custom CLJS REPL types is Custom Connect Sequences.

    There are also these settings:

    Note

    When processing the calva.jackInEnv setting you can refer to existing ENV variables with ${env:VARIABLE}.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#jack-in-dependency-versions","title":"Jack-in Dependency Versions","text":"

    Calva Jack-in injects the following dependencies in order for the REPL session to support IDE features

    The versions used are configurable via the VS Code settings calva.jackInDependencyVersions.

    Java 1.8 compatible versions

    The default dependency versions are not compatible with Java 1.8. If your project needs that version of Java you can use these settings in your Workspace .vscode/settings.json:

    \"calva.jackInDependencyVersions\": {\n  \"nrepl\": \"1.0.0\",\n  \"cider-nrepl\": \"0.28.5\",\n  \"cider/piggieback\": \"0.5.3\"\n}\n
    ","boost":7},{"location":"customizing-jack-in-and-connect/#options-for-the-jack-in-command","title":"Options for the Jack-in Command","text":"

    The calva.jackIn command takes an optional options argument defined like so:

      options?: {\n    connectSequence?: string | ReplConnectSequence;\n    disableAutoSelect?: boolean;\n  }\n

    Where ReplConnectSequence is a Connect Sequences. If you provide a string it needs to match against a built-in or custom connect sequence. With disableAutoSelect you can force the jack-in menus to be provided even if a custom connect sequence is set to be autoSelected.

    You can provide these options from keyboard shortcuts or from Joyride scripts.

    Here's a keyboard shortcut for connecting to a running REPL bypassing any connect sequence with autoSelectForConnect.

        {\n        \"command\": \"calva.jackIn\",\n        \"args\": {\"disableAutoSelect\": true},\n        \"key\": \"ctrl+alt+c shift+j\",\n    },\n

    A Joyride command for starting a deps.edn REPL for a project in the root of the workspace.

    (vscode/commands.executeCommand\n \"calva.jackIn\"\n (clj->js {:connectSequence {:projectType \"deps.edn\"\n                             :projectRootPath [\".\"]}}))\n

    It will prompt for any aliases it finds in the deps.edn file.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#starting-the-repl-from-application-code","title":"Starting the REPL from application code?","text":"

    If your project is setup so that the REPL server is started by the application code, you will need to get the cider-nrepl middleware in place. See the cider-nrepl docs about embedding nREPL in your application.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#auto-select-project-type-and-project-root","title":"Auto-select Project Type and Project Root","text":"

    You can make both Jack-in and Connect stop prompting you for project type and project root path in projects where you always want to use the same. See Connect Sequences.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#project-roots-search-globing","title":"Project roots search globing","text":"

    When searching for project roots in your workspace, Calva will glob for all files matching project.clj, deps.edn, or shadow-cljs.edn. This is done using VS Code's workspace search engine, and is very efficient. However, in a large monorepo, it is still a substantial task. In order to not waste resources Calva will exclude any directories in the setting calva.projectRootsSearchExclude.

    Exclude entry globs

    Each entry is a partial glob and will be part of a resulting glob of the form **/{glob1,glob2,...,globN}. This means that all directories in the workspace matching an entry will be excluded, regardless of where in the workspace they reside.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#viewing-the-communication-between-nrepl-and-calva","title":"Viewing the Communication Between nREPL and Calva","text":"

    It may be helpful to view the messages sent between nREPL and Calva when troubleshooting an issue related to the REPL. See how to do that here.

    ","boost":7},{"location":"customizing/","title":"Customizing Calva","text":"

    Don't like the defaults? On this page we can collect some of the customizations that people have done, and maybe write a thing or two about it some day.

    Tip for VS Code newcomers: The search box in Settings is your friend. Also, some Calva settings are more complex than the Settings UI can handle. VS Code will then show you a link to settings.json. And VS Code's built-in json extension is awesome. To add settings for Calva's Pretty Printing, for example, search for \u201dprettyprint\u201d in VS Code Settings and follow the link to settings.json. Start typing \u201dcalvapretty\u201d until auto-complete suggests calva.prettyPrintingOptions. Press ENTER and VS Code will fill in these defaults:

        \"calva.prettyPrintingOptions\": {\n        \"enabled\": true,\n        \"printEngine\": \"pprint\",\n        \"width\": 40\n    },\n
    "},{"location":"customizing/#clojure-defaults","title":"Clojure Defaults","text":"

    Calva sets some VS Code settings for all Clojure files. Some of these are needed for Calva to function correctly, which should not be tampered with unless you really know what you are doing, and some of them are convenient defaults. If you add a setting to your settings.json and accept the snippet help you get when you type \"[clojure]\", you will get the Calva defaults pasted:

        \"[clojure]\": {\n        \"editor.wordSeparators\": \"\\t ()\\\"':,;~@#$%^&{}[]`\",\n        \"editor.autoClosingBrackets\": \"always\",\n        \"editor.autoClosingQuotes\": \"always\",\n        \"editor.autoClosingQuotes\": \"always\",\n        \"editor.formatOnType\": true,\n        \"editor.autoIndent\": \"full\",\n        \"editor.formatOnPaste\": true,\n        \"editor.matchBrackets\": \"never\",\n        \"editor.renderIndentGuides\": false,\n        \"editor.parameterHints.enabled\": false\n    }\n

    Note

    The above editor.wordSeparators setting establish Clojure word boundaries. E.g - is considered to be part of words. This affects what happens when double-clicking symbols and other things. If you want to include - or something else as a word boundary, just add it to the setting.

    "},{"location":"customizing/#pretty-printing","title":"Pretty Printing","text":"

    Calva's pretty printing mode can be configured a bit. See Pretty Printing.

    "},{"location":"customizing/#calva-highlight","title":"Calva Highlight","text":"

    This is highly customizable. See Syntax highlighting

    "},{"location":"customizing/#color-customizations","title":"Color customizations","text":"

    Calva defines a set of themable colors which can be provided by the user using workbench.colorCustomizations.

        \"workbench.colorCustomizations\": {\n        \"calva.inlineErrorForegroundColor\": \"#ff0000\",\n        \"calva.inlineForegroundColor\": \"#ff9000\"\n    }\n

    "},{"location":"customizing/#automatic-parameter-hints-poppup","title":"Automatic Parameter Hints Poppup","text":"

    Calva has helpful parameter hints to aid when typing function calls. They look like so:

    To have the hints automatically pop up when you are typing, set editor.parameterHints.enabled to true in the above [clojure] scoped setting. (To call them up on demand the default VS Code keybindings are cmd+shift+space on Mac and ctrl+shift+space on Linux/Windows.)

    "},{"location":"customizing/#code-formatting","title":"Code Formatting","text":"

    See Formatting for information on how to configure this.

    "},{"location":"customizing/#jack-in-and-connect","title":"Jack-in and Connect","text":"

    Jack-in and Connect are very customizable through Custom Connect Sequences.

    See also Customizing Jack-in and Connect

    "},{"location":"customizing/#key-bindings","title":"Key bindings","text":"

    Most of Calva's commands have default keybindings. They are only defaults, though, and you can change keybindings as you wish. To facilitate precision in binding keys Calva keeps some when clause contexts updated.

    "},{"location":"customizing/#when-clause-contexts","title":"When Clause Contexts","text":"

    The following contexts are available with Calva:

    "},{"location":"customizing/#some-custom-bindings","title":"Some Custom Bindings","text":"

    Here is a collection of custom keybindings from here and there.

    Are you a vim extension user? See: Using with VIM extension.

    "},{"location":"customizing/#move-by-word","title":"Move by word","text":"

    By default Calva changes the move-by-word key bindings to move by sexpr/form when the cursor is in structural Clojure code. Within line comments the editor default word movement is active.

    If you want the VS Code default word movement shortcuts, use these settings:

        {\n        \"key\": \"ctrl+right\",\n        \"win\": \"ctrl+right\",\n        \"mac\": \"alt+right\",\n        \"command\": \"cursorWordRight\"\n    },\n    {\n        \"key\": \"ctrl+left\",\n        \"win\": \"ctrl+left\",\n        \"mac\": \"alt+left\",\n        \"command\": \"cursorWordLeft\"\n    },\n    {\n        \"key\": \"ctrl+right\",\n        \"mac\": \"ctrl+right\",\n        \"win\": \"alt+right\",\n        \"command\": \"paredit.forwardSexp\",\n        \"when\": \"calva:keybindingsEnabled && editorTextFocus && editorLangId == 'clojure' && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+left\",\n        \"mac\": \"ctrl+left\",\n        \"win\": \"alt+left\",\n        \"command\": \"paredit.backwardSexp\",\n        \"when\": \"calva:keybindingsEnabled && editorTextFocus && editorLangId == 'clojure' && paredit:keyMap =~ /original|strict/\"\n    }\n

    Use it as an inspiration for customizing things to your own liking. \ud83d\ude04

    "},{"location":"customizing/#wrap-using-like-cursive","title":"Wrap using (, [, { (like Cursive)","text":"

    Something I use in IntelliJ/Cursive is the ability to select an expression and hit one of (, [, { to wrap it. And after wrapping the expression I don't want the selection anymore, so if I were wrapping (foo) then I would want to get ( | (foo)) where | would be my cursor.

    Here's how you can make this work with Calva Paredit: Update all of the Paredit: Wrap Around ... commands so that their respective shortcuts are the wrappers themselves and update the when clause to include editorHasSelection (otherwise when you open a paren the next expression would get slurped in).

    The change would look like this in your keybindings.json:

        {\n        \"key\": \"shift+9\",\n        \"command\": \"paredit.wrapAroundParens\",\n        \"when\": \"editorTextFocus && editorHasSelection && !editorReadOnly && editorLangId =~ /clojure|scheme|lisp/ && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"[\",\n        \"command\": \"paredit.wrapAroundSquare\",\n        \"when\": \"editorHasSelection && editorTextFocus && !editorReadOnly && editorLangId =~ /clojure|scheme|lisp/ && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"shift+[\",\n        \"command\": \"paredit.wrapAroundCurly\",\n        \"when\": \"editorHasSelection && editorTextFocus && !editorReadOnly && editorLangId =~ /clojure|scheme|lisp/ && paredit:keyMap =~ /original|strict/\"\n    }\n
    "},{"location":"debugger/","title":"Debugger","text":"

    Calva comes with a powerful expression-based debugger, inspired by Cider's debugger, and using the same underlying library, cider-nrepl. We hope you love it!

    Note

    The debugger currently does not support ClojureScript. Calva's debugger utilizes cider-nrepl for debugging. See this Cider issue for more information.

    "},{"location":"debugger/#features","title":"Features","text":""},{"location":"debugger/#current","title":"Current","text":""},{"location":"debugger/#future-goals","title":"Future goals","text":""},{"location":"debugger/#dependencies","title":"Dependencies","text":"

    The debugger itself relies pretty heavily on cider-nrepl, as do other parts of Calva. This library is loaded as a dependency when you use Calva Jack-in. If you are not using Calva Jack-in, you can add these dependencies in your project definition or user profile. See the Calva Jack-in guide for more information.

    "},{"location":"debugger/#using-the-debugger","title":"Using the Debugger","text":"

    If you're new to Clojure or expression-based debuggers, this debugger may function differently than what you're used to. Instead of placing breakpoints in the side margin and then hitting F5 to start debugging, you instead use Clojure reader tags, #break and #dbg, to denote breakpoints anywhere in a Clojure form. When you evaluate a call to a function that has been evaluated with that reader tag, the debugger will start when execution reaches the first breakpoint. There's also a convenience command to instrument functions. Read below about both options.

    Note

    The debugger is not configured via a launch.json file, and is not started in the same way as you may be used to when working with other languages in VS Code. The debugger is used by way of the REPL. If you are new to Clojure, please visit the Getting Started section of the documentation and get familiar with evaluating code using the REPL before using the debugger.

    "},{"location":"debugger/#instrumenting-a-function","title":"Instrumenting a Function","text":"

    You can instrument a top level function for debugging with ctrl+alt+c i. This places invisible breakpoints throughout the function where pausing makes sense. When you evaluate a call to this function, the debugger will start and execution will pause at the first breakpoint. Annotations show the value of the form at the cursor.

    A border is placed around the definition of the instrumented function and its references to show that it's instrumented. You can remove instrumentation by evaluating the function again normally, such as with alt+enter.

    "},{"location":"debugger/#setting-breakpoints-with-break","title":"Setting Breakpoints with #break","text":"

    You can insert a breakpoint manually into any code by placing a #break in front of the form where you want execution to pause, and then evaluating the top level form with alt+enter. When you evaluate a call to this code the VS Code debugger will start, the cursor will move to right after the form that's preceded by #break, and the line will be highlighted to show execution is paused there.

    Note

    Code will be executed up to and including the form after the breakpoint.

    "},{"location":"debugger/#conditional-breakpoints","title":"Conditional Breakpoints","text":"

    You can set conditional breakpoints by adding metadata before the form that the #break applies to.

    (defn print-nums [n]\n  (dotimes [i n]\n    #break ^{:break/when (= i 7)} ;; This breakpoint will only be hit when i equals 7\n    (prn i)))\n
    "},{"location":"debugger/#instrumenting-a-form-with-dbg","title":"Instrumenting a Form with #dbg","text":"

    Adding #dbg before a form then evaluating the form with alt+enter will instrument the form. This has the same effect as using the instrument command.

    "},{"location":"debugger/#evaluating-code-in-the-paused-context","title":"Evaluating Code in the Paused Context","text":"

    When execution is paused at a breakpoint, you can evaluate code in that context. This can be done in the editor or in the REPL window, as usual.

    "},{"location":"debugger/#viewing-variable-values","title":"Viewing Variable Values","text":"

    While debugging, you can view the values of variables in VS Code's debugger side pane. You can also view values by hovering over the variables in the editor.

    Metadata not available

    The variable viewer does not have access to any metadata attached to the variable values.

    "},{"location":"debugger/#viewing-the-call-stack","title":"Viewing the Call Stack","text":"

    While debugging, you can view the call stack in VS Code's call stack side pane. Clicking the stack frames will show the related line of code in an editor.

    Note

    You may only see one stack frame in the call stack side pane, as the change for adding additional frames was rolled back due to an issue. You can follow the change for this at #1150.

    "},{"location":"debugger/#stepping-commands","title":"Stepping Commands","text":"

    You can use VS Code's debugger UI to advance execution while debugging.

    Note

    Clicking restart does nothing, since this functionality does not make sense for our debugger.

    "},{"location":"debugger/#caveats","title":"Caveats","text":""},{"location":"debugger/#breakpoints-in-looprecur","title":"Breakpoints in loop/recur","text":"

    One construct where the debugger is limited is loop/recur. As recur always has to appear in a tail-position inside a loop or a fn and the debugger uses macros to interleave breakpoints in the forms, it might happen that a recur no longer appears in a tail position. In that case we have to avoid setting up the breakpoint. An example of such a case is:

    (loop [i 0]\n  #break\n  (when (< i 10)\n    (println i)\n    (recur (inc i))))\n

    Here the breakpoint is exactly in front of a form that contains as its last expression a recur which is wrapped in a loop. This breakpoint has no effect. This does not mean you cannot use the debugger with loop, it just means you have to set your debug statements more carefully.

    "},{"location":"debugger/#loading-the-file-and-eval-on-save","title":"Loading the File and \"Eval On Save\"","text":"

    When you load a file, any breakpoints that were previously set in functions will be unset. If you have the \"Eval On Save\" setting enabled, your file is also loaded with each save, therefore saving the file will remove breakpoints previously set.

    "},{"location":"debugger/#troubleshooting","title":"Troubleshooting","text":""},{"location":"debugger/#debugger-hangs-when-stepping-over-infinite-seqs","title":"Debugger hangs when stepping over infinite seqs","text":"

    This is because the debugger tries to evaluate the form when it's stepped over, and if clojure.core/*print-length* is set to nil as it is by default, evaluation will never complete. If you want to debug a form with an infinite seq, make sure to set *print-length* beforehand. For example:

    (set! *print-length* 3)\n;; Or, to be more precise\n(set! clojure.core/*print-length* 3)\n

    Calva does not set this for you during debug mode, instead leaving it up to you to decide the value.

    "},{"location":"debugger/#my-breakpoint-isnt-being-hit","title":"My breakpoint isn't being hit","text":"

    It's likely that your breakpoint is in a place that cider-nrepl does not see as an appropriate place to break execution. For example, if you put a breakpoint before a literal number, it will not be hit, because there's no need to show the value of a literal.

    (defn simple [x]\n  (+ 1 #break 1)) ;; This breakpoint will not be hit\n

    Another possible issue is that you're loading the file again after setting breakpoints, which unsets them. See Loading the File and \"Eval On Save\" under Caveats.

    "},{"location":"debugger/#my-breakpoint-in-a-test-isnt-being-hit","title":"My breakpoint in a test isn't being hit","text":"

    If you're using the test commands like \"Run current test\" to run your tests, breakpoints will not be hit. This is because Calva loads the file before running the tests to make sure the latest version of test code is being run, and when the file is loaded, breakpoints are unset.

    If you want a breakpoint to work within the test, evaluate the test form with a breakpoint tag in it, then call the test directly.

    "},{"location":"debugger/#no-reader-function-for-tag-error","title":"\"No reader function for tag\" error","text":"

    If you get an error like this, it's likely that you connected to a REPL instead of jacking in, and you don't have the proper dependencies loaded in your REPL. You can run the command \"Copy Jack-in Command Line to Clipboard\" to see what command would be run if you jacked in.

    Most importantly, make sure you have cider/cider-nrepl as a dependency, and cider.nrepl/cider-middleware as middleware loaded in your REPL. For example, this is a jack-in command line for a deps.edn project:

    clojure -Sdeps '{:deps {nrepl/nrepl {:mvn/version,\"0.8.3\"},cider/cider-nrepl {:mvn/version,\"0.25.8\"}}}' -m nrepl.cmdline --middleware \"[cider.nrepl/cider-middleware]\"\n
    "},{"location":"debugger/#passing-options-to-the-repl-jvm","title":"Passing options to the REPL JVM","text":"

    There are times when Clojure debugging tools are not enough or not right for the job. This is usually true when use an (open source) Java library and you want to set some breakpoints in Java code. For those cases and others, you need to start the JVM in debug mode.

    Typical use cases:

    Calva supports passing environment variables via jackInEnv. You can set that option inside VSCode settings.json file.

    You can configure global settings.json file or a project wide version, inside <project-root>/.vscode/settings.json.

    Configuring the global option will impact all projects you work on using Calva, so be aware. See the documentation for settings.json for more information.

    The bellow snippet configures JAVA_TOOL_OPTIONS environment variable. We configure slf4j-simple logging level via a Java system property (-D) and JVM specific options (-X).

    NOTE: You can of course pass other env variables here.

    .vscode/settings.json

    {\n    \"calva.jackInEnv\": {\n        \"JAVA_TOOL_OPTIONS\": \"${env:JAVA_TOOL_OPTIONS} -Dorg.slf4j.simpleLogger.defaultLogLevel=TRACE -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=7896\"\n    }\n}\n

    Once you saved the file, the next time you Jack in the project, this variable is read by the JVM and the configuration is applied accordingly.

    You should see something like the message below in the Calva terminal output window:

    clojure -Sdeps '{:deps {nrepl/nrepl {:mvn/version,\"0.8.3\"},cider/cider-nrepl {:mvn/version,\"0.26.0\"}}}' -A:debug -m nrepl.cmdline --middleware \"[cider.nrepl/cider-middleware]\"\nPicked up JAVA_TOOL_OPTIONS:  -Dorg.slf4j.simpleLogger.defaultLogLevel=TRACE -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=7896\nListening for transport dt_socket at address: 7896\nnREPL server started on port 46691 on host localhost - nrepl://localhost:46691\n
    "},{"location":"emacs-keybindings/","title":"Emacs Keybindings","text":"

    Some keybindings to make it easier for Emacs users 

    [\n    {\n        \"key\": \"ctrl+cmd+b\",\n        \"command\": \"paredit.backwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+alt+left\",\n        \"command\": \"-paredit.backwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"shift+cmd+]\",\n        \"command\": \"-workbench.action.nextEditor\"\n    },\n    {\n        \"key\": \"ctrl+shift+]\",\n        \"command\": \"paredit.barfSexpBackward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+right\",\n        \"command\": \"-paredit.barfSexpBackward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+[\",\n        \"command\": \"paredit.barfSexpForward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+left\",\n        \"command\": \"-paredit.barfSexpForward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+cmd+f\",\n        \"command\": \"paredit.forwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+alt+right\",\n        \"command\": \"-paredit.forwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+cmd+f\",\n        \"command\": \"-workbench.action.toggleFullScreen\"\n    },\n    {\n        \"key\": \"ctrl+shift+backspace\",\n        \"command\": \"-paredit.killSexpForward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"shift+cmd+k\",\n        \"command\": \"-editor.action.deleteLines\",\n        \"when\": \"textInputFocus && !editorReadonly\"\n    },\n    {\n        \"key\": \"ctrl+shift+0\",\n        \"command\": \"paredit.slurpSexpForward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+right\",\n        \"command\": \"-paredit.slurpSexpForward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+9\",\n        \"command\": \"paredit.slurpSexpBackward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+left\",\n        \"command\": \"-paredit.slurpSexpBackward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+c ctrl+c\",\n        \"command\": \"calva.evaluateCurrentTopLevelForm\",\n        \"when\": \"calva:activated\"\n    },\n    {\n        \"key\": \"ctrl+alt+c space\",\n        \"command\": \"-calva.evaluateCurrentTopLevelForm\",\n        \"when\": \"calva:activated\"\n    },\n    {\n        \"key\": \"ctrl+x ctrl+e\",\n        \"command\": \"calva.evalCurrentTopLevelFormInREPLWindow\",\n        \"when\": \"calva:activated\"\n    },\n    {\n        \"key\": \"ctrl+alt+c ctrl+alt+space\",\n        \"command\": \"-calva.evalCurrentTopLevelFormInREPLWindow\",\n        \"when\": \"calva:activated\"\n    },\n    {\n        \"key\": \"ctrl+x ctrl+s\",\n        \"command\": \"workbench.action.files.save\"\n    },\n    {\n        \"key\": \"cmd+s\",\n        \"command\": \"-workbench.action.files.save\"\n    },\n    {\n        \"key\": \"cmd+s\",\n        \"command\": \"paredit.spliceSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+alt+s\",\n        \"command\": \"-paredit.spliceSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+cmd+k\",\n        \"command\": \"paredit.cutForwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+x right\",\n        \"command\": \"-paredit.cutForwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+cmd+backspace\",\n        \"command\": \"paredit.cutBackwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+x left\",\n        \"command\": \"-paredit.cutBackwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+1\",\n        \"command\": \"-workbench.action.openEditorAtIndex1\"\n    },\n    {\n        \"key\": \"ctrl+1\",\n        \"command\": \"editor.action.quickFix\",\n        \"when\": \"editorHasCodeActionsProvider && editorTextFocus && !editorReadonly\"\n    },\n    {\n        \"key\": \"cmd+.\",\n        \"command\": \"-editor.action.quickFix\",\n        \"when\": \"editorHasCodeActionsProvider && editorTextFocus && !editorReadonly\"\n    },\n    {\n        \"key\": \"cmd+.\",\n        \"command\": \"editor.action.revealDefinition\",\n        \"when\": \"editorHasDefinitionProvider && editorTextFocus && !isInEmbeddedEditor\"\n    },\n    {\n        \"key\": \"f12\",\n        \"command\": \"-editor.action.revealDefinition\",\n        \"when\": \"editorHasDefinitionProvider && editorTextFocus && !isInEmbeddedEditor\"\n    }\n]\n

    "},{"location":"eval-tips/","title":"Code Evaluation","text":"

    Calva tries to make it easy to evaluate code, supporting interactive development. The fastest path to learning about it is to use the Fire up the Getting Started REPL command, which you can learn more about in the Getting Started section.

    NB: The below assumes you have read about Finding Calva Commands and Shortcuts.

    ","boost":7},{"location":"eval-tips/#interruptingstopping-running-evaluations","title":"Interrupting/stopping running evaluations","text":"

    Sometimes you evaluate things that take a very long time to complete, or might not even ever complete (infinite loops, lazy sequences, things like that). Calva has a command for interrupting running evaluations. You find it in the VS Code command palette, as well as in the REPL status bar item menu, when the REPL is connected.

    ","boost":7},{"location":"eval-tips/#evaluation-in-a-file-editor","title":"Evaluation in a File Editor","text":"

    Calva has many commands for evaluating forms, including the current form and the current top-level form.

    Some of the commands also let you choose what should happen with the results:

    1. Inline. This will display the results (or some of it, if it is long) inline in the editor.
    2. This also creates a hover pane including the full results and a button which will copy the results to the clipboard.
    3. There is also a command for copying the last result to the clipboard.
    4. The full results are always available in the output window.
      • There is a command for showing the output window, allowing for a workflow where you either generally have it closed, or have it as one of the tabs in the same editor group as the files you are working with.
    5. To comments. This will add the results as line comments below the current line.
    6. Replace the evaluated code. This will do what it says, the evaluated code will be replaced with its results.
    ","boost":7},{"location":"eval-tips/#wait-current-form-top-level-form","title":"Wait, Current Form? Top-level Form?","text":"

    These are important concepts in Calva in order for you to create your most effective workflow. This video explains it a bit:

    ","boost":7},{"location":"eval-tips/#current-form","title":"Current Form","text":"

    Default shortcut for evaluating the current form: ctrl+enter.

    The current form either means the current selection, or otherwise is based on the cursor position. Play some with the command Calva: Select current form, ctrl+alt+c s, to figure out what Calva thinks is the current form for some different situations. Try it inside a symbol, adjacent to a symbol (both sides) and adjacent to an opening or closing bracket (again, both sides). Generally the current form is determined like so:

    1. If text is selected, then that text
    2. If the cursor is \u201din\u201d a symbol, then that symbol 
      foob|ar ; foobar\n
    3. If the cursor is adjacent to a form (a symbol or a list of some kind), then that form 
      (foo bar |(baz)) ; (baz)\n
    4. If the cursor is between to forms, then the left side form 
      (foo bar | (baz)) ; bar\n
    5. If the cursor is before the first form of a line, then that form 
      (foo\n| bar (baz)) ; bar\n
    ","boost":7},{"location":"eval-tips/#current-top-level-form","title":"Current Top-level Form","text":"

    Default shortcut for evaluating the current top level form: alt+enter.

    The current top-level form means top-level in a structural sense. It is not the topmost form in the file. Typically in a Clojure file you will find def and defn (and defwhatever) forms at the top level, which also is one major intended use for evaluating top level form: to define and redefine variables. However, Calva does not check the contents of the form in order to determine it as a top-level forms: all forms not enclosed in any other form are top level forms.

    An \u201dexception\u201d is introduced by the comment form. It will create a new top level context, so that any forms immediately inside a (comment ...) form will be considered top-level by Calva. This is to support a workflow with what is often referred to the Rich Comments.

    At the top level the selection of which form is the current top level form follows the same rules as those for the current form.

    ","boost":7},{"location":"eval-tips/#evaluate-enclosing-form","title":"Evaluate Enclosing Form","text":"

    The default keyboard shortcut for evaluating the current enclosing form (the list the cursor is in) is ctrl+shift+enter.

    (let [foo :bar]\n  (when false (str| foo))) ; => \":bar\"\n
    ","boost":7},{"location":"eval-tips/#evaluate-to-cursor","title":"Evaluate to Cursor","text":"

    There are several commands for evaluating a piece of code, closing brackets. It's good, especially in threads, but can also come in handy in other situations, for instance when you want to evaluate something that depends on bindings, such as in a let form.

    ","boost":7},{"location":"eval-tips/#evaluate-from-start-of-list-to-cursor-closing-brackets","title":"Evaluate From Start of List to Cursor, Closing Brackets","text":"

    This command evaluates the text from the start of the current enclosing list to where the cursor is, and it adds the missing closing bracket for you. Convenient for checking intermediate results in thread or doto, or similar pipelines. The cursor is right behind :d in this form:

      (->> [1 1 2 3 5 8 13 21]\n       (partition 2)\n       (zipmap [:a :b :c :d])\n       :d| ; => (13 21)\n       (apply -)\n       (Math/abs))\n

    The default shortcut for this command is ctrl+alt+enter.

    ","boost":7},{"location":"eval-tips/#evaluate-selection-closing-brackets","title":"Evaluate Selection, Closing Brackets","text":"

    This is the most versatile of the \u201devaluation, closing brackets\u201d commands. It will do what it says. \ud83d\ude04 It's extra handy in combination with the command Paredit: Select Backward Up Sexp/Form (shift+ctrl+up). Consider this contrieved form (buggy code, because it was supposed to result in 42, not -42):

    (defn fortytwo-from-thirty\n  []\n  (let [thirty 30]\n    (-> thirty\n        inc            ;1\n        (send-off)\n        (+ 1 2 3)\n        (->>\n         (+ 2 2)       ;2\n         (+))\n        list\n        (->>\n         (into [1])\n         (reduce + 1))\n        (- 1)          ;3\n        (* -1))))\n

    At ;1, you can do backward up sexp (shift+ctrl+up) twice to select up to the (let ..), then issue Evaluate Selection, Closing Brackets. It has the same default keybinding as the command for evaluating the current list up to the cursor: ctrl+alt+enter.

    At ;2 you need select backwards up three times.

    ;3 is included because it is close to the bug. (Which was introduced when the thread-last, ->> was added to make this example.) Please practice the Evaluate Selection, Closing Brackets command to fix the bug.

    ","boost":7},{"location":"eval-tips/#evaluate-from-start-of-top-level-form-to-cursor-closing-brackets","title":"Evaluate From Start of Top Level Form to Cursor, Closing Brackets","text":"

    This command has a default shortcut keybinding of shift+alt+enter. It will create a form from the start of the current top level form, up to the cursor, close all brackets, and this will then be evaluated. Good for examining code blocks up to a certain point. Often comes in handy in Rich comments ((comment ...)).

    Take this example and paste it in a file loaded into the REPL, then place the cursor in front of each line comment and try the command.

    (comment\n (do\n   (def colt-express\n     {:name \"Colt Express\"\n      :categories [\"Family\"\n                   \"Strategy\"]\n      :play-time 40\n      :ratings {:pez 5.0\n                :kat 5.0\n                :wiw 5.0   ; 1, then eval `colt-express`\n                :vig 3.0\n                :rex 5.0\n                :lun 4.0}})\n\n   (defn average [coll]\n     (/ (apply + coll) (count coll)))\n\n   (let [foo-express (-> colt-express\n                         (assoc :name \"Foo Express\")\n                         (assoc-in [:ratings :lyr] 5.0)\n                         (update-in [:ratings :vig] inc))]\n     (->> foo-express   ; 2\n          :ratings      ; 3\n          vals          ; 4\n          average       ; 5\n          ))))\n
    ","boost":7},{"location":"eval-tips/#evaluate-from-start-of-file-to-cursor-closing-brackets","title":"Evaluate From Start of File to Cursor, Closing Brackets","text":"

    Yup, that command also exists. \ud83d\ude04

    ","boost":7},{"location":"eval-tips/#copying-the-inline-results","title":"Copying the inline results","text":"

    There is a command called Copy last evaluation results, ctrl+alt+c ctrl+c.

    This works regardless if you have evaluated in a file editor or in a REPL window.

    ","boost":7},{"location":"eval-tips/#evaluating-in-a-repl-window","title":"Evaluating in a REPL window","text":"

    Since the REPL Window is mostly just a regular file, things work pretty similar at the REPL prompt. You use alt+enter to evaluate. Selecting the current form (default key binding ctrl+w on Mac and shift+alt+right on Windows and Linux) after evaluating will select the result.

    ","boost":7},{"location":"evaluation/","title":"Code Evaluation","text":"

    Calva tries to make it easy to evaluate code, supporting interactive development. The fastest path to learning about it is to use the Fire up the Getting Started REPL command, which you can learn more about in the Getting Started section.

    NB: The below assumes you have read about Finding Calva Commands and Shortcuts.

    ","boost":7},{"location":"evaluation/#interruptingstopping-running-evaluations","title":"Interrupting/stopping running evaluations","text":"

    Sometimes you evaluate things that take a very long time to complete, or might not even ever complete (infinite loops, lazy sequences, things like that). Calva has a command for interrupting running evaluations. You find it in the VS Code command palette, as well as in the REPL status bar item menu, when the REPL is connected.

    ","boost":7},{"location":"evaluation/#evaluation-in-a-file-editor","title":"Evaluation in a File Editor","text":"

    Calva has many commands for evaluating forms, including the current form and the current top-level form.

    Some of the commands also let you choose what should happen with the results:

    1. Inline. This will display the results (or some of it, if it is long) inline in the editor.
    2. This also creates a hover pane including the full results and a button which will copy the results to the clipboard.
    3. There is also a command for copying the last result to the clipboard.
    4. The full results are always available in the output window.
      • There is a command for showing the output window, allowing for a workflow where you either generally have it closed, or have it as one of the tabs in the same editor group as the files you are working with.
    5. To comments. This will add the results as line comments below the current line.
    6. Replace the evaluated code. This will do what it says, the evaluated code will be replaced with its results.
    ","boost":7},{"location":"evaluation/#wait-current-form-top-level-form","title":"Wait, Current Form? Top-level Form?","text":"

    These are important concepts in Calva in order for you to create your most effective workflow. This video explains it a bit:

    ","boost":7},{"location":"evaluation/#current-form","title":"Current Form","text":"

    Default shortcut for evaluating the current form: ctrl+enter.

    The current form either means the current selection, or otherwise is based on the cursor position. Play some with the command Calva: Select current form, ctrl+alt+c s, to figure out what Calva thinks is the current form for some different situations. Try it inside a symbol, adjacent to a symbol (both sides) and adjacent to an opening or closing bracket (again, both sides). Generally the current form is determined like so:

    1. If text is selected, then that text
    2. If the cursor is \u201din\u201d a symbol, then that symbol 
      foob|ar ; foobar\n
    3. If the cursor is adjacent to a form (a symbol or a list of some kind), then that form 
      (foo bar |(baz)) ; (baz)\n
    4. If the cursor is between to forms, then the left side form 
      (foo bar | (baz)) ; bar\n
    5. If the cursor is before the first form of a line, then that form 
      (foo\n| bar (baz)) ; bar\n
    ","boost":7},{"location":"evaluation/#current-top-level-form","title":"Current Top-level Form","text":"

    Default shortcut for evaluating the current top level form: alt+enter.

    The current top-level form means top-level in a structural sense. It is not the topmost form in the file. Typically in a Clojure file you will find def and defn (and defwhatever) forms at the top level, which also is one major intended use for evaluating top level form: to define and redefine variables. However, Calva does not check the contents of the form in order to determine it as a top-level forms: all forms not enclosed in any other form are top level forms.

    An \u201dexception\u201d is introduced by the comment form. It will create a new top level context, so that any forms immediately inside a (comment ...) form will be considered top-level by Calva. This is to support a workflow with what is often referred to the Rich Comments.

    At the top level the selection of which form is the current top level form follows the same rules as those for the current form.

    ","boost":7},{"location":"evaluation/#evaluate-enclosing-form","title":"Evaluate Enclosing Form","text":"

    The default keyboard shortcut for evaluating the current enclosing form (the list the cursor is in) is ctrl+shift+enter.

    (let [foo :bar]\n  (when false (str| foo))) ; => \":bar\"\n
    ","boost":7},{"location":"evaluation/#evaluate-to-cursor","title":"Evaluate to Cursor","text":"

    There are several commands for evaluating a piece of code, closing brackets. It's good, especially in threads, but can also come in handy in other situations, for instance when you want to evaluate something that depends on bindings, such as in a let form.

    ","boost":7},{"location":"evaluation/#evaluate-from-start-of-list-to-cursor-closing-brackets","title":"Evaluate From Start of List to Cursor, Closing Brackets","text":"

    This command evaluates the text from the start of the current enclosing list to where the cursor is, and it adds the missing closing bracket for you. Convenient for checking intermediate results in thread or doto, or similar pipelines. The cursor is right behind :d in this form:

      (->> [1 1 2 3 5 8 13 21]\n       (partition 2)\n       (zipmap [:a :b :c :d])\n       :d| ; => (13 21)\n       (apply -)\n       (Math/abs))\n

    The default shortcut for this command is ctrl+alt+enter.

    ","boost":7},{"location":"evaluation/#evaluate-selection-closing-brackets","title":"Evaluate Selection, Closing Brackets","text":"

    This is the most versatile of the \u201devaluation, closing brackets\u201d commands. It will do what it says. \ud83d\ude04 It's extra handy in combination with the command Paredit: Select Backward Up Sexp/Form (shift+ctrl+up). Consider this contrieved form (buggy code, because it was supposed to result in 42, not -42):

    (defn fortytwo-from-thirty\n  []\n  (let [thirty 30]\n    (-> thirty\n        inc            ;1\n        (send-off)\n        (+ 1 2 3)\n        (->>\n         (+ 2 2)       ;2\n         (+))\n        list\n        (->>\n         (into [1])\n         (reduce + 1))\n        (- 1)          ;3\n        (* -1))))\n

    At ;1, you can do backward up sexp (shift+ctrl+up) twice to select up to the (let ..), then issue Evaluate Selection, Closing Brackets. It has the same default keybinding as the command for evaluating the current list up to the cursor: ctrl+alt+enter.

    At ;2 you need select backwards up three times.

    ;3 is included because it is close to the bug. (Which was introduced when the thread-last, ->> was added to make this example.) Please practice the Evaluate Selection, Closing Brackets command to fix the bug.

    ","boost":7},{"location":"evaluation/#evaluate-from-start-of-top-level-form-to-cursor-closing-brackets","title":"Evaluate From Start of Top Level Form to Cursor, Closing Brackets","text":"

    This command has a default shortcut keybinding of shift+alt+enter. It will create a form from the start of the current top level form, up to the cursor, close all brackets, and this will then be evaluated. Good for examining code blocks up to a certain point. Often comes in handy in Rich comments ((comment ...)).

    Take this example and paste it in a file loaded into the REPL, then place the cursor in front of each line comment and try the command.

    (comment\n (do\n   (def colt-express\n     {:name \"Colt Express\"\n      :categories [\"Family\"\n                   \"Strategy\"]\n      :play-time 40\n      :ratings {:pez 5.0\n                :kat 5.0\n                :wiw 5.0   ; 1, then eval `colt-express`\n                :vig 3.0\n                :rex 5.0\n                :lun 4.0}})\n\n   (defn average [coll]\n     (/ (apply + coll) (count coll)))\n\n   (let [foo-express (-> colt-express\n                         (assoc :name \"Foo Express\")\n                         (assoc-in [:ratings :lyr] 5.0)\n                         (update-in [:ratings :vig] inc))]\n     (->> foo-express   ; 2\n          :ratings      ; 3\n          vals          ; 4\n          average       ; 5\n          ))))\n
    ","boost":7},{"location":"evaluation/#evaluate-from-start-of-file-to-cursor-closing-brackets","title":"Evaluate From Start of File to Cursor, Closing Brackets","text":"

    Yup, that command also exists. \ud83d\ude04

    ","boost":7},{"location":"evaluation/#copying-the-inline-results","title":"Copying the inline results","text":"

    There is a command called Copy last evaluation results, ctrl+alt+c ctrl+c.

    This works regardless if you have evaluated in a file editor or in a REPL window.

    ","boost":7},{"location":"evaluation/#evaluating-in-a-repl-window","title":"Evaluating in a REPL window","text":"

    Since the REPL Window is mostly just a regular file, things work pretty similar at the REPL prompt. You use alt+enter to evaluate. Selecting the current form (default key binding ctrl+w on Mac and shift+alt+right on Windows and Linux) after evaluating will select the result.

    ","boost":7},{"location":"fiddle-files/","title":"Fiddle Files Support","text":"

    In the podcast Functional Design in Clojure, Episode 014: Fiddle with the REPL, they discuss a workflow in which you keep some of your exploratory code in separate files, which they call Fiddle Files. It's like Rich Comments, and the files often consist of such comments. The Fiddle files are typically not on the classpath, and are only loaded in the REPL by you when you are developing your project. Some developers keep personal fiddle files. In some projects they are meant to be shared, and in other projects it's a combination.

    Calva has some extra support for the fiddle file workflow, beyond what VS Code offers in terms of navigating between files. The support comes in the form of three commands supported by a little configuration.

    ","boost":5},{"location":"fiddle-files/#the-three-fiddle-file-commands","title":"The Three Fiddle File Commands","text":"

    The commands let you quickly navigate between your implementation code (called Source here) and your Fiddle file, and to evaluate the Fiddle file without leaving the Source file.

    Command Action Shortcut Active Calva: Open Fiddle File for Current File Opens the Fiddle file corresponding to the current Clojure Source file. ctrl+alt+cf When the currently active file is not a Fiddle file. Calva: Open Source File for Current Fiddle File Opens the Source file corresponding to the current Fiddle file. ctrl+alt+cf When the currently active file is a Fiddle file + there is an existing, and corresponding, source file. Calva: Evaluate Fiddle File for Current File Evaluates the Fiddle file corresponding to the current Clojure Source file. ctrl+alt+cctrl+alt+f When the currently active file is not a Fiddle file.

    The commands for opening and evaluating corresponding Fiddle files will offer to Create the Fiddle file if it does not already exist. But the Calva: Open Source File for Current Fiddle File command will not offer to create the target file.

    What does corresponding mean here? Without any configuration Calva will look for \u201csibling\u201d files, where files with Clojure file extensions (E.g. .clj, .cljs, .bb) will be treated as Source files, and files with the .fiddle extension will be treated as Fiddle files. \"Sibling file\" here means residing side by side in the file system. If this default behaviour is not your cup of tea, there is some flexibility added by configuration.

    ","boost":5},{"location":"fiddle-files/#the-fiddle-file-configuration","title":"The Fiddle File Configuration","text":"

    To know how to map between Fiddle <-> Source files, Calva has three different modes of operation:

    1. The sibling files, as described above. This is the default. Example:
      • src/a/b/c.cljc corresponding to:
      • src/a/b/c.fiddle
    2. Parallel directory structures. Mapping a Source directory tree to a Fiddle directory tree. Example:
      • src/a/b/c.cljc corresponding to:
      • env/dev/fiddles/a/b/c.cljc
    3. A dedicated Fiddle file for a Source directory tree. E.g. both:
      • src/a/b/c.cljc and:
      • src/d/e/f.cljc corresponding to:
      • env/dev/fiddles/x.cljc

    The setting is named calva.fiddleFilePaths and is an array of source and fiddle root paths, relative to the project root.

    The Project Root

    It is important to note that the project root depends on whether you are connected to a REPL or not, and to which project you are connected, in case the workspace contains several projects.

    Without a REPL connection (disregarding that fiddle files are not very interesting then) the project root is the same as the first workspace root. And if you have a regular VS Code window open, it is the root of the folder you have opened in that window.

    With a REPL connection, the project root will be the root of the project, i.e. where the project file (deps.edn, project.clj, shadow-cljs.edn) is.

    ","boost":5},{"location":"fiddle-files/#example-configurations","title":"Example Configurations","text":"","boost":5},{"location":"fiddle-files/#single-parallel-directory-structure","title":"Single Parallel Directory Structure","text":"
    \"calva.fiddleFilePaths\": [\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddles\"]\n  }\n]\n

    This will make any file in the src directory tree correspond to a matching file with the same relative path. E.g.:

    ","boost":5},{"location":"fiddle-files/#single-dedicated-fiddle-file","title":"Single Dedicated Fiddle File","text":"

    If you generally work with one Fiddle file at a time, you can configure a mapping to a Dedicated Fiddle file. E.g.:

    \"calva.fiddleFilePaths\": [\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddle.clj\"]\n  },\n]\n

    This will make any file in the src directory tree correspond to the same Fiddle file. E.g.:

    Jumping from a dedicated fiddle to a source file

    Calva's command for opening the corresponding source file won't work in this case because it is a one->many situation. If you want to open the last file you worked with before using Open Fiddle File for Current File, consider using the VS Code command: Go Previous.

    ","boost":5},{"location":"fiddle-files/#multiple-mappings","title":"Multiple Mappings","text":"

    The configuration is an array so that you can configure different mappings for different Source directories. Given several mappings with overlapping Source, the longest mapping will win. Given several mappings with the same Source, the first one will win, unless one of them is a dedicated Fiddle, in which case that one will win.

    \"calva.fiddleFilePaths\": [\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddles\"]\n  },\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddle.clj\"]\n  },\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddle.cljs\"]\n  },\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddle.bb\"]\n  },\n  {\n    \"source\": [\"src\", \"b\"],\n    \"fiddle\": [\"env\", \"dev\", \"b-fiddles\"]\n  },\n]\n

    With this configuration we would get a behaviour like so:

    ","boost":5},{"location":"fiddle-files/#tips","title":"Tips","text":"

    Organize your Fiddle files such that they do not get automatically loaded as part of your application. This can lead to strange errors and hard-to-detect bugs. Most often it should only be you manually loading the fiddle file, not clj/clojure or Leiningen or any such system which loads your application.

    When you want your fiddle code to be evaluated in the same workspace as its corresponding Source file, you can use the same namespace declaration for both files. The linter might complain, but the REPL will happily comply.

    If you primarily evaluate the fiddle file using the provided command for it, from the Source files, you can omit the namespace declaration, and Calva will evaluate it in the namespace of the Source file.

    The linter and fiddle files

    For some fiddle files you will get a lot of linter warnings, because clj-kondo doesn't know about fiddle files, and they are often not on the classpath. You might find yourself wanting to silence some linters for some fiddle files. E.g. like this:

    (ns main.core\n  {:clj-kondo/config\n   '{:linters {:unresolved-symbol {:level :off}}}})\n

    See clj-kondo Configuration for more on what options you have for this.

    ","boost":5},{"location":"fiddle-files/#see-also","title":"See Also","text":"","boost":5},{"location":"finding-commands/","title":"Finding Calva Commands","text":"

    Calva relies a lot on that VS Code makes it really easy to find commands by opening the command palette: ctrl+shift+p (Windows/Linux), cmd+shift+p (Mac), and then start typing some words (or parts of words) that you think might be in the command.

    To leverage this, all Calva commands are prefixed with Calva. As an example, say you want to find commands related to evaluating the top level form. Then you can do this:

    1. Open the command palette
    2. Type calevtop

    VS Code will match cal to \u201dCalva\u201d, ev to \u201dEvaluate\u201d, and top to \u201dTop\u201d. It looks like so:

    As you can see on the screenshot, VS Code will also reveal the keyboard shortcut for each command. My advice is to make it a habit to try to remember those shortcuts and use them for a more effective workflow.

    Now might be a good time to see Calva Top 10 Commands

    "},{"location":"finding-commands/#all-the-settings-and-commands","title":"All the Settings and Commands","text":"

    Did you know? There is a complete list of Calva settings and commands in the Contributions tab of the Calva entry in the Extensions pane in VS Code.

    "},{"location":"finding-commands/#toggling-keyboard-shortcuts-onoff","title":"Toggling Keyboard Shortcuts On/Off","text":"

    The command calva.toggleKeybindingsEnabled can be used to quickly enable and disable (almost) all keyboard shortcuts. This allows you to quickly toggle between Calva keybindings and other keybindings which would otherwise not be available when Calva is enabled. This is particularly useful with the Paredit keyboard shortcuts, whose default shortcuts conflict with the default VS Code shortcuts for textual (non-structural) editing.

    By default it is not bound to a shortcut so as not to cause confusion by users unwittingly pressing it, but if this is something you'd like to use often, you may want to bind it to a shortcut.

    "},{"location":"formatting/","title":"Formatting","text":"

    We have tried to make Calva's formatter so that it just works. It is enabled by default for Clojure files, and with the default configuration it mostly follows Bozhidar Batsov's Clojure Style Guide. Calva uses cljfmt for the formatting.

    Tab formats the current surrounding form

    Calva's code formatter sets the default keybinding of its Format Current Form command to tab. Meaning that most often when things look a bit untidy, you can press tab to make things look pretty. Good to know, right? For performance reasons it only formats the current enclosing form, so sometimes you want to move the cursor up/out a form (ctrl+up) first. See The Paredit Guide for more on moving the cursor structurally through your code.

    With the default settings, Calva's formatting behaves like so:

    Infer parens at will

    Calva has a command that will \u201dheal\u201d the bracket structure if it is correctly indented using Parinfer Infer parens. This command is default bound to ctrl+alt+p i.

    Also: If you have Format on Save enabled in VS Code, it will be Calva doing the formatting for Clojure files.

    Calva's formatting is mostly about indenting, but it also (again, defaults):

    Not a fan of some default setting? The formatter is quite configurable.

    "},{"location":"formatting/#format-current-form-command-variants","title":"Format current form command variants","text":"

    There are three special commands for formatting the current form:

    "},{"location":"formatting/#1-format-and-align-current-form","title":"1. Format and Align Current Form","text":"

    Aligns associative structures and bindings in two columns. See more below.

    "},{"location":"formatting/#2-format-current-form-and-trim-space-between-forms","title":"2. Format Current Form and trim space between forms","text":"

    This formats the text, and trims consecutive, non-indent, whitespace on a line to just one space. Something like:

    (let [a    :b]\n(str \"foo\"     \"bar\" \"baz\"\n\"a\"    a))\n

    Becomes:

    (let [a :b]\n  (str \"foo\" \"bar\" \"baz\"\n       \"a\" a))\n

    Basically, it behaves like if :remove-multiple-non-indenting-spaces? true was added to the cljfmt config. Which, in fact, is what happens. Calva merges that onto your cljfmt config when this command is used.

    "},{"location":"formatting/#3-replace-current-form-or-selection-with-pretty-printed-form","title":"3. Replace Current Form (or Selection) with Pretty Printed Form","text":"

    This command will run the code of the Current Form through Calva's pretty printer (the engine named calva, which is using zprint) and replace the current form inline in the editor with the pretty printed results.

    Unlike with the \u201dreal\u201d Calva Formatter, which never breaks up lines, this one will follow your pretty printing options and break up lines if you have set maxWidth to something that calls for breaking up lines.

    Applies to the other Current Form

    Unlike the other Format commands, which applies to the current enclosing form, this one applies to the Current Form, same as with evaluations. That is because this is not really part of the Calva formatter, but rather is a convenience command for tidying up code or data.

    "},{"location":"formatting/#configuration","title":"Configuration","text":"

    You can adjust the above mentioned defaults, and the default indents, by configuring the formatting using cljfmt's configuration EDN.

    This configuration can either be provided via a file or via clojure-lsp. See Providing configuration via clojure-lsp below.

    "},{"location":"formatting/#providing-configuration-via-a-config-file","title":"Providing configuration via a config file","text":"

    Calva will look for the configuration in one of the default cljfmt paths ('.cljfmt.edn', '.cljfmt.clj', 'cljfmt.edn', or 'cljfmt.clj' in the workspace root). If your file is somewhere else use the calva.fmt.configPath to tell Calva where to find it. The path should either be absolute, or relative to the workspace root directory. If your config file is somewhere in the workspace root, Calva will hot reload it when you update it.

    Wherever the config file is, a suggested path for providing your configuration is to start changing the Calva formatting defaults by pasting the following map into a file and save it.

    {:remove-surrounding-whitespace? true\n :remove-trailing-whitespace? true\n :remove-consecutive-blank-lines? false\n :insert-missing-whitespace? true\n :remove-multiple-non-indenting-spaces? false}\n

    If the file is in the workspace, you can quickly test how different settings affect the formatting. Try:

    1. Adding :align-associative? true to the config
    2. then save
    3. then hit tab, and see what happens.
    :align-associative? is experimental

    This particular setting is experimental and known to cause trouble together with namespaced keywords. Consider using ctrl+alt+l instead of tab as your formatting command, instead of enabling this setting. See below for more info about this. See more below about this.

    No Leiningen config support

    The cljfmt docs mention the :cljfmt config key of Leiningen projects. Calva does not yet read the config from there, so if your Leiningen project has such a configuration, you will need to copy it out into a file.

    "},{"location":"formatting/#providing-configuration-via-clojure-lsp","title":"Providing configuration via clojure-lsp","text":"

    If you work in a team where some members use clojure-lsp for formatting, you can make Calva format using the same configuration by telling setting calva.fmt.configPath to CLOJURE-LSP (case sensitive). See Clojure LSP Settings) for how to provide the configuration. (It might not be provided from where you think it is, specifically check clojure-lsp's global config in you user home directory.) Use the command Calva Diagnostics: Clojure-lsp Server Info to see what cljfmt configuration is being used (under the cljfmt-raw key).

    Note that doing this you will not have hot reload of the formatting configuration, and of course you will be depending on that clojure-lsp is running and functioning.

    "},{"location":"formatting/#indentation-rules","title":"Indentation rules","text":"

    The cljfmt indents are highly configurable. They, and the rest of the configuration options, are masterly detailed here.

    :extra-indents vs :indents

    Since Calva v2.0.383 we are using cljfmt 0.11.x which has a breaking configuration change. From the cljfmt README:

    The :indents key has been split into :indents and :extra-indents. The :indents key replaces all default indents, while the :extra-indents key will append to the default indents.

    If something prevents you from using a config with :extra-indents, there's an escape hatch to keep using the :indents key as before, by adding :legacy/merge-indents? true to the config map.

    Calva is an extra good tool for experimenting with these settings. cljfmt doesn't care about keys in the map that it doesn't know about so you can sneak in test code there to quickly see how it will get formatted by certain rules. Try this, for instance:

    {:remove-surrounding-whitespace? true\n :remove-trailing-whitespace? true\n :remove-consecutive-blank-lines? false\n :insert-missing-whitespace? false\n :indents {#re \"^\\w\" [[:inner 0]]}\n :test-code\n (concat [2]\n         (map #(inc (* % 2))\n              (filter #(aget sieved %)\n                      (range 1 hn))))}\n

    Save, then hit tab, and the code should get formatted like so:

     :test-code\n (concat [2]\n    (map #(inc (* % 2))\n      (filter #(aget sieved %)\n        (range 1 hn))))\n

    That's somewhat similar to Nikita Prokopov's Better Clojure Formatting suggestion. (Please be aware that this setting might not be sufficient to get complete Tonsky Formatting, please share any settings you use to get full compliance.)

    "},{"location":"formatting/#rich-comments","title":"Rich Comments","text":"

    To encourage use of (comment ...) forms for development, the default settings give these forms get a special treatment when formatting. Use the calva.fmt.keepCommentTrailParenOnOwnLine setting to control this behaviour. See Rich Comments first.

    "},{"location":"formatting/#etecetera","title":"Etecetera","text":""},{"location":"formatting/#about-aligning-associative-forms","title":"About aligning associative forms","text":"

    Calva loooks in the config map for the key :align-associative? and if it is true it will use an old version of cljfmt which is patched with functionality for doing this alignment. Note, though:

    You are hereby warned, and let us also remind you about the Format and Align Current Form command which lets you apply this formatting a bit more surgically, and on demand.

    This old version of cljfmt is inlined in the Calva repository along with the discontinued rewrite-cljs project. Regard it as frozen code. If you want Calva's formatter to have full support for newer Clojure constructs and the bugs in the alignment code fixed, contribute to cljfmt. See this issue for starting to collect context.

    "},{"location":"get-started-with-clojure/","title":"Get Started with Clojure","text":"

    Welcome to a zero-install, interactive, guide to get you started with Clojure using:

    I have VS Code and Java

    Clojure runs on the JVM. How to install it is a big topic. Since you have already done that, you can, if you want, choose to install Calva in your local VS Code and fire up the Getting Started REPL. By all means read this page anyway, you can just skip the Gitpod parts.

    Also: If you are using Windows your Java might have a bug that prevents things from working. Then you might want to defer fixing that and use the zero-install option first.

    Is Gitpod Code exactly as VS Code?

    Almost! But, yeah, there are some difference between regular VS Code and Gitpod's ditto. Most of it doesn't matter, but finding the main menu can be a bit tricky:

    ","boost":10},{"location":"get-started-with-clojure/#what-youll-learn","title":"What you'll learn","text":" I am not convinced I should spend time on learning Clojure

    Fair enough. We can recommend watching any or all of these videos to get excited about Clojure and the rather unique mood of development it offers:

    ","boost":10},{"location":"get-started-with-clojure/#what-you-wont-learn","title":"What you won't learn","text":" Why won't I learn about this?

    All in due time. \ud83d\ude04 It can be a bit confusing with all the things you find out about installing Clojure and creating projects when searching for information about it. We want you to relax about all that and just enjoy learning a bit about this fantastic programming language and the wonderful mode of development it offers.

    There is a lot of info about this out there already. And since you will learn where to find Clojurians, you will also find guidance. But we suggest do these things later. First, let's focus on having fun with Interactive Programming!

    ","boost":10},{"location":"get-started-with-clojure/#what-you-need","title":"What you need","text":" The browser ate my keyboard shortcuts!

    There is always a competition for which system gets to catch keyboard shortcuts first. This worsens a bit when an application like VS Code runs in the web browser. Remember this if some shortcut/command doesn't work.

    On some machines, with some web browsers, some shortcuts are caught by the web browser and instead re-opening a closed tab or whatever. These have been observed:

    Sometimes the workaround is to redefine the shortcuts in VS Code, sometimes making your web browser stop catching the shortcut.

    I am new to VS Code

    You might want to have a look at this Getting Started with VS Code video. (You can of course ignore the parts about installing for now.) Also, have this overview of the VS Code interface handy.

    ","boost":10},{"location":"get-started-with-clojure/#how-it-works","title":"How it works","text":"
    1. You will open an instance of VS Code in a development environment running in the browser. The environment will have Java, Clojure tools, and Calva installed.
      • Gitpod Sign-in You will be asked to sign in to Gitpod, if you aren't already. You need to use the \u201dSign in with GitHub\u201d option.
    2. Instructions will be automatically displayed (very brief such, because it is mainly about firing up the Getting Started REPL)
    3. The guides are a mix of prose (in Clojure line comments), Clojure code, and exercises. What's extra poetic is that you will use Calva and Clojure to learn Calva and Clojure.

    Use a desktop/laptop computer. Even if it actually works on the phone, it is far from convenient.

    It sometimes takes a while (several minutes) for the environment to initialize. Take some deep breaths and be patient. \ud83d\ude0e

    ","boost":10},{"location":"get-started-with-clojure/#lets-go","title":"Let's go!","text":"

    Ready? Awesome. Click this button to start the guide in a new browser tab.

    https://gitpod.io/#https://github.com/PEZ/get-started-with-clojure Stuck? Something not working? Or just unclear?

    Please don't hesitate to reach out for help, should you get stuck. See below for where to find Clojurians. As for the Calva team, we are almost always (true story) to be found at the Clojurians Slack, especially in the #calva Channel. We are @pez and @bringe there.

    Happy Interactive Programming! \u2764\ufe0f

    ","boost":10},{"location":"get-started-with-clojure/#and-where-do-i-find-those-clojurians","title":"And where do I find those Clojurians?","text":"

    We Clojurians inhabit a lot of community platforms. I'll list some of the more popular ones here in some order of popularity.

    You can also ask questions, and find answers, about Clojure at ask.clojure.org

    ","boost":10},{"location":"get-started-with-clojure/#learn-and-practice-clojure-using-rich-4clojure","title":"Learn and Practice Clojure using Rich 4Clojure","text":"

    If you like the style of interactive learning that this guide provides, you should definitely check Rich 4Clojure out. It also can be used in the zero-installed way.

    You can regard it as a companion to this guide. It is aimed at practicing Clojure, starting at the elementary levels, bringing you to advanced stuff.

    Can I use Rich 4Clojure instead of this guide?

    We suggest you start by opening up this guide and do the Calva part of the excerises. Then use the welcome_to_clojure.clj guide in combination with Rich 4Clojure..

    ","boost":10},{"location":"get-started-with-clojure/#run-the-clojure-exercism-track-in-your-browser","title":"Run the Clojure Exercism Track in your browser","text":"

    In a similar manner to the Get Started with Clojure project, you can run the Clojure Exercism Track in your browser without installing anything and with full Interactive Programming enabled using this Template project.

    ","boost":10},{"location":"get-started-with-clojure/#clojuredocs","title":"ClojureDocs","text":"

    Clojurians draw tremendous value from ClojureDocs. At ClojureDocs the concise documentation for Clojure core functions, etcetera, are amended with examples and advice from fellow Clojurians. Crowdsourcing at its very best! It is a big part of the reason why you won't find an abundance of Clojure information at StackOverflow.

    ","boost":10},{"location":"get-started-with-clojure/#other-learning-resources","title":"Other learning resources","text":"","boost":10},{"location":"get-started-with-clojure/#help-us-help-beginners","title":"Help us help beginners","text":"

    Give us feedback. Spread the word. Please consider:

    Please also consider other ways to contribute.

    Thanks! \ud83d\ude4f

    ","boost":10},{"location":"getting-started/","title":"Getting Started","text":"

    Depending on wether you want to just start a Clojure REPL or you have a project you want to work with, getting started looks similar but a bit different. Regardless, you need to first:

    ","boost":10},{"location":"getting-started/#install-vs-code-and-calva","title":"Install VS Code and Calva","text":"
    1. Downloading VS Code and run the installer.
      • Also get aquainted to the basics of VS Code, if you aren't already. Here's an excellent intro: Getting Started with VS Code
    2. Install Calva. The easiest way to do that is to start VS Code and search for Calva in the VS Code Extension pane, then click Install.
    ","boost":10},{"location":"getting-started/#say-hello-to-calva","title":"Say hello to Calva","text":"

    If you have a Clojure or ClojureScript project, you will be interested in how to get Calva connected to the REPL of your project. But before you run over there, you might want to familiarize yourself with Calva a bit, which you can do without a project.

    The demo tells you about the command (and some about the Clojure Beginner's material that it makes available).

    I am completely new to Clojure

    The \u201dGetting Started\u201d REPL below introduces you to Clojure as well as to Calva. You might however, not want to start with installing the right version of Java and such to run the guide. If so you should definitely check the Get Started with Clojure guide on this site.

    Three clicks will have you running Calva in your browser with the REPL ready to serve.

    I don't have Java installed

    If you like, you can defer installing anything at all and still get started with Calva (not kidding).

    See Get Started with Clojure.

    ","boost":10},{"location":"getting-started/#theres-a-getting-started-repl","title":"There's a \u201dGetting Started\u201d REPL","text":"

    If you are new to Calva, a good place to start is using the command Fire up the \u201dGetting Started\u201d REPL. (You can open the command palette using the VS Code top menu by going to View -> Command Palette... or by running the associated keyboard shortcut for your OS.) Demo:

    It will open up a three files in a temporary directory, and start and connect a REPL. The files are:

    The only prerequisite here is that you have Java installed. No pre-installed clojure tools required. (You will want to install these tools later, of course.)

    Note

    On Windows the Oracle Java installer sets Java up in some funny way so that the Getting Started REPL fails to start. We are figuring about workarounds for this, but for now, if you are on Windows, you will need to make VS Code have some other Java in the PATH of its environment for this feature to work. See this issue on the Calva repo for more on this, including any progress.

    ","boost":10},{"location":"getting-started/#there-are-standalone-clojurescript-quick-start-repls","title":"There are standalone \u201dClojureScript Quick Start\u201d REPLs","text":"

    Without creating a project structure or installing anything but Calva, you can start standalone ClojureScript REPLs both in a browser and for node:

    The browser REPL app looks like so:

    ","boost":10},{"location":"getting-started/#you-have-a-project","title":"You have a Project?","text":"

    If you are new to Calva, please consider the above option first. Then when it will be time to get Calva connected to the REPL of your project.

    ","boost":10},{"location":"getting-started/#clojure-resources","title":"Clojure Resources","text":"

    If you are new to Clojure or ClojureScript altogether, please check out the guide material on the respective official sites:

    There are also many great books on Clojure. Clojure for the Brave and True can be read for free online. It is a great resource for beginners.

    ","boost":10},{"location":"getting-started/#there-is-also-standalone-repl","title":"There is also Standalone REPL","text":"

    When you are more familiar with Calva, and want a standalone REPL, there is a separate command: Start a standalone REPL (not in project). It will open up a user.clj in a temporary directory, containing only an (ns user) form, and start and connect the REPL.

    ","boost":10},{"location":"getting-started/#dram-where-the-guides-live","title":"Dram - Where the Guides Live","text":"

    The command for starting the Getting Started REPL will download the files from this repository. It is very much work in progress, and there is not even a finished Clojure Beginner's Guide there yet. When you run the command again, and from then on, you will get the option to download new files or keep using your existing. Downloading new ones will not overwrite your existing ones, because they will be downloaded to a new temp directory. You can find the directory easily using VS Codes context menu command for revealing a file in the Explorer/Finder.

    ","boost":10},{"location":"getting-started/#one-last-thing","title":"One Last Thing","text":"

    Happy coding! \u2665\ufe0f

    ","boost":10},{"location":"hiccup/","title":"Converting HTML to Hiccup","text":"

    Calva can help you convert HTML to Hiccup.

    ","boost":7},{"location":"hiccup/#features","title":"Features","text":"","boost":7},{"location":"hiccup/#three-commands","title":"Three commands","text":"

    The resulting data structure is formatted with zprint using it's :style :hiccup configuration.

    ","boost":7},{"location":"hiccup/#conversion-capabilities","title":"Conversion capabilities","text":"

    In addition to, optionally, being able to convert style attributes to maps and kebab-case attributes, the conversion:

    ","boost":7},{"location":"hiccup/#it-is-somewhat-configurable","title":"It is somewhat configurable","text":"

    The Hiccup converstion can be tweaked with two options using the setting calva.html2HiccupOptions, which is a map/object:

    ","boost":7},{"location":"hiccup/#copy-as-menus-copy-html-as-hiccup","title":"Copy as menus: Copy HTML as Hiccup","text":"

    The Copy HTML as Hiccup command is available from VS Code's Edit menu, as well as the editor context menu, in both cases under the Copy as sub menu.

    ","boost":7},{"location":"hiccup/#the-commands-take-arguments","title":"The commands take arguments","text":"

    This options map can also be provided as an argument to the commands, so you can bind keyboard shortcuts to a particular configuration for the conversion.

    The command calva.convertHtml2Hiccup takes a map as an argument:

    The calva.pasteHtmlAsHiccup and calva.copyHtmlAsHiccup commands takes only a calva.html2HiccupOptions map.

    ","boost":7},{"location":"hiccup/#example-keyboard-shortcuts","title":"Example keyboard shortcuts","text":"

    The commands have no default keyboard shortcuts, you use the Command Palette to execute them, or you bind your own shortcuts. Here are some examples:

        // calva.convertHtml2Hiccup\n    {\n        // With args, `\"toUntitled\": true` is necessary for keyboard shortcuts\n        // without it, the command just returns the result to the caller\n        \"key\": \"ctrl+alt+c ctrl+h\",\n        \"command\": \"calva.convertHtml2Hiccup\",\n        \"args\": {\"toUntitled\": true, \"options\": {\"mapify-style?\": false}}\n    },\n    {\n        // Only for completeness, providing the HTML is only useful from e.g. Joyride \n        \"key\": \"ctrl+alt+c shift+h\",\n        \"command\": \"calva.convertHtml2Hiccup\",\n        \"args\": {\"html\": \"<foo style='a: b' bar='baz'>gaz<foo>\", \"toUntitled\": true}\n    },\n    {\n        // Without args, the command uses the `calva.html2HiccupOptions` configuration\n        // And writes the results to an Untitled document\n        \"key\": \"ctrl+alt+c h\",\n        \"command\": \"calva.convertHtml2Hiccup\",\n    },\n\n    // calva.pasteHtmlAsHiccup\n    {\n        // Override the `calva.html2HiccupOptions` configuration\n        \"key\": \"ctrl+alt+h ctrl+v\",\n        \"command\": \"calva.pasteHtmlAsHiccup\",\n        \"args\": {\"mapify-style?\": true, \"kebab-attrs?\": true}\n    },\n    {\n        // Without args, the command uses the `calva.html2HiccupOptions` configuration\n        \"key\": \"ctrl+alt+h v\",\n        \"command\": \"calva.pasteHtmlAsHiccup\"\n    },\n\n    // calva.copyHtmlAsHiccup\n    {\n        // Override the `calva.html2HiccupOptions` configuration\n        \"key\": \"ctrl+alt+h ctrl+c\",\n        \"command\": \"calva.copyHtmlAsHiccup\",\n        \"args\": {\"mapify-style?\": false, \"kebab-attrs?\": true}\n    },\n    {\n        // Without args, the command uses the `calva.html2HiccupOptions` configuration\n        \"key\": \"ctrl+alt+h c\",\n        \"command\": \"calva.copyHtmlAsHiccup\"\n    },\n

    The default/args-less bindings are placed last because reasons.

    ","boost":7},{"location":"hiccup/#using-from-joyride-or-some-other-vs-code-extension","title":"Using from Joyride (or some other VS Code extension)","text":"

    As with any VS Code command using these from Joyride is a matter of calling executeCommand.

    ","boost":7},{"location":"hiccup/#calvapastehtmlashiccup-and-calvapastehtmlashiccup","title":"calva.pasteHtmlAsHiccup and calva.pasteHtmlAsHiccup","text":"
    (-> (vscode/commands.executeCommand \"calva.pasteHtmlAsHiccup\"\n                                    #js {:mapify-style? true})\n    (.then ...))\n\n(-> (vscode/commands.executeCommand \"calva.copyHtmlAsHiccup\"\n                                    #js {:mapify-style? true})\n    (.then ...))\n
    ","boost":7},{"location":"hiccup/#calvaconverthtml2hiccup","title":"calva.convertHtml2Hiccup","text":"

    Without options the command behaves just like selecting the command from the command palette. If there is a selection it will be converted, otherwise the whole file. The result will be opened in a new Untitled document.

    (-> (vscode/commands.executeCommand \"calva.convertHtml2Hiccup\")\n    (.then ...))\n

    Called with arguments it will by default return an object with a .-result member which is a string with the Hiccup.

    (-> (vscode/commands.executeCommand \"calva.convertHtml2Hiccup\" \n                                    #js {:html \"<foo class='clz1 clz2>bar</foo>\"})\n    (.then #(println (.-result %))))\n\n(-> (vscode/commands.executeCommand \"calva.convertHtml2Hiccup\" \n                                    #js {:options #js {:mapify-style? false}})\n    (.then #(println (.-result %))))\n

    To make it put the text in a new Untitled document instead, provide the argument option :toUntitled true

    (-> (vscode/commands.executeCommand \"calva.convertHtml2Hiccup\" \n                                    #js {:toUntitled true\n                                         :html \"<foo class='clz1 clz2>bar</foo>\"\n                                         :options #js {:mapify-style? true\n                                                       :kebab-attrs? true}})\n    (.then ...))\n
    ","boost":7},{"location":"jack-in-guide/","title":"Learn about Calva Jack-in","text":"

    The Calva Jack-In Academy, by @pez

    Like with CIDER Jack-in, Calva's let-me-help-you-start-your-project-and-connect feature might seem a bit mysterious. It really is helpful, but also really isn't mysterious. Here are a few things about it that is good to know about.

    Note

    If you came here to find out how to configure the versions of the dependencies that Calva Jack-in injects, see Customizing Calva - Jack-in Dependency Versions.

    ","boost":6},{"location":"jack-in-guide/#what-it-solves","title":"What it Solves","text":"

    At first it might seem that something like lein repl in a terminal and then connecting Calva is enough. It sometimes might be, but only if you are in luck. To provide many of its IDE features, Calva relies on nREPL middleware, mainly cider-nrepl and, for ClojureScript, piggieback. When starting your Clojure(Script) app and its REPL, it needs to be started with these dependencies satisfied. There are mainly three ways this can be achieved.

    1. In the project definition (files like project.clj, deps.edn, shadow-cljs.edn, and combination of these).
    2. In your user profile (files like ~/.lein/profiles.clj and ~/.clojure/deps.edn).
    3. On the command line.

    Because 1 and 2 are hard to keep in sync with the various editor environments people in your project might be using, Calva Jack-In is about 3.

    Ideally, you will be able to rid your project files completely of editor dependencies when people working on the project can rely on the Jack-In features of their Clojure editor.

    ","boost":6},{"location":"jack-in-guide/#a-controlled-shell-command","title":"A Controlled Shell Command","text":"

    At its core Calva Jack-In is just a glorified, REPL-starting, command-line. No, it is more than that, but anyway. The command line can look like so for a Leiningen project using legacy Figwheel for its ClojureScript assistance:

    lein update-in :dependencies conj '[nrepl\"0.6.0\"]' -- update-in :dependencies conj '[cider/piggieback\"0.4.1\"]' -- update-in :dependencies conj '[figwheel-sidecar\"0.5.18\"]' -- update-in :plugins conj '[cider/cider-nrepl\"0.22.4\"]' -- update-in '[:repl-options :nrepl-middleware]' conj '[\"cider.nrepl/cider-middleware\"]' -- update-in '[:repl-options :nrepl-middleware]' conj '[\"cider.piggieback/wrap-cljs-repl\"]' -- with-profile +dev repl :headless\n

    Even if a bit long, it might look simple enough. But actually it has taken quite some effort to make Calva craft it. Shell quoting can be really tricky. Look at how '[nrepl\"0.6.0\"]' doesn't have a space between nrepl and the version. That was the only way I could find that was cross platform enough to make all supported shells parse the command line. (The trick relies on that the string is read by the super reliable Clojure Reader, which does not need that space to tokenize it.)

    It is awesome that Clojure is used on so many platforms, but for a tool smith this also means more work. (I think Windows and its shell hell ate up about 95% of the many hours spent on getting the quoting good enough.)

    The command-line crafted is then used to start a shell command that Calva controls, but we are getting ahead of ourselves...

    ","boost":6},{"location":"jack-in-guide/#project-types-builds-aliases-profiles-etcetera","title":"Project Types, Builds, Aliases, Profiles, etcetera","text":"

    In order to cook the right command for your project, Calva looks for project files, reads them, and figures out what possible project types and ClojureScript tools could be involved. Then Calva presents you with a menu with the options it has found. You need to know enough about your project to answer this question. It looks like this in a shadow-cljs project that uses a deps.edn file for setting up its classpath.

    (I know enough about this particular project to know that I should choose the shadow-cljs project type.)

    But Calva isn't ready to cook the command-line just yet. Depending on the project type, and contents of your project files, more info is needed. E.g. in the case of shadow-cljs projects, Calva needs to know what builds to start.

    Here you can select any combination of builds defined in the project, and Calva will cook a command line that starts them.

    You might get more prompts from Calva before it issues the command, but for this example project, Calva goes ahead, cooks the command line, and issues it. On my Mac, it looks like so:

    npx shadow-cljs -d cider/piggieback:0.4.1 -d cider/cider-nrepl:0.22.4 watch :app\n

    (Much shorter than the one with lein-figwheel, right? It is because shadow-cljs is aware of CIDER dependencies, so it doesn't need as many dependencies specified as some other project types do.)

    ","boost":6},{"location":"jack-in-guide/#connecting","title":"Connecting","text":"

    When the command is issued Calva needs to wait until the REPL Server is started, before connecting to it and possibly continuing with starting a ClojureScript REPL and connecting to that as well. It also needs to know which port to connect to.

    Because reasons, Calva can't yet read the stdout of the shell command it has issued, so to know when the REPL server is started, and on which port, Calva monitors the filesystem for the .nrepl-port file. (This file is not always named like that. shadow-cljs, for instance, creates the file .shadow-cljs/nrepl.port.)

    When the port file is created, Calva picks up the port number from it and connects to the nREPL server. At this point you have a Clojure REPL backing your Calva session, providing all sorts of nice IDE help for you.

    ","boost":6},{"location":"jack-in-guide/#starting-your-clojure-app","title":"Starting Your Clojure App","text":"

    Once you have the Clojure REPL connected you can start your Clojure app/server. See Custom Connect Sequences for how to let Calva do this for you automatically. See the same article for ways to automate more of the Jack-In process. It can be brought down to a single Jack-In command/action, even for a full stack Clojure and ClojureScript application.

    ","boost":6},{"location":"jack-in-guide/#clojurescript","title":"ClojureScript","text":"

    For ClojureScript, things are not done yet, though, far from it. It turns out that cooking the command line was the easy part.

    In order for Calva to provide REPL power for ClojureScript projects, several things need to happen:

    1. A Clojure nREPL connection needs to be established. We've covered that above. Calva makes an nREPL session clone to use for the ClojureScript REPL and then:
    2. Your ClojureScript app needs to be compiled.
    3. Your ClojureScript app needs to be started.
    4. The Clojure nREPL session needs to be promoted to a ClojureScript nREPL session. (This is what piggieback helps with.)
    ","boost":6},{"location":"jack-in-guide/#compiling-the-app-and-watchers","title":"Compiling the App and Watchers","text":"

    Depending on ClojureScript project type, Calva uses different methods to start the compilation and the watcher:

    This results in a bit of difference in the user interaction. Mainly that for shadow-cljs, the user needs to check the Jack-In Terminal tab to follow what's going on.

    ","boost":6},{"location":"jack-in-guide/#starting-the-app","title":"Starting the App","text":"

    Number 3 above, the app needs to be started, might seem obvious, but it actually trips many people up. Because of this, Calva goes to quite some lengths to provide assistance. Many projects are configured not to spawn a browser session automatically, requesting the app once it has been compiled, so we can't rely on that.

    What Calva does instead is to monitor the output of the commands it uses for starting the compilation, looking for information that the app is ready to be requested/started. It then tells the user this, providing a URL, in case it is a browser app. (There are also settings that tell Calva to open the URL automatically for you, regardless what the project settings are.)

    ","boost":6},{"location":"jack-in-guide/#connecting_1","title":"Connecting","text":"

    Meanwhile, Calva is monitoring the output and when it sees that the app is started, it continues to hook up the REPL connection to the editor.

    This whole connection sequence is quite configurable, using Custom Connect Sequences. In fact, Calva's built in ClojureScript sequences (Figwheel Main, lein-figwheel, shadow-cljs, and ClojureScript built-ins for both Browser and Node) are all built using those same settings mechanisms.

    ","boost":6},{"location":"jack-in-guide/#shadow-cljs-is-less-managed-by-calva","title":"shadow-cljs is Less Managed by Calva","text":"

    NB: The managed way in which Calva creates and connects the ClojureScript REPL breaks apart a bit for shadow-cljs, which works a bit differently and also outputs most of the information Calva is looking for on the stdout of the REPL start command (where Calva can't see it, remember?). We'll figure out a better way to support shadow-cljs, but for now, the user needs to do more of this figuring out than is needed with Figwheel projects.

    ","boost":6},{"location":"jack-in-guide/#hack-away","title":"Hack Away","text":"

    So, there are things going on when you start Jack-In, and even more things for ClojureScript projects, but Calva tries to keep it together, so as a user it is a matter of paying attention and responding to a few prompts/menus with pre-populated options (prompts which can be configured away, even).

    ","boost":6},{"location":"jack-in-guide/#switch-clojurescript-builds","title":"Switch ClojureScript Builds","text":"

    Once the REPL is connected you might want to change which ClojureScript build you have Calva connected to. For this Calva has the Select CLJS Build Connection command. Please note that you can only switch between builds that you have started.

    ","boost":6},{"location":"jack-in-guide/#play-with-starting-the-cljs-repl-yourself","title":"Play With Starting the cljs-repl Yourself","text":"

    To get a good grip on what is going on when creating and connecting the ClojureScript REPL, I can recommend making a custom connect sequence which leaves the REPL unpromoted (e.g. give it nil as connectCode), and then evaluate the cljs-repl start commands yourself. So for instance, promoting it to a ClojureScript Node.js REPL looks something like so:

    user=> (require 'cljs.repl.node)\nuser=> (cider.piggieback/cljs-repl (cljs.repl.node/repl-env))\nClojureScript 1.10.844\nTo quit, type: :cljs/quit\nnil\ncljs.user=> |\n

    It is the piggieback middleware there telling you that you can unpromote the REPL by \u201devaluating\u201d :cljs/quit.

    ","boost":6},{"location":"jack-in-guide/#about-full-stack-applications","title":"About Full Stack Applications","text":"

    Because Calva uses the Clojure REPL connection to spawn the ClojureScript REPL, and because Calva only handles one Clojure REPL per VS Code window, some projects need special handling by the user.

    If your full stack project is using shadow-cljs for the frontend, like this Fulcro template project does, maybe you first try to Jack-In to your backend Clojure REPL, and then to your shadow-cljs frontend. This works if you do it in separate VS Code windows, but if you do it in the same window, the second Jack-In will kill the backend session! See also connect shadow-cljs in fullstack projects.

    See Workspace Layouts for tips about how to open the same project folder in two separate VS Code windows.

    Please also consider to play around with starting the REPL and ClojureScript wiring entirely from the terminal, see this example project for some instructions on that. You can also use that project together with the nil for connectCode sequence mentioned above.

    ","boost":6},{"location":"jack-in-guide/#please-grab-your-calva-jack-in-certificate","title":"Please Grab your Calva Jack-In Certificate","text":"

    There, you now know all there is to know about Calva Jack-In.

    Just kidding, there are a few more details to it, some of which might find their way into this article at a later time.

    To really get to know it all, you will need to spend some time with the Calva Jack-In code. Head over to the Calva Development Wiki to learn how to hack on Calva.

    ","boost":6},{"location":"joyride/","title":"Using Calva With Joyride","text":"

    Joyride is a VS Code extension for user space scripting of VS Code itself. You find the extension here. The scripting language for Joyride is the best you language imaginable: Clojure. And, as is proper for a Clojure implementation, it has a REPL, even an nREPL server.

    This means you can connect Calva to Joyride and interactively develop your VS Code scripts.

    This video shows Joyride in action, using Calva as the nREPL client.

    "},{"location":"joyride/#how-to-connect","title":"How to connect","text":"

    Once you have the Joyride extension installed you can start its REPL and connect Calva to it (a.k.a Jack-in).

    Start the Joyride REPL and Connect

    This 1 minute video shows the following steps:

    1. Installing the Joyride Extension
    2. Isssuing the command Calva: Start a REPL in your Project and (a.k.a Jack-in)
    3. Selecting joyride project type
    4. Isssuing the command Calva: Load/Evaluate Current File and its Requires/Dependencies
    5. Evaluating some non-vscode code
    6. Evaluating code exercising something from the VS Code API

    (Right-click the video and choose Full Screeen if it is too tiny embedded.)

    "},{"location":"joyride/#how-to-get-started-with-joyride","title":"How to Get Started with Joyride","text":"

    The Joyride README has some Quick Start pointers for you. Please feel invited to the #joyride channel on the Clojurians Slack and chat with us and other Joyride users.

    Come on, Join the Joyride! \u2764\ufe0f

    "},{"location":"krell/","title":"Using Calva With Krell","text":"

    Krell is \u00e0 la carte ClojureScript tooling for React Native.

    Even if Calva does not yet have built-in support, all is not lost. You can add support yourself by way of a Custom REPL Connect Sequence. Here's how;

    "},{"location":"krell/#starting-the-krell-clojurescript-repl","title":"Starting the Krell ClojureScript REPL","text":"

    Add this REPL Connect Sequence to your workspace settings.json:

        \"calva.replConnectSequences\": [\n        {\n            \"name\": \"deps.edn + Krell\",\n            \"projectType\": \"deps.edn\",\n            \"cljsType\": {\n                \"connectCode\": \"(require '[clojure.edn :as edn] \\n    '[clojure.java.io :as io]\\n    '[cider.piggieback] \\n    '[krell.api :as krell]\\n    '[krell.repl])\\n\\n(def config (edn/read-string (slurp (io/file \\\"build.edn\\\"))))\\n(apply cider.piggieback/cljs-repl (krell.repl/repl-env) (mapcat identity config))\",\n                \"dependsOn\": \"User provided\"\n            }\n        }\n    ]\n

    Then issue the command Start a Project REPL and Connect (aka Jack-In). It start the project and connect to the Krell REPL once the app is running on a device (wether real or virtual/emulated).

    "},{"location":"krell/#additional-vs-code-tips","title":"Additional VS Code Tips","text":"

    For a smooth workflow you can also:

    Together with the connect sequence this will make for a start of a Krell session like this:

    1. Open the project root in VS Code
    2. Issue the Jack-in command
    3. Issue the React Native; Run Android on Emulator (or Run iOS on Simulator) command. (Disable Fast Refresh from the *React Native dev menu, if it is enabled.)
    4. Issue the React Native: Run Element Inspector command (You might need to install the React Native inspector globally): ```sh yarn global add react-devtools ````
    5. Launch Debugger (F5)
    6. Hack away, with hot reload and interactive REPL

    Once the debugger (a Chrome session) is running, you probably will want to enable Custom Formatters in order for clojure structures to be logged conveniently.

    "},{"location":"linting/","title":"Linting","text":"

    Calva does no linting, yet with Calva you get excellent linting. That is because Calva uses clojure-lsp, which provides linting powered by clj-kondo.

    clj-kondo comes with great default rules, and the configuration can be customized. One of your options for the configuration file is to placed a config.edn file in .clj-kondo/ at the root of your project. This folder may or may not already exist. It is safe to create it manually if it doesn't.

    The configuration will be merged with the default set of rules, you can only specify the rules you want to override. The full list of available options can be found on clj-kondo's github

    clojure-lsp is customizable, see Clojure LSP Settings for your options. It is safe to manually create the .lsp folder if it doesn't exist.

    You might want to read about how to configure clj-kondo. These two sections might be of extra interest:

    If you see a linting squiggle under the first character of the file with an error you don't quite understand, it is probably something wrong with your clj-kondo configuration.

    Files are linted as they're being edited. If you want to lint the whole project, use the clj-kondo cli command. See https://github.com/borkdude/clj-kondo for more info on that. Windows users might like to know that they too can get a clj-kondo cli command now, via npm install -g clj-kondo. It'll be a bit slower to start than the native build, but for sure it's better than not having a clj-kondo command! See https://github.com/borkdude/clj-kondo/blob/master/doc/install.md#npm-linux-macos-windows for more on this.

    "},{"location":"linting/#resolve-macro-as","title":"Resolve Macro As","text":"

    When your cursor is on a macro form in the editor, you may notice a code action (click the light bulb that appears) called Resolve Macro As. Running this code action will ask you what macro you'd like to resolve the current macro as, and then what clj-kondo config file you want the macro to be saved to. This code action is also available as a command.

    "},{"location":"live-share/","title":"Using Calva with Live Share","text":"

    Live Share is a Microsoft provided VS Code extension. It allows you to share the workspace that you have open in your computer with somebody else. Everybody is then working on the same source code files, namely those on your computer. You can edit files at the same time, everyone has their own caret. You can follow each other (i.e. when someone switches to a different file, you will as well). This is great for remote pair programming, for example.

    An extra nice thing is that each participant is using their own VSCode configuration, including fonts, colors, keyboard shortcuts, etc.

    Disable Calva Spritz to get rid of Notebooks interference

    The headline below Calva Supports Live Share is true. However, due to a bug in LiveShare, guest participants always get their Clojure files opened in the Calva Clojure Notebooks editor. To workaround this issue Calva uses a \u201dside-car\u201d extension named Calva Spritz for the Notebooks associations of Clojure files. You can disable that extension when participating in LiveShare sessions.

    "},{"location":"live-share/#calva-supports-live-share","title":"Calva Supports Live Share","text":"

    When using Calva, you can use Live Share as well. Editing works exactly the same as for any other programming language. What makes Calva a bit special, is the REPL. When using Live Share, Calva allows the host to share the REPL with guests as well. If you use any of the supported configuration, this will be pretty much automatic.

    You need to enable the LiveShare support

    Due to an issue in the LiveShare API, for some users, this feature stops Calva from connecting the REPL. Therefore the support is disabled by default. The setting is calva.useLiveShare.

    This is what a typical scenario looks like:

    1. The host jacks-in.
    2. The host shares its workspace using Live Share. Calva will detect that the workspace is being shared, so it will offer to share the REPL port that was opened when jacking in. The host clicks \"Allow\" to start sharing the port. (Note: steps 1 and two can also be done in the reverse order.)
    3. The host sends the Live Share URL to the guest(s).
    4. The guest joins the Live Share session using the URL it received.
    5. The guest connects to the host's REPL using the command \"Connect to a running REPL server in the project\". If needed, the guest chooses the same build configuration as the host.

    Voila! Both the guest and the host can now use the REPL that is running on the host. Things like documentation lookup now also work on the guest's machine.

    "},{"location":"live-share/#control-visibility-of-calva-folder","title":"Control Visibility of .calva Folder","text":"

    Calva depends on the output.calva-repl file to be available. If you have the .calva folder listed in your .gitignore, this also causes the folder to be hidden from guests in Live Share by default. In order to make the folder visible, you can put a file called .vsls.json in your project. In its simplest form, the contents can be this:

    {\n  \"$schema\": \"http://json.schemastore.org/vsls\",\n  \"hideFiles\": [\n    \"!.calva\"\n  ]\n}\n

    Now the .calva folder is shared as well. But also any other file and folder that you may have in your .gitignore. If you want to have more fine-grained control, please refer to the section Controlling file access and visibility of the Live Share documentation.

    "},{"location":"live-share/#some-things-to-keep-in-mind","title":"Some Things To Keep In Mind","text":""},{"location":"live-share/#calva-spritz","title":"Calva Spritz","text":"

    Together with Calva there is an extension called Calva Spritz installed. All it does is to provide the association of Clojure file types to Clojure Notebooks. We do it this way because of the LiveShare issues mentioned above. So that you can disable the Notebook association when participating as a guest in LiveShare sessions. The issue is tracked here:

    Calva Spritz can be disabled and enabled at will, and it will take immediate effect, without any reload of VS Code needed.

    "},{"location":"luminus/","title":"How to Use Calva with Luminus","text":"

    Luminus is a powerful and versatile Leiningen template for creating web development projects. It comes with built in configuration which makes it easy to use Calva as your Clojure(Script) editor.

    "},{"location":"luminus/#server-shadow-cljs","title":"Server + shadow-cljs","text":"

    Basically this is the same wokflow as with Server only. Behind the scenes there is more happening, though. Such as the ClojureScript app being built and the CLJS REPL connected once the web app is running.

    1. If you haven't created the project yet, create a new shadow-cljs Luminus project. E.g.: 
      $ lein new luminus my-luminus-shadow +reagent +re-frame +shadow-cljs\n
    2. Install npm dependencies 
      $ npm i\n
      (Or yarn if you prefer.)
    3. This creates the folder my-luminus-shadow. Open it in VS Code: 
      $ code my-luminus-shadow\n
    4. Use the Calva command Start a Project REPL and Connect (aka Jack-in): ctrl+alt+c ctrl+alt+j
    5. Select to start my-luminus-shadow Server + Client, and wait for the Terminal Calva Jack-in output to say [:app] Build completed.
    6. Open 127.0.0.1:3000 in your web browser and start hacking.

    Note

    Currently Calva has troubles following the app-start with shadow-cljs, so Calva will report Jack-in done. in the output window before shadow-cljs is actually done building the app. If you open the app page at that stage, you will see a message to \u201cPlease run lein shadow watch app\u201d. Rest assured that this is already underway. Follow the Jack-in process in the Terminal tab in VS Code for the message that the app is built, then reload the app page in the web browser.

    "},{"location":"luminus/#server-only","title":"Server Only","text":"

    The workflow here is really just: Jack-in and start hacking. However, the first time it will involve these steps:

    1. If you haven't created the project yet, create a new server only Luminus project. For a all-defaults setup it is like so: 
      $ lein new luminus my-luminus-server\n
    2. This creates the folder my-luminus-server. Open it in VS Code: 
      $ code my-luminus-server\n
    3. Use the Calva command Start a Project REPL and Connect (aka Jack-in): ctrl+alt+c ctrl+alt+j
      • Select to start my-luminus-shadow Server and wait until you see Jack-in done. in the output window.
    4. Open 127.0.0.1:3000 in your web browser and start hacking.
    "},{"location":"luminus/#server-figwheel","title":"Server + Figwheel","text":"

    This is Legacy Figwheel (lein-figwheel), so the recommendation is to use the shadow-cljs setup instead. As with the server only, the workflow here is really just: Jack-in and start hacking. The first time it involves these steps:

    1. If you haven't created the project yet, create a new server only Luminus project. E.g.: 
      $ lein new luminus my-fw +reagent\n
    2. This creates the folder my-fw. Open it in VS Code: 
      $ code my-fw\n
    3. Use the Calva command Start a Project REPL and Connect (aka Jack-in): ctrl+alt+c ctrl+alt+j, select Server + Client - my-fw in the Project type picker menu, and wait for the web app to pop open in your web browser.
    4. Start hacking.

    If you prefer to open the web app yourself, open .vscode/settings.json and change \"shouldOpenUrl\" to false in the pre-configured Calva connect sequence. Calva will then print the URL 127.0.0.1:3000 in the output, so that you can click it open.

    "},{"location":"luminus/#etcetera","title":"Etcetera","text":"

    You will have three Calva Custom Command Snippets configured. Invoke them by issuing the Run Custom REPL Command, ctrl+alt+c . (that's a dot). These commands control the Luminus server:

    1. Start <project> Server
    2. Stop <project> Server
    3. Restart <project> Server

    When used, Calva will open its REPL window and execute the command, if it is not already opened. You can close this window if you prefer to use the REPL directly from the Clojure files.

    Calva also opens the REPL window, and starts the Luminus server, as part of the Jack-in process.

    "},{"location":"merch/","title":"Calva Merch","text":"

    In this video, there is a question about where you can buy the Calva T-shirt:

    You couldn't, then. But now you can! On Amazon.

    Zero profit

    To keep the admin of this shop to a minimum the merch is sold at production prize (or as close to production prize as the respective store allows). There is no royalty going to anyone in the Calva team when you buy one of these t-shirts. You will represent, which is certainly a way to support the project. You are of course encouraged to support us via sponsoring as well:

    Calva Merch is available on Zazzle and on Amazon

    ","boost":10},{"location":"merch/#zazzle","title":"Zazzle","text":"","boost":10},{"location":"merch/#calva-symbol-sticker","title":"Calva Symbol Sticker","text":"Calva Symbol Sticker by BetterThanTomorrow","boost":10},{"location":"merch/#joyride-symbol-sticker","title":"Joyride Symbol Sticker","text":"Joyride Symbol Sticker by BetterThanTomorrow","boost":10},{"location":"merch/#amazon-merch","title":"Amazon Merch","text":"","boost":10},{"location":"merch/#the-designs","title":"The designs","text":"

    There are four design, all featuring the Calva symbol (the Calva glass), which are all available for a Standard T-shirt, in men's, women's and kid's cut, and in some different colors. In the .com store there are also Premium T-shirts**.

    ","boost":10},{"location":"merch/#symbol-logo","title":"Symbol + Logo","text":"

    Available at:

    ","boost":10},{"location":"merch/#symbol-logo-we-do-it-with-rich-comments","title":"Symbol + Logo + We do it with Rich Comments","text":"

    The Calva symbol and Logo front, Rich Comments back.

    Available at:

    ","boost":10},{"location":"merch/#symbol-only","title":"Symbol Only","text":"

    Available at:

    ","boost":10},{"location":"merch/#symbol-we-do-it-with-rich-comments","title":"Symbol + We do it with Rich Comments","text":"

    The Calva symbol front, Rich Comments Back.

    Available at:

    Note

    What's available on this or that Amazon site will vary a bit and it is a bit slow to add a particular design to a particular market. Eventually I hope to have both designs up on these markets: .com, .co.uk, .de, .fr, .it, .es, and .co.jp

    ","boost":10},{"location":"namespace-form-auto-creation/","title":"Namespace Form Auto-creation","text":"

    When you create a new clojure file, a file with .clj, .cljc or .cljs extension, an appropriate namespace form will be added to the file. This feature is provided by clojure-lsp.

    "},{"location":"nbb/","title":"Using Calva with nbb","text":"

    Since nbb can be started such that it is an nREPL server, Calva can connect to it and a lot of the features will work.

    Calva can also start nbb and connect its REPL for you, using the Jack-in command. This will start an nbb nREPL server on a random port and connect Calva to it. Check out this video where they use Calva and nbb to create a CLI tool as an executable npm module:

    In that video they ask for a JavaScript to ClojureScript converter. And there is one: https://mauricioszabo.gitlab.io/js2cljs/

    Though if you are using Calva, this converter is easier to use directly via the command Calva: Convert JavaScript to ClojureScript:

    Errors jacking in to nbb on Windows?

    On some machines it seems necessary to first run npx nbb from the CMD prompt to make jack-in work. Or try first install it npm i -g nbb. (You probabl want nbb installed globally anyway.)

    Don't expect complete support

    nbb's nREPL server is completely new and and WIP. It will be a bit limited compared to a full cider-nrepl enhanced \"regular\" Clojure nREPL server. Things like function signatures, and more do not work.

    It's a bit hacky

    The nbb nREPL server is the first ClojureScript nREPL server around and throws Calva's assumption that an nREPL server is always started in a Clojure process out the window. The nbb Jack-in/connect option \u201dpretends\u201d it is connecting to a Clojure nREPL and then the code fro promoting the nREPL session to a ClojureScript one is just dummy code.

    This means that if you open a Clojure (.clj) file while connected to an nbb nREPL server, it will still be a ClojureScript session serving even though Calva will indicate that it is a Clojure one. Bare with us until we can fix this properly in Calva.

    ","boost":4},{"location":"notebooks/","title":"Clojure Notebooks","text":"

    WIP: Notebook support is very basic and experimental

    Please help test the feature. We're looking forward to your feedback!

    You can open any Clojure file as a notebook by right clicking the file -> Open with... -> Clojure Notebook.

    Running cells sends them to the REPL and pretty prints the results. If the return is a string that starts with <html it will be displayed in an html webview.

    Forms inside (comment) blocks get shown as their own cells. When adding code blocks in between those cells they get saved with the same indentation as the first form.

    ","boost":1},{"location":"notebooks/#calva-spritz","title":"Calva Spritz","text":"

    Together with Calva there is an extension called Calva Spritz installed. It only provides the association of Clojure file types to Clojure Notebooks. This is due to the LiveShare issues mentioned above. So that you can disable the Notebook association when participating as a guest in LiveShare sessions. The issue is tracked here:

    ","boost":1},{"location":"nrepl_and_cider-nrepl/","title":"nREPL and cider-nrepl","text":"

    nREPL and cider-nrepl middleware enable Calva to support full Interactive Programming.

    ","boost":2},{"location":"nrepl_and_cider-nrepl/#about-nrepl","title":"About nREPL","text":"

    The REPL is a Clojurists quintessential tool, it\u2019s what we use to do Interactive Development, the hallmark of the LISP style of development.

    In Interactive Development (more commonly but somewhat imprecisely referred to as REPL-driven development), the programmer\u2019s editor has a direct connection with the running application process. This allows evaluating pieces of code in the context of a running program, directly from where the code is written (and so not in some separate \u201cREPL place\u201d), inspecting and manipulating the innards of the process. This is helped along by the dynamic nature of Clojure in which any var can be redefined at any point, allowing for quick incremental and iterative experimentation and development.

    This is why it\u2019s essential to the Clojure development experience to have proper editor support, a plugin which bridges the gap between where the code is written and where the code is run. So we have CIDER for Emacs, Calva for VS Code, Cursive for IntelliJ, Conjure or Iced for Vim, and so forth. Often these will also leverage the same (or a parallel) connection into the process for other editor affordances, like navigation and completion.

    But for these editor plugins to connect to the Clojure process something needs to be listening on the other side, accepting connections, allowing the initiation of a program-to-program dialogue. The most common way to achieve this is by leveraging the nREPL protocol, an asynchronous message-based network protocol for driving interactive development. The application process is started with an embedded nREPL server, so that the editor can connect as an nREPL client.

    From: Lambda Island

    ","boost":2},{"location":"nrepl_and_cider-nrepl/#about-the-nrepl-server-and-middleware","title":"About the nREPL Server and Middleware","text":"

    nREPL is an extensible protocol, the reference server implementation understands certain core operation types like \"eval\". More operations can be supported, or existing operations can be modified or augmented, through nREPL middleware. For example: the Piggieback middleware can intercept \"eval\" messages, and forward them to a ClojureScript environment, rather than evaluating them in the Clojure process itself.

    Which middleware to use will mostly depend on the editor you are using. You\u2019ll typically find that the Clojure-specific functionality for a given editor is partly implemented as a typical editor extension, for instance CIDER written in Emacs LISP, or Calva written in Typescript, and partly as nREPL middleware, providing the functionality the editor extension relies on. For instance, both CIDER and Calva rely on functionality provided by cider-nrepl.

    Also from: Lambda Island

    ","boost":2},{"location":"nrepl_and_cider-nrepl/#viewing-the-communication-between-calva-and-nrepl","title":"Viewing the Communication Between Calva and nREPL","text":"

    You can view the messages sent between Calva and nREPL by running the command Toggle nREPL Logging Enabled. Enabling nREPL message logging triggers the creation of a VS Code output channel called nREPL Messages where the messages will be logged. Messages sent to nREPL from Calva will have -> sent above them, and messages sent from nREPL to Calva will have <- received above them. Disabling nREPL message logging causes the nREPL Messages channel to be removed and messages will no longer be logged.

    Each message is logged as JSON. If you find a need for the messages to be logged as EDN (for example, to transform and analyze them with Clojure) please open a GitHub issue for this change. A PR would be welcome too!

    The example below shows two messages logged when the cursor hovers over println in a Clojure file while a REPL is connected.

    -> sent\n{\n  op: 'info',\n  ns: 'test-lein.core',\n  symbol: 'println',\n  id: '7',\n  session: '1a080b66-b1b6-4b8c-8206-c4af2cc02747'\n}\n\n<- received\n{\n  added: '1.0',\n  'arglists-str': '[& more]',\n  column: 1,\n  doc: 'Same as print followed by (newline)',\n  file: 'jar:file:/Users/brandon/.m2/repository/org/clojure/clojure/1.10.1/clojure-1.10.1.jar!/clojure/core.clj',\n  id: '7',\n  line: 3733,\n  name: 'println',\n  ns: 'clojure.core',\n  resource: 'clojure/core.clj',\n  'see-also': [\n    'clojure.core/prn',\n    'clojure.core/print',\n    'clojure.core/println-str',\n    'clojure.pprint/pprint'\n  ],\n  session: '1a080b66-b1b6-4b8c-8206-c4af2cc02747',\n  static: 'true',\n  status: [ 'done' ]\n}\n
    ","boost":2},{"location":"output/","title":"Output Destinations","text":"

    Calva categorizes output into three types:

    With the setting calva.outputDestinations, you can configure where each category of output should go to:

    The reason there are several options for this is partly legacy and partly because VS Code restricts the placement of different views in different ways. We hope you will find a combination of output destinations that suits you.

    "},{"location":"output/#commands-for-showing-output-destinations","title":"Commands for showing output destinations","text":"

    These are the commands and their default keyboard shortcuts for revealing output destinations

    "},{"location":"output/#about-stdout-in-the-repl-window","title":"About stdout in the REPL Window","text":"

    Since Calva v2.0.423 the REPL Window prints stdout prepended with ; to make it into line comments. This is because stdout output easily breaks the Clojure structure of the REPL Window, making it misbehave in various ways. We made this change because as maintainers of Calva we have seen all too often how this hits users, and it is also taking too much of our Calva time to try mitigate the problem, which is fundamentally not fixable.

    There are now other output destinations that do not have this limitation.

    All that said. If you want to keep using the REPL Window for stdout output, and need the old behavior, you can enable the setting: calva.legacyPrintBareReplWindowOutput. Please note that at some point after we have created a dedicated Output Window, the REPL Window will be retired as a destination for output.

    "},{"location":"output/#repl-process-output-stdout-and-stderr","title":"REPL process output (stdout and stderr)","text":"

    When Calva is connected to the REPL, the Output window will by default print not only results of evaluations, but also:

    1. Things printed to stdout and stderr in the main thread of the evaluations
    2. Things printed to stdout and stderr from child threads of the evaluations
    3. Anything printed to stdout and stderr by the REPL process

    You can control the default via the calva.redirectServerOutputToRepl setting. It defaults to true. Setting it to false before connecting the REPL will result in that 2. and 3. will not get printed in the Output window. It will then instead be printed wherever the REPL process is printing its messages, usually the terminal from where it was started (the Jack-in terminal if Calva started the REPL).

    "},{"location":"paredit/","title":"Paredit \u2013 a Visual Guide","text":"

    Structural editing and navigation for Clojure.

    ","boost":7},{"location":"paredit/#what-is-paredit","title":"What is Paredit?","text":"

    Calva Paredit helps you navigate, select and edit Clojure code in a structural way. LISP isn't line or character oriented, it is based around S-expressions, a.k.a forms. We strongly recommend that you take advantage of the structural nature of Clojure, and have therefore put a lot of work into making Calva Paredit extra awesome.

    If you are new to Paredit, consider starting with learning the Slurp Forward (pull in the next form into this form) and Barf Forward (push the last form out of this form). It will take you quite far.

    ","boost":7},{"location":"paredit/#strict-mode","title":"Strict Mode","text":"

    To protect the integrity of your code, Strict mode is enabled by default.

    Strict mode keybinding Action Description backspace Delete Backward Deletes one character backwards, unless it will unbalance a form. Otherwise moves past the character instead of deleting it. If the list is empty, it will remove both open and close brackets. delete Delete Forward Deletes one character forwards, unless it will unbalance a form. Otherwise moves past the character instead of deleting it. If the list is empty, it is removed. alt+backspace Force Delete Backward Deletes one character backwards, even if it will unbalance a form. alt+delete Force Delete Forward Deletes one character forwards, even if it will unbalance a form.

    Disable at your own peril. Strict mode can be toggled on/off using the Toggle Paredit Mode command, and there is a status bar indicator telling you:

    Indicator Paredit Mode [\u03bb] Strict (\u03bb) Cave Man (strict mode off) \u03bb No default key bindings

    Toggle between Strict and Cave Man using: ctrl+alt+p ctrl+alt+m

    ","boost":7},{"location":"paredit/#a-keybinding-for-protecting-the-structure-from-semi-colon","title":"A keybinding for protecting the structure from semi-colon","text":"

    Semi-colons (;) in Clojure are non-structural because they comment out the rest of the line regardless of brackets. In a way they can delete brackets. There is a somewhat secret command in Paredit that can be used to insert ; in a safe way:

    paredit.insertSemiColon

    Bind it to the ; key with a when clause that activates it together with the other Strict mode commands:

    {\n    \"command\": \"paredit.insertSemiColon\",\n    \"key\": \";\",\n    \"when\": \"calva:keybindingsEnabled && editorLangId == clojure && editorTextFocus && paredit:keyMap == strict && !editorReadOnly && !editorHasMultipleSelections && !calva:cursorInComment\"\n },\n
    ","boost":7},{"location":"paredit/#commands","title":"Commands","text":"

    The Paredit commands are sorted into Navigation, Selection, and Edit. As mentioned, Slurp and Barf are power commands, which go into the editing category. Learning to navigate structurally, using shortcuts, also saves time and adds precision to your editing. It has the double effect that you at the same time learn how to select structurally, because that is the same, just adding the shift key.

    To make the command descriptions a bit clearer, each entry is animated. When you try to figure out what is going on in the GIFs, focus on where the cursor is at the start of the animation loop.

    ","boost":7},{"location":"paredit/#strings-are-not-lists-but-anyway","title":"Strings are not Lists, but Anyway...","text":"

    In Calva Paredit, strings are treated in much the same way as lists are. Here's an example showing Slurp and Barf, Forward/Backward List, and Expand Selection.

    ","boost":7},{"location":"paredit/#navigating","title":"Navigating","text":"

    (Modify these with shift to select rather than move, see below.)

    Default keybinding Action Description ctrl+right (win/linux)alt+right (mac) Forward Sexp Moves the cursor forward, to the end of the current form. If at the end, moves to the end of the next form. Will not move out of lists. ctrl+left (win/linux)alt+left (mac) Backward Sexp Moves the cursor backward, to the start of the current form. If at the start, moves to the start of the previous form. Will not move out of lists. ctrl+down Forward Down Sexp Moves the cursor into the following list. ctrl+alt+up Backward Down Sexp Moves the cursor into the preceding list. ctrl+alt+down Forward Up Sexp Moves the cursor forwards, out of the current list. ctrl+up Backward Up Sexp Moves the cursor backwards, out of the current list. Unbound Forward Sexp Or Up Moves the cursor forward, to the end of the current form. If at the end, moves to the end of the next form. Moves out of the lists if at the end of it. Unbound Backward Sexp Or Up Moves the cursor backward, to the start of the current form. If at the start, moves to the start of the previous form. Moves out of the list if at the start of it. ctrl+end Forward to List End/Close Moves the cursor forwards, staying within the current list. ctrl+home Backward to List Start/Open Moves the cursor backwards, staying within the current list.","boost":7},{"location":"paredit/#selecting","title":"Selecting","text":"

    Most of these commands are selecting \u201dversions\u201d of the navigation commands above. Repeated use will grow the current selection step by step.

    Default keybinding Action Description shift+alt+right (win/linux)ctrl+w (mac) Expand Selection Starts from the cursor and selects the current form. Then will keep expanding to enclosing forms. shift+alt+left (win/linux)ctrl+shift+w (mac) Shrink Selection Contracts back from an expanded selection performed by any Paredit selection command. (In the animation the selection is first grown using a combination of Expand Selection and some lateral selection commands, then shrunk all the way back down to no selection.) ctrl+alt+w space Select Top Level Form Top level in a structural sense. Typically where your(def ...)/(defn ...) type forms. Please note that(comment ...) forms create a new top level. shift+ctrl+right (win/linux)shift+alt+right (mac) Select Forward Sexp ctrl+shift+k Select Right Select forward to the end of the current form or the first newline. See Kill right below. (The animation also shows Shrink Selection). shift+ctrl+left (win/linux)shift+alt+left(mac) Select Backward Sexp ctrl+shift+down Select Forward Down Sexp (You probably do not need to select like this, but you can!) ctrl+shift+alt+up Select Backward Down Sexp (You probably do not need to select like this, but you can!) ctrl+shift+alt+down Select Forward Up Sexp (You probably do not need to select like this, but you can!) ctrl+shift+up Select Backward Up Sexp (You probably do not need to select like this, but you can!) Unbound Select Forward Sexp Or Up (You probably do not need to select like this, but you can!) Unbound Select Backward Sexp Or Up (You probably do not need to select like this, but you can!) ctrl+shift+end Select Forward to List End/Close ctrl+shift+home Select Backward to List Start/Open","boost":7},{"location":"paredit/#editing","title":"Editing","text":"Default keybinding Action Description ctrl+alt+right (mac/win)ctrl+alt+. (linux) Slurp Forward Moves the closing bracket forward, away from the cursor, past the following form, if any. ctrl+alt+left (mac/win)ctrl+alt+, (linux) Barf Forward Moves the closing bracket backward, towards the cursor, past the preceding form. ctrl+alt+shift+left Slurp Backward Moves the opening bracket backward, away from the cursor, past the preceding form, if any. ctrl+alt+shift+right Barf Backward Moves the opening bracket forward, towards the cursor, past the following form. ctrl+alt+s Splice Sexp Remove enclosing brackets. ctrl+shift+s Split Sexp Splits a string, or a list, into two strings, or lists of the same type as the current. ctrl+shift+j Join Sexps/Forms Joins two strings, or two lists of the same type, into one form (string/list). ctrl+alt+p ctrl+alt+r Raise Sexp Replaces the enclosing list with the current form. ctrl+alt+t Transpose Sexps/Forms Swaps place of the two forms surrounding the cursor. alt+upalt+down Drag Sexp Backward/Forward Moves the current form to the behind/in front of the previous/next one. (See below about behavior in maps and binding boxes.) ctrl+alt+shift uctrl+alt+shift d Drag Sexp Backward UpDrag Sexp Forward Down Moves the current form up/out of the current list, backwards, and down/in to the following list, forwards, keeping the cursor within the sexpr being dragged. ctrl+alt+shift kctrl+alt+shift j Drag Sexp Forward UpDrag Sexp Backward Down Moves the current form up/out of the current list, forwards, and down/in to the preceding list, backwards, keeping the cursor within the sexpr being dragged. ctrl+shift+c Convolute \u00af\\_(\u30c4)_/\u00af ctrl+shift+delete Kill Sexp Forward Deletes the next form in the same enclosing form as the cursor. ctrl+k ctrl+k (win/linux)ctrl+k (mac) Kill Right Delete forward to the end of the current form or the first newline. ctrl+k ctrl+h (win/linux)cmd+backspace (mac) Kill Left Delete backward to the start of the current form or the start of the line. ctrl+alt+backspace Kill Sexp Backward Deletes the previous form in the same enclosing form as the cursor. ctrl+delete Kill List Forward Deletes everything from the cursor to the closing of the current enclosing form. ctrl+backspace Kill List Backward Deletes everything from the cursor to the opening of the current enclosing form. ctrl+alt+shift+delete Splice Killing Forward Delete forward to end of the list, then Splice. ctrl+alt+shift+backspace Splice Killing Backwards Delete backward to the start of the list, then Splice. ctrl+alt+shift+p Wrap Around () Wraps the current form, or selection, with parens. ctrl+alt+shift+s Wrap Around [] Wraps the current form, or selection, with square brackets. ctrl+alt+shift+c Wrap Around {} Wraps the current form, or selection, with curlies. ctrl+alt+shift+q Wrap Around \"\" Wraps the current form, or selection, with double quotes. Inside strings it will quote the quotes. ctrl+alt+rctrl+alt+p/s/c/q/h Rewrap Changes enclosing brackets of the current form to parens/square brackets/curlies/double quotes and set (#{})

    Copy to Clipboard when killing text

    You can have the kill commands always copy the deleted code to the clipboard by setting calva.paredit.killAlsoCutsToClipboard to true. If you want to do this more on-demand, you can kill text by using the selection commands and then Cut once you have the selection.

    clojure-lsp drag fwd/back overlap

    As an experimental feature, the two commands for dragging forms forward and backward have clojure-lsp alternatives. See the clojure-lsp page.

    ","boost":7},{"location":"paredit/#drag-bindings-forwardbackward","title":"Drag bindings forward/backward","text":"

    When dragging forms inside maps and binding boxes, such as with let, for, binding, etcetera, it often makes most sense to drag each binding as a pair. And this is what Calva will do. Like so:

    And like so (wait for it):

    ","boost":7},{"location":"paredit/#about-the-keyboard-shortcuts","title":"About the Keyboard Shortcuts","text":"

    Care has been put in to making the default keybindings somewhat logical, easy to use, and work with most keyboard layouts. Slurp and barf forward are extra accessible to go with the recommendation to learn using these two super handy editing commands.

    You can relax how Paredit's shortcuts replace VS Code built in shortcuts a bit by setting calva.paredit.hijackVSCodeDefaults to false.

    There are some context keys you can utilize to configure keyboard shortcuts with precision. See Customizing Keyboard Shortcuts.

    The Nuclear Option: You can choose to disable all default key bindings by configuring calva.paredit.defaultKeyMap to none. (Then you probably also want to register your own shortcuts for the commands you often use.)

    In some instances built-in command defaults are the same as Paredit's defaults, and Paredit's functionality in a particular case is less than what the default is. This is true of Expand Selection and Shrink Selection for Windows/Linux when multiple lines are selected. In this particular case adding !editorHasMultipleSelections to the when clause of the binding makes for a better workflow. The point is that when the bindings overlap and default functionality is desired peaceful integration can be achieved with the right when clause. This is left out of Paredit's defaults to respect user preference, and ease of maintenance.

    Happy Editing! \u2764\ufe0f

    ","boost":7},{"location":"paredit/#experimental-feature-multicursor-support","title":"Experimental Feature: Multicursor support","text":"

    There is an ongoing effort to support simultaneous multicursor editing with Paredit. This is an experimental feature and is not enabled by default. To enable it, set calva.paredit.multicursor to true. This feature is still in development and may not work as expected in all cases. Currently, this supports the following categories:

    ","boost":7},{"location":"parinfer/","title":"Calva Parinfer Mode is Reverted","text":"

    Reverted in Calva v2.0.228

    The changes in v2.0.227 seemed to cause problems for some users. Unclear yet if and why. But to not risk causing problems for more users these changes where reverted and Calva v2.0.228 does not contain them. Please consider using v2.0.227 and help find what the problems are about! Please note: Even in v2.0.227 this feature is currently disabled by default.

    Parinfer is a system for editing the structure of LISP text without explicit commands. The structure can be regarded as already being expressed through indentation. With Parinfer you can use your intuition about the structure inferred from the indentation to perform surprisingly many structural edits.

    "},{"location":"parinfer/#quirks","title":"Quirks","text":"

    There are some known quirks, of varying severity, with this feature. Some of them will need to be fixed before we move this feature out of Experimental status.

    For the most times you can always Undo to get back to where the document was fine. You just need to pay some attention and be aware when undo is needed.

    "},{"location":"parinfer/#no-multi-cursor-support","title":"No multi-cursor support","text":"

    The bracket inference will remove all cursors but the first one. So for instance if you edit with multiple cursors and it causes brackets to move, you'll end up with just one cursor and the subsequent edits will not be what you intended. This is particularly important to note when you have cursors that are not in the viewport. In such cases it might be better to turn Parinfer off while you do the edits, fix formatting and such manually and then switch Parinfer on again.

    "},{"location":"parinfer/#wrong-inferences","title":"Wrong inferences","text":"

    For yet unknown reasons an edit such as the following does the wrong thing (the cursor indicated by the vertical bar):

    (foo| (bar)\n      (baz))\n

    backspace => 

    (fo| (bar\n      (baz)))\n

    That is (baz) is slurped. When what should happen is:

    (fo| (bar)\n     (baz))\n
    "},{"location":"parinfer/#lag-causing-errors-when-fast-typing","title":"Lag causing errors when fast typing","text":"

    The way that Calva Parinfer works is that for any edit of the document it first reformats the code around the cursor, then infer brackets. Currently these two steps are not atomic to VS Code, so if you type fast bracket inference might happen on the yet unformatted code, and thus not be correct. You might also see the cursor end up at the wrong position at times.

    "},{"location":"parinfer/#infer-parens","title":"Infer Parens","text":"

    This is no longer available in Calva

    See above about how to try this build anyway, warts and all.

    When you enable Calva's Parinfer it is all about infering brackets from indentation. There are no further Parinfer modes. Calva's auto-formatter will take care of keeping the code correctly indented.

    Enable it with from this setting: calva.fmt.experimental.inferParensAsYouType or from the status bar item.

    "},{"location":"parinfer/#parinfer-status-bar-items","title":"Parinfer Status bar items","text":"

    To the right on the status bar, right before the Paredit status bar item, you will have two items, Parinfer toggle ON/OFF and a health indicator.

    1. Parinfer ON/OFF indicator/button. \u2022() (The dot/circle indicates ON/OFF)
    2. Structure and indentation health indicator. \u2714\ufe0f/\u26a0/\u2298

    When Parinfer is ON, the health indicator will have three states:

    1. \u2714\ufe0f Healthy - meaning both structure and indentation is OK
    2. \u2298 Structure broken - you need to fix the the structure of the code
    3. \u26a0 Bad indentation - meaning that to Parinfer the structure and indentation do not match, _the item is now also a button with which you can fix the indentation.

    Parinfer will be disabled in both the unhealthy states.

    When Parinfer is OFF, only the first two states above are used.

    "},{"location":"parinfer/#some-vs-code-settings-automatically-changed","title":"Some VS Code Settings automatically changed","text":"

    In order for some automatic VS Code behaviour not to interfere with Parinfer the following settings are automatically configured when you toggle Parinfer ON:

        \"[clojure]\": {\n        \"editor.autoClosingBrackets\": \"never\",\n        \"editor.autoClosingOvertype\": \"never\",\n        \"editor.formatOnPaste\": false\n    },\n

    And when you toggle Parinfer OFF:

        \"[clojure]\": {\n        \"editor.autoClosingBrackets\": \"always\",\n        \"editor.autoClosingOvertype\": \"always\",\n        \"editor.formatOnPaste\": true\n    },\n

    It is recommended that you let Calva handle these settings to avoid weird behaviour.

    "},{"location":"parinfer/#no-tab-indenting","title":"No Tab indenting","text":"

    As the tab key is used for formatting the current form in Calva, it is \u201dtaken\u201d. The closest equivalents you have are space and backspace. At least for now. We'll see if we can find out a good way for supporting tab and shift+tab for indent and dedent.

    tab for formatting is of course just a default key binding and you can assign it to something else to get it to do indenting. However, it will not be a very smart indent anyway, there is no Clojure awareness about it. You are hereby adviced to instead use some more spaces.

    "},{"location":"parinfer/#paredit-is-still-there","title":"Paredit is still there","text":"

    In Calva, Parinfer and Paredit are designed to coexist and both be there to let you edit the structure easily and efficiently. Since Paredit commands are always formatted, they leave the code in a state where Parinfer has what it needs to infer bracket placement as you either edit the indentation, or remove/add brackets.

    "},{"location":"parinfer/#disable-the-parinfer-extension","title":"Disable the Parinfer Extension","text":"

    If you want to have Parinfer you are probably best served by Calva's built-in version. It is designed, and will continue to be improved to function well together with Calva's other structural editing and formatting features. It will also probably conflict with the Parinfer Extension.

    "},{"location":"parinfer/#see-also","title":"See also","text":""},{"location":"polylith/","title":"How to Use Calva with Polylith","text":"

    Polylith is an architecture for backend projects that maximizes development ergonomics and code reuse.

    When developing a Polylith application you use one REPL for everything. And as such it is a rather vanilla deps.edn project, so there is really not much more to using Calva with Polylith than:

    1. Jack in, selecting the deps.edn project type
    2. Select aliases, most often :dev and :test
    3. Hack away!
    "},{"location":"polylith/#the-realworld-example","title":"The RealWorld Example","text":"

    To make it easy to try Polylith out with Calva, the Polylith RealWorld example implementation has some Calva config to get the server started and Calva connected to its REPL quickly:

    1. Fork the project and open it in VS Code
    2. Jack-in, selecting the Polylith RealWorld Server REPL project type
    3. Wait for the REPL prompt to read clj\ua789dev.server\ua789>
    4. Evaluate (start! 6003)
    5. Hack away!
    "},{"location":"polylith/#try-it-with-a-frontend","title":"Try it with a Frontend","text":"

    A ClojureScript frontend, of course:

    1. Fork the jacekschae/conduit project and open it in VS Code
    2. Edit the api-url definition in events.cljs file to be 
      (def api-url \"http://localhost:6003/api\")\n
    3. Jack-in, selecting to start and connect to the :app build
    4. Wait for it to compile and then open http://localhost:3000
    5. Hack away!
    "},{"location":"pprint/","title":"Pretty Printing","text":"

    In Calva, pretty printing is a mode. Prettiness is on by default and all your evaluation results will get that treatment.

    You can also pretty print code on demand

    There is a command Replace Current Form (or Selection) with Pretty Printed Form. See Clojure Formmatting for more on this.

    "},{"location":"pprint/#toggle-it","title":"Toggle it","text":"

    There is a pprint indicator to the right in the status bar which shows the status of the mode. Click the indicator to toggle prettification on and off. There is also a Calva: Toggle Pretty Printing for All Evaluations command.

    Tip: If you have evaluated something time consuming, or that is not idempotent, with pretty printing mistakenly off: toggle it on and evaluate *1.

    "},{"location":"pprint/#configuration","title":"Configuration","text":"

    For most people the defaults will probably work, but Calva pretty printing comes a few knobs you can turn, and they are all available through the calva.prettyPrintingOptions settings. Things you can set are:

    Setting Type Effect enabled boolean So this is a third way you can change this mode \ud83d\ude04 printEngine enum Which printer function that will be used. Default is pprint, more about this setting below printFn object You can configure Calva to use a custom nREPL compatible print function, more below. width number The maximum line length of printed output (or at least the printers will try) maxLength number The maximum number of elements printed in nested nodes, good for evaluating something like (iterate inc 0), which you shouldn't do without setting maxLength. Most printers will indicate truncated lists with ... at the end. maxDepth number The maximum number of levels deep that will get printed. Different printers mark a stop different ways. puget doesn't support it at all.

    See Customizing Calva for some tips on adding settings like these.

    Here's an example of how zprint handles maxDepth (from the Calva implementation of it's client side pretty printing.).

      (pretty-print [[[[[[[[:deeper]]]]]]]] {:max-depth 4})\n  ;; => {:value \"[[[[##]]]]\"}\n
    "},{"location":"pprint/#your-selection-of-prettifiers","title":"Your Selection of Prettifiers","text":"

    Pretty printing can happen on the server (i.e. in the JVM, via nREPL), or on the client (i.e. in node, via VS Code/Calva). Client side always uses zprint. Server side you can choose from these printers:

    Print Engine Client or Server Side Comments calva client The nREPL server will plain print the results, and then Calva will pretty it (using zprint). pprint server Current Calva default. clojure.core/pprint is a bit basic, but it's tried and tested, and doesn't suffer from the issues with the other server side printing options, mentioned below. fipp server puget server Lacks maxDepth option. zprint server A very good option. However, it will need to be configured before Jack-in if you want Calva's help to inject its dependencies. (If you are not using Jack-in, you'll need to supply this dependency yourself.)

    These particular server side functions were chosen because they have pre-configured print-functions in cider-nrepl.

    "},{"location":"pprint/#or-configure-printfn","title":"Or configure printFn","text":"

    If the selection of built-in printEngine support doesn't cut it, you can configure a custom function. This function will need to conform to the requirements of nREPL print functions. The VS Code settings editor will help you configure this one. (This is also a bit experimental, please consider giving feedback about how it works for you if you try it.)

    "},{"location":"pprint/#why-does-server-or-client-side-matter","title":"Why does Server or Client Side Matter?","text":"

    This matters because on the server all pretty printers, except pprint does more than just pretty print the result that would be printed with plain printing. Pretty printing results on the server causes some results to get expanded. This can have huge implications depending on the results and which printer is used. E.g. for Datomic transaction results, you will get the whole database printed. Twice. Depending on the database, you could be so unlucky that nothing gets printed, and instead you will soon have a very hot computer.

    Note: With the help of zprint creator, Kim Kinnear, we have found ways to compensate for this problem. Ways that are not yet implemented, but please stay tuned.

    Then why not always do it client side? It turns out that on the client side there are also things going on. Calva gets the results back as a string and therefore it needs to first be parsed back to EDN, before it can be pretty printed by zprint. And \u2013 here's the catch \u2013 all results are not valid EDN and therefore can't be pretty printed by zprint. Datomic transaction results are one example.

    "},{"location":"pprint/#need-more-configurability","title":"Need More Configurability?","text":"

    The current options are limited, because our time developing Calva is limited. But cider-nrepl really allows for fully configurable pretty printing, so it is within reach. Please feel invited to give us feedback on what you would want to configure for the printing of results. File issues and/or chat us up in #calva in the Clojurians slack.

    "},{"location":"pprint/#troubleshooting","title":"Troubleshooting","text":""},{"location":"pprint/#pprint-is-not-working","title":"pprint is not working","text":"

    If pprint is not working, try a different pprint engine or use Calva's jack-in to make sure the necessary dependencies are loaded in your REPL. If you are starting your REPL without jack-in and want to continue doing so, you can use the command Copy Jack-in Command Line to Clipboard then paste the command somewhere to see what dependencies it injects. You can then add these dependencies to your REPL in whatever way suits your needs.

    Enjoy Prettiful Printing! \u2764\ufe0f

    "},{"location":"quirks/","title":"Quirks","text":"

    Here's a shocker for ya': Calva isn't perfect. \ud83d\ude04

    There are quirks and things that flat out do not work. We'll try to collect info about such things here, providing workarounds when available (or, rather, known to us).

    "},{"location":"quirks/#test-features-not-available-with-clojurescript","title":"Test features not available with ClojureScript","text":"

    Currently cider-nrepl does not provide its test functionality for ClojureScript code. Please consider contributing to fixing that.

    "},{"location":"quirks/#using-with-parinfer","title":"Using with Parinfer","text":"

    See Using with Parinfer

    "},{"location":"quirks/#calva-and-the-vim-extension","title":"Calva and the VIM Extension","text":"

    See Using Calva with the VIM Extension.

    "},{"location":"quirks/#command-not-found-errors-on-jack-in","title":"\u201dCommand not found\u201d Errors on Jack-in","text":"

    Jack-in starts by running a command in a new terminal. You will need the commands used installed on your computer:

    Also, in some circumstances VS Code is not spawned from a shell with the environment variables, especially $PATH, which might mean that even though you have the tools installed, they are not found when VS Code/Calva tries to execute them. To fix this you will need to do one of these two things:

    1. Figure out from where VS Code is spawned, and make sure the $PATH there includes the directory with the needed binary.
    2. Start VS Code from a terminal where the $PATH is correctly configured. (Using the code command.)

    See this issue for more clues on this problem.

    "},{"location":"quirks/#strange-linting-errors","title":"Strange linting errors?","text":"

    This is not really a quirk, and most linting errors are not strange when you learn about why they are there. Calva does not do any linting, btw, see also linting.

    "},{"location":"quirks/#consider-uninstalling-these-extensions","title":"Consider uninstalling these extensions","text":"

    Without Calva, many users install other nifty extensions (some of which are old pieces of Calva) that help with this or that problem. It might sometimes work together with Calva, sometimes not. Here's a list of some common extensions you should consider to at least disable:

    "},{"location":"re-frame-template/","title":"How to use Calva with the re-frame template","text":"

    The re-frame template creates a shadow-cljs project, making it easy to use with Calva.

    1. npm install
    2. From VS Code, issue the command Calva: Start a Project REPL and Connect (a.k.a Jack-in), ctrl+alt+c ctrl+alt+j.
    3. Calva will auto-detect that this is a shadow-cljs project and ask for which build to compile.
    4. Calva's output window will open and log some progress information.
    5. When prompted for which build to start, select :app.
    6. :app is the only configured build, but the VS Code menu for this is a bit strange so make sure the :app checkbox is really ticked before proceeding.
    7. This will start the app, so in this workflow you don't do the Run application steps outlined below.
    8. When prompted for which build to connect to, select :app.
      • In the View menu of VS Code, you can tell it to show the Terminal view, where you see which command the jack-in process is started with, and it's output. Ctrl+C in this pane will kill your app and free up all resources it has allocated.
    9. When the app is compiled
      1. Open http://localhost:8280 in your browser.
      2. Confirm that it says Hello from re-frame. (Depending on how long the app takes to compile, you might need to reload the page a few times.)
    10. Open the views.cljs file from src/<your-project-name> and issue Calva: Load/Evaluate Current File and its Requires/Dependencies. ctrl+alt+c enter.
      1. Confirm that you are connected by adding evaluating (js/alert \"Hello from Calva\") (alt+enter and ctrl+enter are your friends).
      2. Confirm that Shadow is hot reloading by changing the greeting message.
    "},{"location":"rebl/","title":"How to Use Calva and REBL Together","text":"

    REBL is a graphical, interactive tool for browsing Clojure data.

    "},{"location":"rebl/#depsedn","title":"deps.edn","text":"

    Add the following aliases to your deps.edn file. Use the deps.edn file in the ~/.clojure directory to enable alias reuse across multiple projects. This is the configuration for REBL on openjdk 12. Check out the REBL github page for more info.

    ;; REBL Base\n:rebl\n{:extra-deps {org.clojure/core.async {:mvn/version \"0.4.490\"}\n                ;; deps for file datafication (0.9.149 or later)\n                org.clojure/data.csv {:mvn/version \"0.1.4\"}\n                org.clojure/data.json {:mvn/version \"0.2.3\"}\n                org.yaml/snakeyaml {:mvn/version \"1.23\"}\n                com.cognitect/rebl\n                ;; adjust to match your install location\n                {:local/root \"/Users/ozimos/REBL/latest/REBL.jar\"}}}\n\n;; REBL 12\n:rebl-12\n{:extra-deps {org.openjfx/javafx-fxml     {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-controls {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-graphics {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-media    {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-swing    {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-base     {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-web      {:mvn/version \"12.0.1\"}}}\n\n;; nREBL\n:nrebl {:extra-deps {rickmoynihan/nrebl.middleware {:mvn/version \"0.2.0\"}}\n            :main-opts [\"-e\" \"((requiring-resolve,'cognitect.rebl/ui))\" \"-m\" \"nrepl.cmdline\" \"--middleware\" \"[nrebl.middleware/wrap-nrebl]\" \"-I\"]}\n

    Create a Calva custom connect sequence for your VSCode editor. (Read Custom REPL Connect Sequences if you haven't.) Add the following to your vscode settings.json:

    {\n    \"calva.replConnectSequences\": [\n        {\n            \"name\": \"Rebl Connect\",\n            \"projectType\": \"deps.edn\",\n            \"menuSelections\": {\n                \"cljAliases\": [\n                    \"rebl\",\n                    \"rebl-12\",\n                    \"nrebl\"\n                ]\n            }\n        }\n    ]\n}\n
    "},{"location":"rebl/#leiningen","title":"Leiningen","text":"

    Add rebl profiles to your user-wide profiles so that they will be available for all your projects. Here's a sample user profile (located at ~/.lein/profiles.clj on mac):

    {:user {:plugins [[lein-ancient \"0.6.15\"]]}\n\n ;; REBL Base\n :rebl {:resource-paths [\"/Users/ozimos/REBL/latest/REBL.jar\"]\n        :dependencies [[org.clojure/core.async \"0.4.490\"]\n                       [org.clojure/data.csv \"0.1.4\"]\n                       [org.clojure/data.json \"0.2.3\"]\n                       [cljfmt \"0.6.4\"]\n                       [org.yaml/snakeyaml \"1.23\"]]}\n\n ;; REBL 12 for JDK 12.0.1. Swap out for your JDK version\n :rebl-12 {:dependencies [[org.openjfx/javafx-fxml  \"12.0.1\"]\n                          [org.openjfx/javafx-controls \"12.0.1\"]\n                          [org.openjfx/javafx-graphics \"12.0.1\"]\n                          [org.openjfx/javafx-media \"12.0.1\"]\n                          [org.openjfx/javafx-swing \"12.0.1\"]\n                          [org.openjfx/javafx-base  \"12.0.1\"]\n                          [org.openjfx/javafx-web \"12.0.1\"]]}\n\n;; NREBL https://github.com/RickMoynihan/nrebl.middleware\n :nrebl {:repl-options {:nrepl-middleware [nrebl.middleware/wrap-nrebl]}\n        :dependencies [[rickmoynihan/nrebl.middleware \"0.3.1\"]]}}\n
    More info here

    Create a Calva custom connect sequence for your VSCode editor. (Read Custom REPL Connect Sequences if you haven't.) Add the following to your vscode settings.json:

    {\n    \"calva.replConnectSequences\": [\n        {\n            \"name\": \"Lein REBL\",\n            \"projectType\": \"Leiningen\",\n            \"menuSelections\": {\n                \"leinProfiles\": [\"rebl\", \"rebl-12\", \":nrebl\"]\n            },\n            \"afterCLJReplJackInCode\": \"((requiring-resolve 'cognitect.rebl/ui))\"\n        }\n    ]\n}\n
    "},{"location":"rebl/#shadow-cljs-tbd","title":"shadow-cljs (TBD)","text":"

    TBD. If you know how to do it, please update this page.

    "},{"location":"refactoring/","title":"Refactoring","text":"

    There are two \u201dflavours\u201d to refactoring support. Some (just a few) refactorings are made available as Quick Fix suggestions (the light bulb), the rest are regular commands in the clojure-lsp Refactoring category.

    You can enable or disable the Quick Fix suggestion lightbulb using the VS Code setting editor.lightbulb.enabled.

    The refactoring commands do not have default keyboard shortcuts. You find them all by typing \u201dclojure-lsp Refactor\u201d in the Command Palette.

    "},{"location":"refactoring/#commands","title":"Commands","text":"Command Title Command Key Description Clean NS Form clojureLsp.refactor.cleanNs Add Missing Require clojureLsp.refactor.addMissingLibspec Extract to New Function clojureLsp.refactor.extractFunction Cycle/Toggle Privacy clojureLsp.refactor.cyclePrivacy Inline Symbol clojureLsp.refactor.inlineSymbol Introduce let clojureLsp.refactor.introduceLet Creates a new let box with the binding. Follow up with \u201dExpand let\u201d to move it upwards. Expand Let clojureLsp.refactor.expandLet Move to Previous let Box clojureLsp.refactor.moveToLet Thread First clojureLsp.refactor.threadFirst Thread First All clojureLsp.refactor.threadFirstAll Thread Last clojureLsp.refactor.threadLast Thread Last All clojureLsp.refactor.threadLastAll Unwind All clojureLsp.refactor.unwindAll Unwind Thread clojureLsp.refactor.unwindThread

    Formatting

    The way that some of the refactorings are applied to the document, makes it difficult for Calva to format the results. So, sometimes you'll need to navigate the cursor to the enclosing form and hit tab to tidy up the formatting after a refactoring. See also Formatting.

    "},{"location":"refactoring/#thanks-to-clojure-lsp","title":"Thanks to clojure-lsp","text":"

    Most of Calva's refactoring support is sourced directly from clojure-lsp. This also means that most often, if you find issues with refactoring, or have suggestions about it, the clojure-lsp repo is where to direct your reporting.

    "},{"location":"remote-development/","title":"Using Calva with Remote Development","text":"

    VS Code Remote Development is a new feature in version 1.35 of VS Code that allows a developer to use a container, remote machine, or the Windows Subsystem for Linux (WSL) as a full-featured development environment.

    I would recommend reading the introductory blog post and watching the videos. I find the feature extremely exciting and wish more IDEs would implement something like it.

    From a Clojure perspective it allows you to have VS Code installed on your Java-less, Clojure-less hardware and still use it to develop Clojure through it.

    "},{"location":"remote-development/#a-use-case","title":"A use-case","text":""},{"location":"remote-development/#how-to","title":"How to","text":"

    Run Remote-Containers: Add Development Container Configuration Files... and pick a suitable Java base image. Then:

    "},{"location":"remote-development/#modify-dockerfile-to-install-clojure-cli-and-optionally-lein","title":"Modify Dockerfile to install Clojure CLI (and optionally lein)","text":"

    Add:

    # ...\n\n# Install Clojure - see https://github.com/Quantisan/docker-clojure/blob/master/target/openjdk-14-slim-buster/tools-deps/Dockerfile\nENV CLOJURE_VERSION=1.10.1.619\nWORKDIR /tmp\nRUN \\\napt-get update && \\\napt-get install -y curl make rlwrap wget && \\\nrm -rf /var/lib/apt/lists/* && \\\nwget https://download.clojure.org/install/linux-install-$CLOJURE_VERSION.sh && \\\nsha256sum linux-install-$CLOJURE_VERSION.sh && \\\necho \"28b1652686426cdf856f83551b8ca01ff949b03bc9a533d270204d6511a8ca9d *linux-install-$CLOJURE_VERSION.sh\" | sha256sum -c - && \\\nchmod +x linux-install-$CLOJURE_VERSION.sh && \\\n./linux-install-$CLOJURE_VERSION.sh\nRUN \\\nsu vscode -c \"clojure -e '(clojure-version)'\" && \\\nrm ./linux-install-$CLOJURE_VERSION.sh\n\n# Install Lein\nRUN \\\nwget https://raw.githubusercontent.com/technomancy/leiningen/stable/bin/lein -O /bin/lein && \\\nchmod uog+x /bin/lein\nRUN su vscode -c \"/bin/lein\"\n\n# Cleanup\nRUN apt-get purge -y --auto-remove curl wget\n\n# ...\n
    "},{"location":"remote-development/#modify-devcontainerjson","title":"Modify devcontainer.json","text":"

    Add Calva and, optionally, forward some ports to the host::

    \"extensions\": [\"betterthantomorrow.calva\"],\n\"forwardPorts\": [8088, 52162], // example: your webapp, your nREPL\n
    "},{"location":"remote-development/#build-and-start","title":"Build and start","text":"

    Run Remote-Containers: Rebuild and Reopen in container

    "},{"location":"remote-development/#wsl","title":"WSL","text":"

    See Using Calva with WSL

    "},{"location":"repl-window/","title":"The REPL Window/File","text":"

    The Calva REPL Window is actually a regular file with some extra treatment from Calva, like displaying a prompt, offering evaluation history recall and generally \u201cfollowing\u201d the current namespace. This file is created and opened when Calva is connected to a REPL. You can use it for experimental code (though there are also Rich Comments and Fiddle Files for this).

    In ClojureScript projects, the window will be associated with the cljs REPL once it is connected. It will then look something like this:

    The first prompt is from when the clj REPL is connected, and the second from cljs. The first part of the prompt tells you which REPL type the window is currently connected to.

    "},{"location":"repl-window/#using-the-repl-window-for-output","title":"Using the REPL Window for output","text":"

    By default the REPL Window doubles as the place where Calva sends output like stdout/stderr and other messages. See Calva Output for more about this and how to change this behaviour.

    "},{"location":"repl-window/#finding-the-repl-window","title":"Finding the REPL Window","text":"

    If you quickly want to open and/or switch to the REPL Window there is the command Calva: Show/Open REPL Window, ctrl+alt+o r.

    To sync the REPL window namespace with the current file before switching, use the Switch Namespace of the REPL Window to Current Namespace command, ctrl+alt+c alt+n.

    "},{"location":"repl-window/#find-the-file-for-the-current-repl-window-namespace","title":"Find the File for the Current REPL Window Namespace","text":"

    When you are editing things in the REPL window, and want to open the file that defines its current namespace, use the Show File for the Current REPL Window Namespace command, ctrl+alt+o r.

    Note

    This also works for Clojure core and library namespaces.

    "},{"location":"repl-window/#evaluating-code","title":"Evaluating Code","text":"

    The window will be automatically associated with the REPL and the namespace of any project Clojure/ClojureScript file you evaluate code in. So for instance if you evaluate this code in a clj file with the namespace fresh-reagent.handler:

    (def mount-target\n  [:div#app\n   [:h2 \"Welcome to fresh-reagent\"]\n   [:p \"please wait while Figwheel is waking up ...\"]\n   [:p \"(Check the js console for hints if nothing exciting happens.)\"]])\n

    If the REPL Window is the configured destination for evaluation results, the defined var will be printed there. Otherwise, it will be printed to the destination you've configured. In either case, the REPL window will print a new prompt reflecting the current REPL connection and namespace:

    If you then switch to the output window (ctrl+alt+o r), and enter this at the prompt:

    mount-target\n

    then evaluate it using alt+enter, you'll get this:

    ... because the namespace \u201dfollowed\u201d the first evaluation in the REPL window.

    "},{"location":"repl-window/#repl-history","title":"REPL History","text":"

    Recently evaluated forms in the REPL file are persisted and can easily be shown again for modifying and re-evaluating.

    "},{"location":"repl-window/#navigate-repl-history","title":"Navigate REPL History","text":"

    You can navigate up and down the history of evaluated forms in the REPL file by pressing alt+up and alt+down, provided your cursor is at the end of the last form after the prompt. If the cursor is not at the end of the last form, then alt+up and alt+down will do whatever they are mapped to, which is by default \"Move Line Up\" and \"Move Line Down,\" respectively.

    If you have typed some text after the prompt before you start traversing up the history, this text will be preserved and will display when you traverse back down the history. If you modify some text in the history while traversing, the modification will be saved at that location in history.

    "},{"location":"repl-window/#clear-repl-history","title":"Clear REPL History","text":"

    You can clear the repl history by running the command \"Clear REPL History\" from the command palette.

    "},{"location":"repl-window/#stack-traces","title":"Stack Traces","text":"

    When an evaluation produces an error, it will automatically be printed in the REPL Window. If there is a stack trace associated with the error, it can now be printed on demand using the Calva: Print Last Stacktrace to the Output Window command. You can also print the stack trace for any error message printed to the REPL Window via the Codelens button below it.

    For printed stacktraces, when source locations are available (Clojure files), you will be able to navigate to them by pressing ctrl+click (cmd+click on Mac) on the file name. You can also hover over symbols in the stack trace to see the symbol's documentation, and ctrl+click (cmd+click on Mac) the symbol to Peek Definition.

    Output destinations

    If you have configured some other destination for stderr output, the error message will be printed there as well. But it will also be printed to the REPL Window, because the augmented stack traces need this (because reasons).

    "},{"location":"repl-window/#load-current-namespace","title":"Load Current Namespace","text":"

    When navigating namespaces it is easy to forget to first require them and that can be tricky to debug. To help with this, Calva's command Load/Evaluate Current File and its Requires/Dependencies also works in the REPL Window, but there, it acts like Load Current Namespace.

    Suppose you have two files, pez/xxx.clj and pez/yyy.clj, where pez.yyy requires pez.xxx.

    (ns pez.xxx)\n\n(def a :xxx-a)\n\n(def b :xxx-b)\n
    (ns pez.yyy\n  (:require [pez.xxx]))\n\n(def a :yyy-a)\n\n(println \"Hello\" pez.xxx/a)\n

    Then, with a freshly jacked-in REPL, you evaluate (ns pez.yyy) and want to work with the vars defined there, Clojure will complain. But if you Load/Evaluate Current File and its Requires/Dependencies, it will start working. Something like so:

    Note

    This currently suffers from a limitation in Calva where it won't reload dependencies, so you will sometimes have to do this \u201dmanually\u201d anyways (by opening the files and loading them yourself). See Calva issue #907

    "},{"location":"repl-window/#peek-current-namespace","title":"Peek Current Namespace","text":"

    A somewhat hidden feature: You can peek, see documentation for, and navigate to a namespace by hovering on the namespace symbol in one of the REPL Window prompts (just like you would if it was not in the prompt \ud83d\ude04).

    "},{"location":"repl-window/#paredit-enabled","title":"Paredit Enabled","text":"

    The REPL Window is mostly a regular Calva Clojure/ClojureScript file, which makes everything that works in a regular file work in this file, including Paredit. This makes it easy to navigate the input and output there. For instance, to select the last evaluation results, you can press ctrl+w (shift+alt+right on Windows and Linux):

    "},{"location":"repl-window/#debugger-enabled","title":"Debugger Enabled","text":"

    The output window is mostly a regular... (you get it), which means you also have the Calva debugger at your command at the REPL prompt (only for clj sessions, for now). So instead of evaluating a function definition using alt+enter, you can evaluate it and instrument it for debugging using ctrl+alt+c i, and then call the function.

    "},{"location":"repl-window/#it-is-ephemeral","title":"It is Ephemeral","text":"

    The contents of the output/REPL window is written to a file named output.repl in the .calva/output-window directory of your project. The file is recreated every new session, so you should copy or save anything you want to preserve between sessions.

    You probably want to add .calva/output-window/ to your .<something>ignore files. (There are some more files in that directory that you shouldn't keep under source control.)

    "},{"location":"repl-window/#choose-clj-or-cljs-repl-connection","title":"Choose CLJ or CLJS REPL Connection","text":"

    In full-stack projects, you will probably use the window as a REPL for both clj and cljs. You can toggle which REPL the window is connected to by using the command Calva: Toggle REPL Connection for CLJC files. There is also a button for this in the status bar:

    "},{"location":"repl-window/#known-quirks-and-caveats","title":"Known Quirks and Caveats","text":"

    Due to limitations in the VS Code API it is hard for Calva to know if the REPL file is open, and if it was opened more than once. Therefore, we suggest you make it a habit to leave this window open, or even pinned. And if it is open in several tabs, expect evaluation printouts to be a bit unpredictable.

    If you save the REPL file (which most often does not make much sense, but anyway) you will sometimes be presented with a message about VS Code being confused about the file contents being out of sync. Just choose to Overwrite the currently saved version and you should be fine.

    "},{"location":"reveal/","title":"How to use Calva and Reveal together","text":"

    Reveal is a \"Read Eval Visualize Loop for Clojure\". This page describes how to use Reveal in your development setup based on Calva.

    Note

    See https://vlaaad.github.io/reveal for the latest version and use that wherever this page says <version>.

    "},{"location":"reveal/#when-using-toolsdeps","title":"When using tools.deps","text":"

    You can go for the nrepl middleware or just add the dependency.

    Please see the Calva test-data project minimal-reveal for an example.

    "},{"location":"reveal/#middleware","title":"Middleware","text":"

    This will make Reveal to start together with your project.

    Note

    This will make all Calva evaluations go to Reveal. Too chatty for you? Take the dependencies only approach.

    Add this alias deps.edn:

    :aliases\n{:reveal-nrepl-middleware\n    {:extra-deps {vlaaad/reveal {:mvn/version \"<version>\"}}\n     :main-opts  [\"-m\" \"nrepl.cmdline\"\n                  \"--middleware\" \"[vlaaad.reveal.nrepl/middleware,cider.nrepl/cider-middleware]\"]}}\n

    And then jack-in choosing the deps.edn option and then pick the :reveal-nrepl-middleware alias.

    "},{"location":"reveal/#dependencies-only","title":"Dependencies only","text":"

    If you don't want to use the nrepl-middleware you can configure just the dependency and then start Reveal yourself.

    The alias:

    :reveal-dep-only\n  {:extra-deps {vlaaad/reveal {:mvn/version \"<version>\"}}}\n

    A custom REPL command for starting Reveal in your project:

        \"calva.customREPLCommandSnippets\": [\n        ...\n        {\n            \"name\": \"Start Reveal Tapper\",\n            \"snippet\": \"(require '[vlaaad.reveal :as reveal])(add-tap (reveal/ui))\",\n            \"key\": \"sr\"\n        },\n        ...\n    ]\n

    See Custom REPL Command for how to configure more commands, and bind shortcuts to them, to make Reveal integration nice for you.

    "},{"location":"reveal/#when-using-leiningen","title":"When using Leiningen","text":"

    In your project.clj, add a profile named \"reveal\":

    :profiles {:reveal {:dependencies [[vlaaad/reveal \"<version>\"]]\n                    :repl-options {:nrepl-middleware [vlaaad.reveal.nrepl/middleware]}}}\n

    Now when you jack-in using Calva, you enable this profile and Reveal will be started automatically. Please note that Reveal requires Java 8 or higher, and uses JavaFX. Depending on your setup, you may need to make sure it is available.

    "},{"location":"reveal/#tips-about-font-size","title":"Tips about font size","text":"

    If you find the font to small you can add a :jvm-opts key to make it a little bigger:

    :aliases\n{:reveal\n    {:extra-deps {vlaaad/reveal {:mvn/version \"<version>\"}}\n     :jvm-opts   [\"-Dvlaaad.reveal.prefs={:font-size,17}\"]\n     :main-opts  [\"-m\" \"nrepl.cmdline\"\n                  \"--middleware\" \"[vlaaad.reveal.nrepl/middleware,cider.nrepl/cider-middleware]\"]}}\n
    "},{"location":"reveal/#using-java-11","title":"Using Java > 11?","text":"

    Reveal needs some reflective access to internal classes that has since Java 11 been restricted. You can relax this and get things working via JVM options. Tuck this into your reveal alias:

    :jvm-opts [\"--add-opens\" \"javafx.graphics/com.sun.javafx.tk=ALL-UNNAMED\"]\n

    (If you are using the font size tips, just add the options into the :jvm-opts vector.)

    See https://github.com/vlaaad/reveal/issues/1 for some more context around this issue.

    "},{"location":"rich-comments/","title":"Rich Comments Support","text":"

    Why bother with Rich comments? Read on. Consider watching this Youtube video for a demo of the workflow using the (in?)famous FizzBuzz problem as an example.

    ","boost":5},{"location":"rich-comments/#things-in-comment-are-not-evaluated","title":"Things in comment are not evaluated","text":"

    The Clojure comment macro is defined like so:

    (defmacro comment\n  \"Ignores body, yields nil\"\n  {:added \"1.0\"}\n  [& body])\n

    It has no forms in its body and will therefore always (as long as the Clojure Reader can read it) evaluate to nil. That is: nothing in the (comment ...) form will get evaluated when the file is loaded.

    This makes it a very good \u201dplace\u201d where you can develop code, experiment with code, and keep example code. Since you will be able to load/evaluate the current file without worrying that the code in the comment form will get evaluated. This also holds true when using tools that hot-reload the code on save, such as Figwheel, shadow-cljs and Krell.

    To develop or refine a function you might:

    1. Open up a (comment ...) form
    2. Inside this form, type a first, super simple, version (or refinement) of your function and evaluate it
    3. Inside the same comment form, type some code to test your function and evaluate that
      • Or type and evaluate some code you might need for your function
    4. Repeat from 2., until the function does what you want it to do
    5. Move the function definition out of the comment form
    6. Clean up the comment form to keep some of the test code as example use, or \u201ddesign decision log\u201d for the function.

    Note

    Using (comment ...) forms for developing code is very common among Clojure coders. Rich Hickey is known for using it, which is why they are called Rich comments to begin with (even if it also is a very rich experience).

    ","boost":5},{"location":"rich-comments/#calva-encourages-rich-comments","title":"Calva encourages Rich comments","text":"

    Calva has several features to facilitate the Rich comments workflow, e.g.

    1. A command that helps you create a new Rich comment form quickly: Calva: Add Rich Comment, ctrl+alt+r c
    2. A snippet for creating Rich comment form quickly. Typing (rcf, will make it appear.
    3. Special Syntax highlight. By default comment forms are rendered in italics
    4. Special top-level form context
    5. Special formatting

    Note that the command and snippet for creating Rich comments add the keyword :rcf right before the closing paren. This makes the closing paren stay and not fold when you format the code. The special formatting (see below) will treat this and also any ignored (with #_) form at the end of the form specially.

    ","boost":5},{"location":"rich-comments/#comment-is-top-level","title":"comment is top-level","text":"

    To make it easy to evaluate forms in (comment ...) forms, they create a new top-level context. Instead of you having to place the cursor with precision before evaluating the current form, you can have the cursor anywhere within a comment enclosed form and Evaluate Top-Level Form.

    This carries over to all commands in Calva which deal with the top level form. Including custom command snippets.

    ","boost":5},{"location":"rich-comments/#special-formatting","title":"Special formatting","text":"

    To invite a Rich comments workflow, the Calva command Format Current Form will not fold the closing bracket of the (comment ...) form. Instead it will place this bracket on a line of its own (or keep it there).

    (comment\n  )\n

    With the cursor somewhere directly inside the comment form (denoted with a |):

    (comment\n  (def foo\n:foo)|)\n

    tab

    (comment\n  (def foo\n    :foo)\n  |)\n

    !!! Note \"Only for the current comment form\u201d The special formatting only applies in the current comment form. When outside it, formatting tucks the closing paren in again. That's why fold when done, below works like it does. This also applies to VS Code commands like Format Document, or when you have Format On Save enabled. There are several reasons for this, and one is that there is no cljfmt config for it and leaving the closing comment un-tucked might give you troubles with CI pipelines that enforce some cljfmt config be followed. (Another reason is that it would be pretty hard to do on the whole document.)

    ","boost":5},{"location":"rich-comments/#special-formatting-disabled-for-trailing-rcf","title":"Special formatting disabled for trailing :rcf","text":"

    If the Rich comment ends with :rcf (or an ignored form), the special formatting doesn't happen. So if you have:

    (comment\n  (def foo\n:foo)\n  |\n  :rcf)\n

    And hit tab, you will get:

    (comment\n  (def foo\n    :foo)\n  |\n  :rcf)\n
    ","boost":5},{"location":"rich-comments/#thinking-space-is-kept","title":"Thinking space is kept","text":"

    The formatter will not remove newlines between the cursor and the closing bracket. So if you have entered a few lines to get \u201dthinking\u201d room:

    (comment\n  (def foo\n:foo)\n\n|\n\n)\n

    tab

    (comment\n  (def foo\n    :foo)\n\n  |\n\n  )\n
    ","boost":5},{"location":"rich-comments/#fold-when-done","title":"Fold when done","text":"

    To fold the trailing paren automatically, place the cursor immediately outside (before or after) the form:

    (comment\n  (def foo\n:foo))|\n

    tab

    (comment\n  (def foo\n    :foo))|\n
    ","boost":5},{"location":"rich-comments/#enabled-by-default","title":"Enabled by default","text":"

    You can disable this behavior with the setting: calva.fmt.keepCommentTrailParenOnOwnLine.

    ","boost":5},{"location":"rich-comments/#only-for-the-current-form","title":"Only for the Current Form","text":"

    Note

    This treatment only applies to formatting of the current form. With fold when done as an exception.

    ","boost":5},{"location":"shadow-cljs/","title":"shadow-cljs","text":"

    Calva supports most any JVM hosted ClojureScript environment (and some others, including SCI based, too), but shadow-cljs gets some special treatment to try make it extra convenient to use.

    With many shadow-cljs projects, Calva's connect project type shadow-cljs, is the right choice. Projects that use Leiningen or deps.edn can be used both with the Leiningen/deps.edn and shadow-cljs type, depending on configuration see below for more on this.

    ","boost":7},{"location":"shadow-cljs/#shadow-cljs-browser-quickstart","title":"shadow-cljs - browser quickstart","text":"

    Here's how you start a shadow-cljs ClojureScript REPL and connect Calva with the shadow-cljs - browser quickstart example project:

    Prep:

    1. Clone the project to your machine and open its root folder in VS Code.
    2. Open a terminal and run npm install

    Connect Calva:

    1. Run the command Calva: Start a Project REPL and Connect (a.k.a. Jack-in)
    2. Select project type shadow-cljs
    3. Select to start the build :app
    4. Select to connect to the build :app
    5. Wait for the build to complete
    6. Open http://localhost:8020/ in the browser
    7. Open browser.cljs file and load it in the REPL: Calva: Load/Evaluate Current File and Dependencies

    Now you can should be able to evaluate forms, e.g.:

    (See Code Evaluation)

    ","boost":7},{"location":"shadow-cljs/#shadow-cljs-in-full-stack-projects","title":"shadow-cljs in full stack projects","text":"

    shadow-cljs is a bit special in regards to Calva REPL connection. Mainly because you can start shadow-cljs and it's nREPL server in two ways:

    1. Using the shadow-cljs npm executable
    2. Via the Clojure REPL in your Leiningen or deps.edn project

    These options show up as project types when connecting or jacking in:

    1. Project type: shadow-cljs
    2. Project type: deps.edn + shadow-cljs or Leiningen + shadow-cljs

    The technical difference here is wether you let shadow-cljs start clojure/Leiningen (the first option) or if you let Calva do it (the second option). If you let Calva do it, Calva will then start the shadow-cljs watcher from the Clojure process. From a usage perspective the two approaches will result in different channeling of shadow-cljs output, e.g. test runner results. With the first option (the shadow-cljs project type), shadow-cljs output will be channeled to the Jack-in terminal. With the deps.edn/Leiningen option, that output will be channeled to the Output/REPL window.

    See shadow-cljs + Clojure with Calva: The basics for some more discussion on how the REPL connection works.

    shadow-cljs and clojure aliases

    The shadow-cljs project type will not prompt you for any aliases found in the deps.edn file. Usually you should provide such aliases in shadow-cljs.edn like :deps {:aliases [...]}. If, for whatever reason you can't provide the aliases that way, you can configure a Custom REPL Connect Sequence and provide the aliases as menuSelections -> cljAliases.

    Leiningen + shadow-cljs middleware issue

    Please note that for Leiningen, the command line dependency injection of the shadow-cljs nrepl middleware doesn't work. You need to add it to your project.clj:

    :repl-options {:nrepl-middleware [shadow.cljs.devtools.server.nrepl/middleware]}\n
    ","boost":7},{"location":"shadow-cljs/#see-also","title":"See also:","text":"","boost":7},{"location":"sponsors/","title":"Calva Sponsors","text":"

    Calva is open source and free to use. It is actively maintained during our free time, and it keeps improving. You can contribute in many different ways, one of which is sponsoring. You can sponsor Calva by directly sponsoring any of us.

    If you are working at a company which benefits from Calva's existence and continued development, please consider sponsoring at the Calva Gold Sponsor tier.

    Please see this statement from Cognitect about the importance of supporting open source developers.

    ","boost":7},{"location":"sponsors/#patrons","title":"Patrons","text":"The right kind of different","boost":7},{"location":"sponsors/#gold-sponsors","title":"Gold Sponsors","text":"Scale your growth on mobile MAKE. DO. SHIP.","boost":7},{"location":"sponsors/#silver-sponsors","title":"Silver Sponsors","text":"","boost":7},{"location":"sponsors/#clojurists-together","title":"Clojurists Together","text":"

    Significant additions to Calva have been made possible by funding from Clojurists Together. And this has often been transformational for the whole project. Calva would not be where it is today without Clojurists Together.

    ","boost":7},{"location":"sponsors/#our-sponsoring-profiles","title":"Our Sponsoring Profiles","text":"

    These are the sponsoring profiles for the active maintainers of Calva (a.k.a. The Calva Team).

    ","boost":7},{"location":"sponsors/#readme-visibility","title":"README visibility","text":"

    There is also a sponsors section in the README of the Calva project (which means it is also displayed in the VS Code Extension Marketlace).

    ","boost":7},{"location":"syntax-highlighting/","title":"Calva Highlight","text":"

    Calva takes care of syntax highlighting, and also provides some features not available through VS Code's highlighting mechanism. These extras include rainbow parens, sane bracket matching, and comment form dimming/highlighting.

    "},{"location":"syntax-highlighting/#syntax-highlighting","title":"Syntax Highlighting","text":"

    When using Calva, you are also using its TMLanguage grammar (the core mechanism VS Code uses for syntax highlighting).

    Our grammar tokenizes Clojure keywords as constant.keyword.clojure. Since it is pretty uncommon with keyword constants in the programming languages out there, your theme might not have a highlight defined for this scope. Try find a grammar that highlights keywords! If you are very fond of some theme lacking this, you can help it with a setting:

    \"editor.tokenColorCustomizations\": {\n    \"[Default Dark+]\": {\n        \"textMateRules\": [\n            {\n                \"scope\": [\n                    \"constant.keyword.clojure\"\n                ],\n                \"settings\": {\n                    \"foreground\": \"#6fbfff\"\n                }\n            }\n        ]\n    }\n},\n

    Instead of Default Dark+ you should use your theme's name/key. And choose a color you like, of course.

    "},{"location":"syntax-highlighting/#extra-highlighting","title":"Extra Highlighting","text":"

    You are in charge of how brackets and comments are highlighted via the calva.highlight.<setting> settings:

    Setting Meaning Example enableBracketColors Enable rainbow colors true rainbowIndentGuides Enable rainbow indent guides true highlightActiveIndent Highlight the active indent guide true bracketColors Which colors to use [\"#000\", \"#999\"] cycleBracketColors Whether same colors should be reused for deeply nested brackets true misplacedBracketStyle Style of misplaced bracket { \"border\": \"2px solid #c33\" } matchedBracketStyle Style of bracket pair highlight {\"backgroundColor\": \"#E0E0E0\"} ignoredFormStyle Style of #_... form {\"textDecoration\": \"none; opacity: 0.5\"} commentFormStyle Style of (comment ...) form {\"fontStyle\": \"italic\"}

    Calva disables the VS Code built-in indent guides

    The VS Code built-in settings editor.renderIndentGuides and editor.highlightActiveIndent do not have any effect, since the former is switched off by the Clojure Defaults, mentioned above. Use Calva Highlight's rainbowIndentGuides and highlightActiveIndent instead. They are different from the built in ones in that they are independent, meaning you can choose to have active indent highlighted while the guides generally are not rendered (this is the default, even).

    VS Code bracket coloring vs Calva's

    Calva's bracket coloring is more Clojure aware than VS Code's built-in coloring. And also will chime better with Calva's indent guides. If you like to have bracket coloring outside Clojure code, by all means enable it. Calva's bracket coloring will \u201dover paint\u201d in Clojure files, when enabled. These settings work nicely:

    \"calva.highlight.highlightActiveIndent\": true,\n\"editor.bracketPairColorization.enabled\": true,\n

    The calva.highlight.bracketColors setting can be used to harmonize the coloring between VS Code and Calva.

    "},{"location":"tao/","title":"The Tao of Calva","text":"

    Calva, the spirit, gains much of its taste and color from the Cider it is distilled from, and the oak it is matured in. I started to wonder what it is that shapes Calva, the VS Code Clojure Extension. I should know, being the master distiller, right?. Indeed. Poking some at the question, I do find that I have some answers.

    Please read the following to learn what Calva is, and, to some extent, is not, about. Read it to get an idea about which path Calva is following, where we are headed with the project, and how you can contribute to the journey.

    "},{"location":"tao/#why-calva","title":"Why Calva?","text":"

    Calva's raison d\u00b4\u00eatre is to provide Visual Studio Code users with an easy to use and productive environment for Clojure and ClojureScript development. See the Why Calva? page for some evidence that we are succeeding.

    While Calva draws a lot of inspiration from CIDER, Cursive, Fireplace, and other Clojure development environments, it does not try to compete with them. Reading r/Clojure and elsewhere, it is easy to get the impression that the most common question is \"Which editor should I use for Clojure development?\u201d. I think a much more common question is \u201dHow do I use my favorite editor for Clojure development?\u201d. For VS Code users, that is where Calva should be a good choice.

    I also have an ambition to leverage VS Code for easing the path to Clojure. Given that it is the favorite editor for so many developers, it is important to have a good development environment in place on this platform, and to make it as easy to use as we possibly can, while also being productive and something that you want to stick with, once you are hooked on Clojure.

    That said, and therefore: For people who want to start out with Clojure, and do ask about what development environment would make it the most enjoyable, I'd like for Calva to be a really good option, an option so good that Clojurians feel they can recommend it.

    "},{"location":"tao/#design-goals","title":"Design Goals","text":"

    Calva should be easy to start with and productive enough to stick with. It should support Clojure Best Practices, and be pleasant and enjoyable to use. It should also be easy to hack on, and to contribute to. The ClojureScript story keeps getting more important. Calva should contribute to making the development experience with ClojureScript delightful.

    "},{"location":"tao/#easy-to-start-with","title":"Easy to Start With","text":"

    There are reasons as to why VS Code is so popular. Among those, one stands out to me: It is the most approachable code editor out there. There is nothing you need to learn when you start using it. The editor makes it obvious that you can start typing, deleting, cutting, pasting and undoing, without having to figure anything out. Then you learn how to bring up the command palette and get a boost few other environments can provide with such immediacy.

    A language extension for VS Code can leverage this, by recognizing that what's old is old, and that what's new should be as easy as possible to pick up. Coming to a new language, people bring with them a lot of expectations from the languages they are used to. This is also true for the editor support. Syntax highlighting and formatting should just work, as should documentation lookup, linting and other IDE commodities.

    Clojure brings some new concepts to the table. Chief among these: The REPL. It does take some time to grasp it. Calva needs to remove any obstacles it can when it comes to helping the user to reach the REPL, in order to help getting it, and start loving it.

    To help the users to quickly focus on Clojure, we provide a package that is all-inclusive, with few knobs to turn, and with sane defaults for the knobs that still need to be there.

    "},{"location":"tao/#productive-enough-to-stick-with","title":"Productive Enough to Stick With","text":"

    I think VS Code brings inspiration also when it comes to following up its excellent Getting Started story. You do not have to dig very deep under its surface to find that there is a lot more power to be unleashed. VS Code makes it easy to pick up more features as you get ready for it, and each little piece makes you more productive. To me, only Vim beats VS Code in this game.

    Most often there should be no contradiction between Easy to Start With and Productive. Quite the contrary. This story is mainly about being feature complete with the most important tools. As beginners start to pick up the first few features, they should be rewarded with finding more productive tools when they go looking for them. The VS Code way is Calva's way.

    "},{"location":"tao/#pleasant-and-enjoyable","title":"Pleasant and Enjoyable","text":"

    Enjoyable starts with that Calva shouldn't be an experience full of pains. I think Calva is living up to this first bar of enjoyability. The next step is making it delightful!

    Calva has two main assets it can leverage for being delightful to use: Clojure and VS Code:

    Clojure is plain wonderful and also has this totally awesome REPL thing. Wherever we can, Calva should use the REPL to make the editor spark and bring joy to the developer.

    VS Code is a sweet development environment, offering its power in a consistent way across languages. Even if Clojure is very special, most of Calva's features are surfaced in the ways that VS Code encourages. It makes for less to learn for the user, and most often also makes it easier to implement functionality.

    "},{"location":"tao/#support-clojure-best-practices","title":"Support Clojure Best Practices","text":"

    Mainly, I think Stuart Halloway is right about the REPL being best used from inside the files you are editing rather than from the prompt. It doesn't mean that Calva's REPL window should be neglected, but efforts should be directed such that the file editor REPL is our first way to improve the experience. Expect the Calva REPL window to get much less \u201din your face\u201d, than it is today, as the editor REPL gets stronger.

    Halloway also gives me some peace of mind with his reasoning of keeping a spartan setup. Calva does not need to pack every feature imaginable. If we can get the right features in place, in the right way, the mission is accomplished.

    Clojure is data centric. Calva should make it easy to examine data and how our code affects it. Today, this is not good enough when it comes to data structures larger than a few elements.

    Clojure is a LISP. Thus Structural Editing is possible, and TBH, desirable. Calva should support this and encourage it. There is little we can do about Parinfer not playing well with VS Code, but there is Paredit, and Paredit rocks! Calva's Paredit plays in the top league of Paredits, for this reason.

    "},{"location":"tao/#made-from-the-produce-of-the-orchard","title":"Made from the Produce of the Orchard","text":"

    Calva is distilled from CIDER, which in turn is brewed from the products of The Orchard. This makes a lot of Calva's features thin wrappers around cider-nrepl and related middleware. It also should mean that we strive for adding features by thinking \u201dThe Orchard\u201d first. If it lacks what we need, we should assist in providing it there. We need to up this game a bit from where we are today, I think.

    "},{"location":"tao/#leveraging-clojure-lsp","title":"Leveraging clojure-lsp","text":"

    Today, Calva draws a lot of its static power from clojure-lsp. As does a lot of other Clojure tooling out there. The Calva and the clojure-lsp teams work very nicely together, which is something we cherish and should take care to maintain.

    "},{"location":"tao/#project-stewardship","title":"Project Stewardship","text":"

    Here Calva takes inspiration from many Clojure related projects, and perhaps most so from CIDER,shadow-cljs, and clojure-lsp. Bozhidar Batsov, Thomas Heller, and Eric Dallo all lead their projects with clarity and with gusto. You can feel how they really care about their products and their users. They are there. They listen. They respond. And they relentlessly keep improving their products.

    So we are there. We listen. We respond. And we keep trying to improve Calva.

    The Calva team cares deeply about the user experience. That is a major part of why we do this. When implementing a new feature, or changing a feature, Ux is always the first thing on our mind. Personally, to keep that direction I often start with the documentation of the feature. Reading the documentation before implementation reveals a lot about if the Ux design is within the ballpark or not.

    We have limited time on our hands, however, and we must cut some corners. We can't afford to spend very much time in Ux design. Rather we will use our Ux intuition, iterate the documentation quickly, and be fast to get things out. Then we are responsive in tweaking those things, based on user feedback. This also has impact on general quality at times. We only can do so much QA, and it happens that some releases of Calva cause disruptions in people's workflow because of things we haven't thought of, or not found during our testing. Again, we try to be attentive to feedback and quick to fix. Apologies in advance for any inconveniences caused!

    A super major part of our love for Ux is that Calva should be serving its users. That's why we treat feedback as a gift, listen intently, and use the feedback as a major ingredient in shaping Calva.

    Calva develops from user feedback in more direct ways as well. It is quite astonishing how many people have decided to improve on it by hacking it to do some small or big thing differently. That's great! We should make sure Calva is super easy to contribute to.

    There has been quite a lot of work put into improving the development process. Starting to hack on Calva is just a few steps, taking less than three minutes from cloning to running a dev version in the VS Code debugger. We encourage contributions, from the tiniest typo to whole new features. And we are ready to spend time helping people get their contributions integrated.

    However, Calva can't be what everyone wants it to be, that would make it useless. It needs direction and aim. And it is we, the Calva Team, who are the stewards. We need to be in charge of what Calva is about, and what it is not about.

    "},{"location":"tao/#the-road-ahead","title":"The Road Ahead","text":"

    Tying back to Stuart Halloway, I don't think he means that spartan needs to also mean poor. The products he helps to bring to the market tell another story. VS Code and Clojure brought together has the capacity to create something amazingly rich and luxurious. And I want Calva to tap into that potential.

    On the Calva journey we will allow ourselves to change our minds about how things work. Calva is not a library. Its an interface between Clojure and human beings. Human beings can adapt. And they will need to enjoy adapting in order to enjoy Calva. \ud83d\ude04

    By now it should be clear that you can expect Calva to keep evolving, keep being tended and maintained, and keep getting ever more enjoyable to use. Lately we have been improving Calva pretty rapidly. It would be great to keep it up like that, but I think it is good to expect a more humble and sustainable pace.

    Calva is still quite new. A bit like freshly distilled Calvados. It will need time in those oak barrels to develop its full bouquet of flavors. And time is what we will give it. Our time, our creativity, and our passion.

    "},{"location":"test-runner/","title":"Test Runner","text":"

    Calva provides commands that make running your Clojure tests easier.

    Note

    Since the test commands utilize cider-nrepl, they only work with Clojure, not ClojureScript. See this issue for more details.

    "},{"location":"test-runner/#test-commands","title":"Test Commands","text":"Command Shortcut Description Run All Tests ctrl+alt+c shift+t Runs all tests Run Failing Tests ctrl+alt+c ctrl+t Runs the tests that failed Run Tests for Current Namespace ctrl+alt+c t Runs the tests for the current namespace. If not a -test namespace, tests for the current namespace plus its corresponding <current-namespace>-test namespace will be run. Run Current Test ctrl+alt+c ctrl+alt+t Runs the test at the cursor. This includes a defn with a :test in its metadata, a defn defined in a with-test, and a deftest. Toggle between implementation and test - Switches the file between implementation and test, prompts to create a new file if not found."},{"location":"test-runner/#test-on-save","title":"Test on Save","text":"

    You can enable the Calva setting \"Test on Save\" to have tests for the current namespace run on file save.

    "},{"location":"test-runner/#vs-code-test-ui","title":"VS Code Test UI","text":"

    Calva has experimental support for showing test results in VS Code's Test UI. You can enable this support by setting calva.useTestExplorer to true. When you enable this setting, the Testing icon will appear in the Testing tab of VS Code's Activity Bar.

    With this feature enabled you will be able to browse and run tests directly from the Testing tab.

    Please join the #calva channel on the Clojurians Slack if you have any feedback on this new feature.

    "},{"location":"test-runner/#troubleshooting","title":"Troubleshooting","text":""},{"location":"test-runner/#tests-are-not-found","title":"Tests Are Not Found","text":"

    Calva will not load namespaces in the REPL that you haven't loaded. This is so that you can be in control of what is loaded in the REPL. However, it also means that commands like Run All tests actually mean Run All Tests That are Loaded in the REPL, since the test-runner only runs tests that it knows about, i.e. are loaded in the REPL. Some developers choose to make sure all test namespaces are loaded as part of starting their REPL. Others register a custom REPL command for loading test namepaces. (Yet others use test-runners such as Cognitect's test-runner, Kaocha, poly test, or some other that runner allows for tests being run automatically, separate from the REPL used for development.)

    If you have tests in a test directory separate from your source directory, and those tests are not being found by the test runner, make sure the test directory is included in your paths. This will not be the case by default with a tools.deps (deps.edn) project. If your project is a tools.deps project, you can create an alias in your deps.edn file with :extra-paths that includes \"test\" (or the name of your test directory).

    {:aliases {:dev {:extra-paths [\"test\"]}}}\n
    "},{"location":"test-runner/#changes-arent-taking-effect-when-running-tests","title":"Changes Aren't Taking Effect When Running Tests","text":"

    In order for changes in code to take effect, you need to load the file or evaluate the changed code before running a test command. Prior to version 2.0.301, Calva would load the file for you when running some test commands, but that behavior was removed in favor of leaving control to the user, and to avoid a potential issue.

    Having added the above to your deps.edn, when you jack-in, choose the :dev alias and the test directory will be added to your paths, which will allow tests located in the directory to be found by the test runner.

    "},{"location":"test-runner/#toggle-between-implementation-and-test-command-not-working-as-intended","title":"Toggle between implementation and test command not working as intended","text":"

    This feature mostly works with projects that has leiningen style folder structure and makes some assumption about your folder structure and test file names.

    If you are using any non leiningen style folder structure, you may have to add source paths inside .lsp/config.edn.

    "},{"location":"try-first/","title":"Something to Try First (After Connecting)","text":"

    You should start with loading the file you are working with. Do this with Load/Evaluate Current File and its Requires/Dependencies, ctrl+alt+c enter.

    To get a feeling for evaluating code in the editor and get immediate response from the REPL try this:

    (comment\n  (+ (* 2 2)\n      2)\n  (Math/abs -1)\n  (hello \"Calva REPL\")\n  (defn hello [s]\n    (str \"Hello \" s))\n  (range 10)\n  \"I \u2665\ufe0f Clojure\")\n

    Then:

    1. Place the cursor behind the form (* 2 2) and issue the command Calva: Evaluate Current Form, ctrl+enter.
      • You should see the result being displayed inline. Press esc to dismiss it.
    2. Now issue the command Evaluate Current Top Level Form (defun), alt+enter.
      • You should see the whole form (+ (* 2 2) 2) getting highlighted and the result of that expression being displayed inline.
    3. Evaluate each form inside the comment form using the Top Level command.
      • You should see each one of them evaluated.
      • Evaluating the (hello \"Calva REPL\") form before the (defn hello... form should result in an error/exception. A stacktrace is then printed in the output window
      • Try it again after having evaluated the defnform.

    Demo:

    "},{"location":"try-first/#how-does-this-work","title":"How does this work?","text":"

    Calva has this notion about the current form. Issue the Evaluate Current Form command, with the cursor placed in different locations to get a feeling for how the current form is determined.

    There is also a concept about the current top level form. Good for evaluating various defs defn, defthis, defthat. With your cursor placed anywhere inside such a form.

    The Top Level command also works inside (comment ...) forms, treating the comment as creating a new top level context. It is good for in-file code experimentation.

    "},{"location":"try-first/#see-also","title":"See also","text":""},{"location":"vim/","title":"Calva and the VIM Extension","text":"

    First thing first. The VIM Extension and Calva has a history of friction between them. Less so these days, but you might still encounter some rough edges. Please don't hesitate to reach out to the Calva team, as we might be able to fix things if only we are aware of them.

    "},{"location":"vim/#key-bindings","title":"Key bindings","text":"

    In general Calva's default key bindings are not very VI-ish.

    "},{"location":"vim/#expand-selection-on-mac","title":"Expand selection on Mac","text":"

    On Mac, Calva binds expand selection to ctrl+w. This conflicts with the VIM Extension's default mapping of window splitting shortcuts. You'll need to remap it either with Calva or with the VIM Extension.

    "},{"location":"vim/#the-esc-key","title":"The esc key","text":"

    While showing inline evaluation results, Calva binds the esc key to dismiss the display of inline results. If you want to be able to use the esc key to enter command mode while inline results are showing, you'll need to rebind Calva's command for dismissing the inline results.

    "},{"location":"vim/#remap-calvas-clearinlineresults","title":"Remap Calva's clearInlineResults","text":" 
    // Place your key bindings in this file to override the defaults\n[\n  {\n    \"key\": \"escape\",\n    \"command\": \"-calva.clearInlineResults\"\n  },\n  {\n    \"key\": \"shift+escape\",\n    \"command\": \"calva.clearInlineResults\",\n    \"when\": \"editorTextFocus && !editorHasMultipleSelections && !editorReadOnly && !hasOtherSuggestions && !suggestWidgetVisible && editorLangId == 'clojure'\"\n  }\n]\n

    If you run into issues, refer to the commands in the default Keyboard Shortcuts JSON file.

    "},{"location":"vim/#remap-vims-insert-mode","title":"Remap Vim's Insert Mode","text":"

    Remap vim's insert mode keybinding to go into command mode by adding the following to your user settings:

    \"vim.insertModeKeyBindings\": [\n    {\n        \"before\": [\"j\", \"k\"],\n        \"after\": [\"<esc>\"]\n    }\n]\n

    (Change before to whatever keybinding you are comfortable with!)

    "},{"location":"vim/#vim-fireplace-ish-keybindings","title":"Vim Fireplace-ish keybindings","text":"

    You can add these keybindings to your init.vim if you are using the VSCode Neovim extension. It is inspired by and tries to emulate the keybindings found in vim-fireplace which is the most popular vim plugin for Clojure.

    nmap cqp :call VSCodeNotify('calva.jackIn')<CR>\nnmap cqq :call VSCodeNotify('calva.disconnect')<CR>\nnmap cpr :call VSCodeNotify('calva.loadFile')<CR>\nnmap cpR :call VSCodeNotify('calva.loadNamespace')<CR>\nnmap cpp :call VSCodeNotify('calva.evaluateSelection')<CR>\nnmap cqc :call VSCodeNotify('calva.evalCurrentFormInREPLWindow')<CR>\n

    Unfortunately these key combinations will not work in the normal VIM extension as c is an operator key and cannot be remapped. This is a call for someone to share their VIM re-mappings.

    "},{"location":"when-clauses/","title":"Calva When Clause Contexts","text":"

    When clause contexts is a powerful customization mechanism in VS Code. The most common use for end users is with keyboard shortcut bindings. Extensions can provide their own. The following contexts are available with Calva:

    "},{"location":"why-calva/","title":"Why Calva?","text":"

    The main reason you would choose Calva for your Clojure and/or ClojureScript coding is that you want to use Visual Studio Code. Calva provides VS Code users with a comprehensive set of features to keep you productive and make it easy to follow Clojure coding best practices. This also means that if your choice of editor is not made yet, we think you should give VS Code and Calva a try.

    While Calva is a good choice for professional and experienced Clojure developers, great care has been taken in making Calva a really good choice for beginners of Clojure as well.

    We who make Calva are actively stewarding, maintaining, documenting and supporting it. We are also very active Clojure (and Calva) users, participating in the community. Clojure is dear to us, a lot because it keeps programming fun and rewarding.

    Calva has very happy users! Check out the Programming Languages section on the Visual Studio Code Marketplace, sorted by rating:

    Recently there was a thread over at ClojureVerse, asking about how Calva Compares to Emacs with CIDER. It is well worth reading. We would like to highlight the answer by Nick Cernis, which focuses on Calva. We'll even quote parts of it. \ud83d\ude0d

    "},{"location":"why-calva/#nick-cernis-on-clojureverse","title":"Nick Cernis on ClojureVerse","text":"

    My advice to anyone starting their Clojure journey who is unsure about what editor to use:

    I now use VS Code with Calva every day but went through a long journey trying almost every other editor and plugin combo first. I switched from Emacs to VS Code, which might make my perspective different to others here.

    \u2026

    I started with the jaded assumption that VS Code was probably bad because it's built by committee at Microsoft on a web-tech based Electron stack, only to find that it succeeds in embodying the spirit of a \u201chacker's editor\u201d more than even Emacs does in many ways:

    \u2026

    On the benefits of Calva:

    "},{"location":"why-calva/#100-five-star-marketplace-reviews","title":"100% Five-star Marketplace Reviews","text":"

    We are super proud of the Calva reviews on the Visual Studio Code Marketplace. Please read them all. \ud83d\ude04 Here's a selection that we think captures what we focus on in when developing Calva:

    \u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f Calva has become an essential part of my Clojure workflow.

    It's an incredible piece of work by the team behind it.

    Sean Corfield

    \u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f Calva hits the sweet spot of being both approachable for new users and powerful for seasoned ones.

    The creators/maintainers are fantastic individuals that care deeply about streamlining the user experience, and it shows.

    Good stuff, check it out.

    Clay Hopperdietzel

    \u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f I switched from IntelliJ / Cursive to VS Code and Calva and it's been amazing.

    ...

    That is the biggest thing I can say for Calva, it just works. I was never a fan of VS Code before, but VS Code + Calva for Clojure is now my favorite language / IDE experience.

    Plus, the #calva on the clojurians slack is brilliant, always someone there to help if you have issues (although any issue I've had has been squarely on me, and never Calva itself).

    I often feel we live in an age where so much software is badly written, without care, slow, buggy and just generally awful. Calva is the complete opposite. I think the maintainers want to, and have, made a wonderful piece of software for Clojure developers.

    Stuart Stein

    \u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f This is great, and makes VS Code a truly viable IDE/editor for clojure development.

    It already has great REPL support (including inline evaluation), an extensive Paredit implementation, and excellent linting (care of the bundled clj-kondo). Calva is being improved on at an impressive clip by maintainers who appear solidly committed to its ongoing development. It's well-documented, and manages to be both approachable and capable.

    A no-brainer if you're already a VS Code user, and well worth a look if you're not.

    Crispin Bennett

    \u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f I'm using Calva now for a few months and I'm loving it.

    I joined the Slack channel about 2 wks ago and I must say that I'm very impressed by how active and responsive this community is. Already 2 of my issues fixed and I really like Calva (and the extensions it uses!).

    These are professional people and they make me very happy!

    Uitbeijerse, E (Eric)

    "},{"location":"workspace-layouts/","title":"Workspace Layouts","text":"

    Project directory layouts can vary quite a lot. From the \u201dtemplate\u201d projects where the Clojure project files are at the root, to, well, let's just say that the project files are not always at the root. And sometimes there is more than one project (read here how to get clojure-lsp support with a Leiningen project in a subfolder).

    Calva only really supports working with one project at a time per VS Code window. Here's a short guide for some different setups:

    1. You have one project in the workspace, the project files are in there somewhere.
      • Use a regular VS Code \u201dfolder window\u201d or a Workspace proper, both will totally work.
    2. You have more than one project in the repository, but only really work with one at a tine.
      • Use a Workspace proper and add the different project directories as separate Workspace Folders.
      • You can only jack-in/connect to one project at a time.
    3. You have more than one project in the repository, and need to work with them in parallell.
      • Open each project you want to work with in a separate VS Code window.
    "},{"location":"workspace-layouts/#one-folder-two-windows","title":"One Folder - Two Windows?","text":"

    As is mentioned in the Calva Jack-In Guide, if you have a full stack project using a Clojure backend and a shadow-cljs frontend, you will need to open the same project in two separate VS Code windows, one for the backend and one for the frontend. This is how you can do that:

    1. Open a new VS Code window.
    2. Select File->Add Folder to Workspace.... Save the workspace as, say, Server.code-workspace.
    3. Open a new VS Code window.
    4. Select File->Add Folder to Workspace.... Save the workspace as, say, Client.code-workspace.

    Now, whenever you want to Jack-in to the backend and/or frontend, do it from the Server and/or Client workspace, respectively.

    "},{"location":"wsl/","title":"Calva \u2764\ufe0f WSL","text":"

    The use of Calva with WSL (Windows Subsystem for Linux) is fully supported through the Remote - WSL extension. Simply install the extension and open your project with one of the Remote-WSL commands. Calva will run directly in the WSL environment and no further configuration is required.

    "},{"location":"wsl/#steps-involved","title":"Steps Involved","text":"
    1. Enable WSL
    2. Install Ubuntu in WSL
    3. Install Java in WSL
    4. Install latest Clojure in WSL
    5. Install the Remote - WSL extension in VS Code
    6. Launch remote window
    7. Install Calva (gets installed into the WSL instance)
    8. Work away

    See also Remote Development.

    "}]} \ No newline at end of file +{"config":{"lang":["en"],"separator":"[\\s\\-\\._]","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Welcome!","text":"

    Calva is an integrated, REPL powered, development environment for enjoyable and productive Clojure and ClojureScript programming in Visual Studio Code. It is feature rich and turnkey. A lot of effort has been put into making Calva a good choice if you are new to Clojure. Calva is open source and free to use.

    "},{"location":"#getting-started","title":"Getting Started","text":"

    Let's start a REPL!. \ud83d\ude80 Also see Get Started with Clojure

    "},{"location":"#how-to-contribute-to-calva","title":"How to Contribute to Calva?","text":"

    I'm glad you asked! Please see How to Contribute and The Tao of Calva

    "},{"location":"#calva-patrons","title":"Calva Patrons","text":"The right kind of different"},{"location":"#calva-gold-sponsors","title":"Calva Gold Sponsors \u2665\ufe0f","text":"Scale your growth on mobile MAKE. DO. SHIP.

    Please see this statement from Cognitect about the importance of supporting open source developers.

    See Sponsors for information about sponsoring Calva.

    If your Company benefits from Calva's existence and you see it as an important in the Clojure and ClojureScript ecosystem. please consider sponsoring!

    "},{"location":"#features","title":"Features","text":"

    Calva includes inline code evaluation, structural editing, code formatting, code navigation, a debugger, linting, syntax highlighting, Clojure aware rainbow brackets, a test runner, refactoring support, and more.

    "},{"location":"#have-questions-and-feedback-need-help","title":"Have Questions and Feedback? Need Help?","text":"

    Easiest way is to chat with us and other Calva users. Please join the #calva channel on the Clojurians Slack. If you haven't joined that slack workspace, you can get an invite here.

    If you're a beginner to Clojure(Script), the #beginners channel of the Clojurians Slack is very active and helpful.

    "},{"location":"#please-star-the-calva-repo","title":"Please star the Calva repo!","text":"

    Happy coding!

    "},{"location":"api/","title":"The Calva Extension API","text":"

    Calva exposes an API for use from other VS Code extensions (such as Joyride). The API is in an experimental state, while we are figuring out what is a good shape for this API. It is also rather small, and will grow to expose more of Calva's functionality.

    ","boost":7},{"location":"api/#accessing","title":"Accessing","text":"

    To access the API the Calva extension needs to be activated. The API is exposed under the v1 key on the extension's exports, and split up into submodules, like repl, and ranges.

    When using Joyride you can use its unique require API, for which one of the benefits is better lookup IDE support. When using the API from regular ClojureScript, you'll pick it up from the Calva extension instance. (Which you can do from Joyride as well, but why would you?). Here is how you access the API, with an example of usage as a bonus:

    JoyrideClojureScriptJavaScript 
    (ns ... (:require [\"ext://betterthantomorrow.calva$v1\" :as calva]))\n;; OR\n(require '[\"ext://betterthantomorrow.calva$v1\" :as calva])\n\n(calva/repl.currentSessionKey) => \"cljs\" ; or \"clj\", depending\n
    (def calvaExt (vscode/extensions.getExtension \"betterthantomorrow.calva\"))\n\n(def calva (-> calvaExt\n             .-exports\n             .-v1\n             (js->clj :keywordize-keys true)))\n\n((get-in calva [:repl :currentSessionKey])) => \"cljs\" ; or \"clj\", depending\n
    const calvaExt = vscode.extensions.getExtension(\"betterthantomorrow.calva\");\n\nconst calva = calvaExt.exports.v1;\n\nconst sessionKey = calva.repl.currentSessionKey()\n
    ","boost":7},{"location":"api/#repl","title":"repl","text":"

    The repl module provides access to Calva's REPL connection.

    ","boost":7},{"location":"api/#replcurrentsessionkey","title":"repl.currentSessionKey()","text":"

    Use repl.currentSessionKey() find out which REPL/session Calva's REPL is currently connected to (depends on the active file). Returns either \"clj\", or \"cljs\", or nil if no REPL is connected.

    JoyrideClojureScriptJavaScript 
    (def session-key (calva/repl.currentSessionKey))\n
    (def session-key ((get-in [:repl :currentSessionKey] calvaApi)))\n
    const sessionKey = calva.repl.currentSessionKey()\n
    ","boost":7},{"location":"api/#replevaluatecode","title":"repl.evaluateCode()","text":"

    This function lets you evaluate Clojure code through Calva's nREPL connection. Calling it returns a promise that resolves to a Result object. It's signature looks like so (TypeScript):

    export async function evaluateCode(\n  sessionKey: 'clj' | 'cljs' | 'cljc' | undefined,\n  code: string,\n  ns = 'user',\n  output?: {\n    stdout: (m: string) => void;\n    stderr: (m: string) => void;\n  },\n  opts = {}\n): Promise<Result>;\n

    Where Result is:

    type Result = {\n  result: string;\n  ns: string;\n  output: string;\n  errorOutput: string;\n};\n

    As you can see, the required arguments to the function are sessionKey and code. sessionKey should be \"clj\", \"cljs\", \"cljc\", or undefined depending on which of Calva's REPL sessions/connections that should be used. It will depend on your project, and how you connect to it, which session keys are valid. Use cljc to request whatever REPL session \"cljc\" files are connected to. Use undefined to use the current REPL connection Calva would use (depends on which file is active).

    An example:

    JoyrideClojureScriptJavaScript 
    (-> (p/let [evaluation (calva/repl.evaluateCode \"clj\" \"(+ 2 40)\")]\n      (println (.-result evaluation)))\n    (p/catch (fn [e]\n               (println \"Evaluation error:\" e))))\n
    (def evaluate (get-in [:repl :evaluateCode] calvaApi))\n(-> (p/let [evaluation (evaluate \"clj\" \"(+ 2 40)\")]\n      (println (.-result evaluation)))\n    (p/catch (fn [e]\n               (println \"Evaluation error:\" e))))\n
    try {\n  const evaluation = await calvaApi.repl.evaluateCode(\"clj\", \"(+ 2 40)\");\n  console.log(evaluation.result);\n} catch (e) {\n  console.error(\"Evaluation error:\", e);\n}\n
    ","boost":7},{"location":"api/#handling-output","title":"Handling Output","text":"

    The output member on the Result object will have any output produced during evaluation. (The errorOutput member should contain error output produced, but currently some Calva bug makes this not work.) By default the stdout and stderr output is not printed anywhere.

    If you want to do something with either regular output or error output during, or after, evaluation, you'll need to provide the output argument to evaluateCode(). (The stderr callback function works, so this is the only way to get at any error output, until the above mentioned Calva bug is fixed.)

    An example:

    JoyrideClojureScriptJavaScript 
    (def oc (joyride.core/output-channel)) ;; Assuming Joyride is used\n(def evaluate (fn [code]\n                (calva/repl.evaluateCode\n                 \"clj\"\n                 code\n                 \"user\"\n                 #js {:stdout #(.append oc %)\n                      :stderr #(.append oc (str \"Error: \" %))})))\n\n(-> (p/let [evaluation (evaluate \"(println :foo) (+ 2 40)\")]\n      (.appendLine oc (str \"=> \" (.-result evaluation))))\n    (p/catch (fn [e]\n               (.appendLine oc (str \"Evaluation error: \" e)))))\n
    (def oc (joyride.core/output-channel)) ;; Assuming Joyride is used\n(def evaluate (fn [code]\n                ((get-in [:repl :evaluateCode] calvaApi)\n                 \"clj\"\n                 code\n                 \"user\"\n                 #js {:stdout #(.append oc %)\n                      :stderr #(.append oc (str \"Error: \" %))})))\n\n(-> (p/let [evaluation (evaluate \"(println :foo) (+ 2 40)\")]\n      (.appendLine oc (str \"=> \" (.-result evaluation))))\n    (p/catch (fn [e]\n               (.appendLine oc (str \"Evaluation error: \" e)))))\n
    const evaluate = (code) =>\n  calvaApi.repl.evaluateCode(\"clj\", code, \"user\", {\n    stdout: (s) => {\n      console.log(s);\n    },\n    stderr: (s) => {\n      console.error(s);\n    },\n  });\n\ntry {\n  const evaluation = await evaluate(\"(println :foo) (+ 2 40)\");\n  console.log(\"=>\", evaluation.result);\n} catch (e) {\n  console.error(\"Evaluation error:\", e);\n}\n
    ","boost":7},{"location":"api/#ranges","title":"ranges","text":"

    The ranges module contains functions for retreiving vscode.Ranges and text for pieces of interest in a Clojure document.

    All functions in this module have the following TypeScript signature:

    (editor = vscode.window.activeTextEditor, position = editor?.selection?.active) => [vscode.Range, string];\n

    I.e. they expect a vscode.TextEditor \u2013 defaulting to the currently active editor \u2013 and a vscode.Position \u2013 defaulting to the current active position in the editor (or the first active position if multiple selections/positions exist, and will return a tuple with the range, and the text for the piece of interest requested.

    Custom REPL Commands

    The ranges function have corresponding REPL Snippets/Commands substitution variables. It is the same implementation functions used in both cases.

    The functions available are:

    ","boost":7},{"location":"api/#rangescurrentform","title":"ranges.currentForm()","text":"

    Retrieves information about the current form, as determined from the editor and position.

    Corresponding REPL Snippet variable: $current-form.

    See also about Calva's Current Form on YouTube.

    ","boost":7},{"location":"api/#rangescurrentenclosingform","title":"ranges.currentEnclosingForm()","text":"

    The list/vector/etcetera form comtaining the current form.

    Corresponding REPL Snippet variable: $enclosing-form.

    ","boost":7},{"location":"api/#rangescurrenttoplevelform","title":"ranges.currentTopLevelForm()","text":"

    The current top level form. Outside (comment ...) (Rich comments) forms this is most often ((def ...), (defgn ...), etcetera. Inside Rich comments it will be the current immediate child to the (comment ...) form.

    Corresponding REPL Snippet variable: $top-level-form.

    ","boost":7},{"location":"api/#rangescurrentfunction","title":"ranges.currentFunction()","text":"

    The current function, i.e. the form in \u201dcall position\u201d of the closest enclosing list.

    Corresponding REPL Snippet variable: $current-fn.

    ","boost":7},{"location":"api/#rangescurrenttopleveldef","title":"ranges.currentTopLevelDef()","text":"

    The symbol being defined by the current top level form. NB: Will stupidly assume it is the second form. I.e. it does not check that it is an actual definition, and will often return nonsense if used in Rich comments.

    Corresponding REPL Snippet variable: $top-level-defined-symbol.

    ","boost":7},{"location":"api/#example-rangescurrenttoplevelform","title":"Example: ranges.currentTopLevelForm()","text":"JoyrideClojureScriptJavaScript 
    (let [[range text] (calva/ranges.currentTopLevelForm)]\n  ...)\n
    (let [[range text] ((get-in [:ranges :currentTopLevelForm]))]\n  ...)\n
    const [range, text] = ranges.currentTopLevelForm();\n
    ","boost":7},{"location":"api/#editor","title":"editor","text":"

    The editor module has facilites (well, a facility, so far) for editing Clojure documents.

    ","boost":7},{"location":"api/#editorreplace","title":"editor.replace()","text":"

    With editor.replace() you can replace a range in a Clojure editor with new text. The arguments are:

    JoyrideJavaScript 
    (-> (p/let [top-level-form-range (first (calva/ranges.currentTopLevelForm))\n            _ (calva/editor.replace vscode/window.activeTextEditor top-level-form-range \"Some new text\")]\n      (println \"Text replaced!\"))\n    (p/catch (fn [e]\n               (println \"Error replacing text:\" e))))\n
    const topLevelRange = calvaApi.ranges.currentTopLevelForm();\ncalva.editor.replace(topLevelRange, \"Some new text\")\n  .then((_) => console.log(\"Text replaced!\"))\n  .catch((e) => console.log(\"Error replacing text:\", e));\n
    ","boost":7},{"location":"api/#document","title":"document","text":"

    The document module provides access to the Clojure/Calva aspects of VS Code TextDocuments.

    ","boost":7},{"location":"api/#documentgetnamespacedocument-vscodetextdocument-string","title":"document.getNamespace(document?: vscode.TextDocument): string","text":"

    document.getNamespace() returns the namespace of a document.

    Example usage. To evaluate some code in the namespace of the current document:

    JoyrideJavaScript 
    (calva/repl.evaluateCode \"clj\" \"(+ 1 2 39)\" (calva/document.getNamespace))\n
    calva.repl.evaluateCode(\"clj\",  \"(+ 1 2 39)\", calva.document.getNamespace());\n
    ","boost":7},{"location":"api/#documentgetnamespaceandnsformdocument-vscodetextdocument-ns-string-nsform-string","title":"document.getNamespaceAndNsForm(document?: vscode.TextDocument): [ns: string, nsForm: string]","text":"

    document.getNamespaceAndNsForm() returns the namespace and the ns form of a document as a tuple.

    Example usage. To evaluate the ns form of the current document:

    JoyrideJavaScript 
    (calva/repl.evaluateCode \"clj\" (second (calva/document.getNamespaceAndNsForm)))\n
    calva.repl.evaluateCode(\"clj\", calva.document.getNamespaceAndNsForm()[1]);\n
    ","boost":7},{"location":"api/#pprint","title":"pprint","text":"

    The pprint module lets you pretty print Clojure code/data using Calva's pretty printing engine (which in turn uses zprint).

    ","boost":7},{"location":"api/#pprintprettyprint","title":"pprint.prettyPrint()","text":"

    Use pprint.prettyPrint() to pretty print some Clojure data using your Calva pretty printing options. It accepts these arguments:

    The function is synchronous and returns the prettified text.

    JoyrideJavaScript 
    (println (calva/pprint.prettyPrint \"Some text\")))\n
    console.log(calvaApi.pprint.prettyPrint();\n
    ","boost":7},{"location":"api/#pprintprettyprintingoptions","title":"pprint.prettyPrintingOptions()","text":"

    Use to get the current pretty printint options:

    ","boost":7},{"location":"api/#vscode","title":"vscode","text":"

    In the its vscode submodule, Calva exposes access to things from its own vscode module instance. It gets important in some situations.

    ","boost":7},{"location":"api/#vscoderegisterdocumentsymbolprovider","title":"vscode.registerDocumentSymbolProvider()","text":"

    This is the [vscode.languages](https://code.visualstudio.com/api/references/vscode-api#languages).registerDocumentSymbolProvider() function from the Calva extension. Use it if you want to provide symbols for Clojure files together with the ones that Calva provides. (If you use the vscode.languages.registerDocumentSymbolProvider() function from your extension (or Joyride) you will provide a separate group.)

    JoyrideClojureScriptJavaScript 
    (-> (joyride/extension-context)\n  .-subscriptions\n  (.push (calva/vscode.registerDocumentSymbolProvider ...)))\n
    (-> yourExtensionContext\n  .-subscriptions\n  (.push ((get-in calva [:vscode :registerDocumentSymbolProvider]) ...)))\n
    yourExtensionContext.subscriptions.push(calva.vscode.registerDocumentSymbolProvider(...));\n

    Deprecation candidate

    VS Code is still creating a separate group, just with the same name as Calva's, so this API is not good for anything, and we will probably remove it.

    ","boost":7},{"location":"api/#feedback-welcome","title":"Feedback Welcome","text":"

    Please let us know how you fare using this API. Either in the #calva or #joyride channels on Slack or via the issues/discussions sections on the repositories. (Whichever seems to apply best.)

    ","boost":7},{"location":"async-out/","title":"Viewing Async Output While Working On Node Projects with shadow-cljs","text":"

    When working on NodeJS projects with shadow-cljs and Calva, async output does not always appear in the Calva output window. To work around this problem, follow these steps:

    1. Run the command \"Calva: Copy Jack-in Command Line to Clipboard\", then paste the command in a terminal and run it.
    2. Wait for the message shadow-cljs - nREPL server started on port <some-port>
    3. Issue the command Calva: Connect to a running REPL server in your project, ctrl+alt+c ctrl+alt+c. For project type select shadow-cljs, accept the proposed localhost:<some-port>, and for build select node-repl.
    4. Load a file from your project with the command ctrl+alt+c Enter. Evaluating forms in Calva will show results in the output window. Synchronous stdout output will be printed in both the output window and in the terminal where you started the repl. Some asynchronous output may show up in the output window, but all will appear in the terminal.

    If you use an integrated VSCode terminal to start shadow-cljs, all stdout will appear in the Calva window with your code. Alternatively, you can use an external terminal, which is especially nice when using a second monitor.

    For a discussion of this problem and other connection options, see issue #1468.

    "},{"location":"babashka/","title":"Using Calva with Babashka","text":"

    Since Babashka can be started such that it is an nREPL server, Calva can connect to it and a lot of the features will work.

    Calva can also start Babashka and connect its REPL for you, using the Jack-in command.

    Don't expect complete support

    Babashka's nREPL server is still a bit limited compared to a full cider-nrepl enhanced \"regular\" Clojure nREPL server. Things like function signatures, and more do not work.

    This might of course improve in the future, especially if you provide some PRs towards the Babashka nREPL.

    ","boost":5},{"location":"clj-java-decompiler/","title":"Decompiling and disassembly made easy","text":"

    If you need some piece of Clojure code to execute as fast as possible you will often benefit from examining the code generated by the Clojure compiler from your code. There is a really easy to use tool for that: clj-java-decompiler. You can make the use of this tool super convenient with Calva custom command snippets.

    "},{"location":"clj-java-decompiler/#prerequisites","title":"Prerequisites","text":"

    Add com.clojure-goes-fast/clj-java-decompiler as a dependency to the project.

    "},{"location":"clj-java-decompiler/#the-custom-snippets","title":"The custom snippets","text":"

    You can add some Calva custom commands configuration to be able to decompile or disassemble any Clojure code in your editor with a keyboard shortcut. Here's an example configuration:

        \"calva.customREPLCommandSnippets\": [\n        {\n            \"name\": \"Decompile current top level form\",\n            \"key\": \"d\",\n            \"snippet\": \"(require '[clj-java-decompiler.core :refer [decompile]]) (spit \\\"decompiled-$top-level-defined-symbol.java\\\" (with-out-str (decompile $top-level-form)))\"\n        },\n        {\n            \"name\": \"Decompile current form\",\n            \"snippet\": \"(require '[clj-java-decompiler.core :refer [decompile]]) (spit \\\"decompiled.java\\\" (with-out-str (decompile $current-form)))\"\n        },\n        {\n            \"name\": \"Disassemble current top level form\",\n            \"key\": \"b\",\n            \"snippet\": \"(require '[clj-java-decompiler.core :refer [disassemble]]) (spit \\\"bytecode-$top-level-defined-symbol.class\\\" (with-out-str (disassemble $top-level-form)))\"\n        },\n        {\n            \"name\": \"Disassemble current current form\",\n            \"snippet\": \"(require '[clj-java-decompiler.core :refer [disassemble]]) (spit \\\"bytecode.class\\\" (with-out-str (disassemble $current-form)))\"\n        }\n    ],\n

    Now, with the cursor anywhere in a top level defined function, you can spit out a file with the Java code generated for that function by pressing ctrl+alt+space d. For the byte code, press ctrl+alt+space b. The files will be generated in the same folder as the Clojure file and be named decompiled-<function name>.java and bytecode-<function name>.class, respectively.

    To decompile or disassemble the current form (or selection) press ctrl+alt+space space and pick the desired command from the quick pick menu that pops up. You can add key to these too if you want even quicker access, of course. The filenames for the results will here be named without any function name suffix, because there is often no function name that can be used.

    See this video for a demo.

    "},{"location":"clojure-lsp/","title":"Clojure-lsp","text":"

    Calva uses a mix of static and dynamic analysis to power the experience. A lot of the static abilities come from clojure-lsp. This enables you to check something up in a project, with a lot of navigational and contextual support, without starting a REPL for it. (And once you do start a REPL you'll get even more capabilities, enabled by the dynamic analysis.)

    Which clojure-lsp does Calva use?

    Calva defaults to using the latest clojure-lsp released. To use a different version of clojure-lsp, see the configuration section. Calva does not use the clojure-lsp installed on your system, unless you set the path for clojure-lsp to the installed binary in your settings. You can see what version is being used by running the Clojure-lsp Server Info command, which will also show the version of clj-kondo that's being used as well as other info.

    "},{"location":"clojure-lsp/#the-lsp-server-lifecycle","title":"The LSP server lifecycle","text":"

    By default you won't need to install/setup anything as Calva handles that for you by automatically downloading the latest clojure-lsp binary. It can take a while for clojure-lsp to start, especially the first time opening a new project, as clojure-lsp (via clj-kondo) indexes the project files.

    Calva is able to automatically start the clojure-lsp server for you and can be configured to start the server under various different conditions. These behaviours can be configured through the calva.enableClojureLspOnStart setting, which takes the following options:

    "},{"location":"clojure-lsp/#always-use-first-workspace-root-default","title":"\"always-use-first-workspace-root\" [default]","text":"

    When set to \"always-use-first-workspace-root\" Calva will attempt to start the clojure-lsp in the root of the first workspace folder if it is a valid clojure project. If it is not a valid clojure project it will fall back to starting the fallback server.

    This is the default auto-start behaviour.

    "},{"location":"clojure-lsp/#when-workspace-opened-use-workspace-root","title":"\"when-workspace-opened-use-workspace-root\"","text":"

    When set to \"when-workspace-opened-use-workspace-root\" Calva will start the clojure-lsp in the root of all opened vscode workspaces. All Clojure files in a workspace will be serviced by the clojure-lsp server running in that workspace. This behavior requires that you are opening workspaces with a valid Clojure project in the root (the directory must contain a deps.edn, project.clj or shadow-cljs.edn file).

    "},{"location":"clojure-lsp/#when-file-opened-use-furthest-project","title":"\"when-file-opened-use-furthest-project\"","text":"

    When set to \"when-file-opened-use-furthest-project\" Calva will attempt to start the clojure-lsp server whenever a Clojure file is opened. The LSP server will be started in the outermost valid Clojure project or will fall back to starting in the workspace root if no valid Clojure project can be found. A directory is considered a Clojure project if it contains typical Clojure project files such as a deps.edn, project.clj, or shadow-cljs.edn file. When working in a mono-repo style project or in a multi-workspace VS Code configuration you may have multiple LSP servers running, one for each independent Clojure project opened.

    Opening files that do not belong to a workspace folder

    When opening files that do not belong to any of the workspace folders currently open then Calva will fallback to starting the fallback clojure-lsp server

    "},{"location":"clojure-lsp/#never","title":"\"never\"","text":"

    When set to \"never\" Calva will never attempt to automatically start the clojure-lsp server. In this case you are responsible for manually starting the server. More advanced users might want to do this in order to have more control over which projects have a clojure-lsp server running for them. To manually start the clojure-lsp server you can run the calva.clojureLsp.start or the calva.clojureLsp.manage command and pick the project root. You can also click the clojure-lsp status bar icon to open the Management Menu.

    Additionally Calva has commands for:

    Note that the download command will download the configured clojure-lsp version regardless if it is already installed or not. This can be useful when some earlier download has failed resulting in that clojure-lsp can't be started. NB: It will not download anything if calva.clojureLspPath is set to something non-blank.

    "},{"location":"clojure-lsp/#fallback-server","title":"Fallback Server","text":"

    As a fallback behaviour Calva may start a clojure-lsp server in a temporary directory and use this to service lsp requests for clojure files that do not belong to a valid clojure project. This will show up in the management menu looking something like:

    Any files that are handled by this server will have limited classpath analysis and lsp features. It is therefore recommended to setup your project as a clojure project (by creating a deps.edn file in the root, for example).

    "},{"location":"clojure-lsp/#status-bar","title":"Status bar","text":"

    In the status bar Calva will show an indicator with the clojure-lsp status. This status will track the currently open project, showing the status (stopped, starting or active) for the relevant clojure-lsp server.

    You can click on the status-bar item to open the clojure-lsp management menu which will look as follows:

    The menu shows which clojure-lsp servers are active and which are stopped. Selecting a project will allow you to start/stop/restart the server for that project.

    "},{"location":"clojure-lsp/#ignoring-lsp-cache-files","title":"Ignoring LSP cache files","text":"

    Clojure-lsp stores its project analysis information in your project. Git users can add these lines to their project root directory .gitignore:

    .lsp/.cache/\n.lsp/sqlite.*.db\n
    "},{"location":"clojure-lsp/#configuration","title":"Configuration","text":"

    For information about how to configure clojure-lsp, see the settings page of the clojure-lsp docs.

    "},{"location":"clojure-lsp/#changing-the-version-of-clojure-lsp-used-by-calva","title":"Changing the Version of Clojure-lsp Used by Calva","text":"

    By default, Calva will use the latest released clojure-lsp. You can change the version of clojure-lsp used by Calva by setting the calva.clojureLspVersion property to a version of clojure-lsp found in its GitHub releases. This can be helpful if you're debugging an issue with clojure-lsp or you want to try out a feature of a new release that Calva does not yet use. However, you must remember to reset this setting in order for Calva to automatically use newer versions of clojure-lsp that are released with new versions of Calva.

    Example:

    \"calva.clojureLspVersion\": \"2021.04.07-16.34.10\"\n

    Special \u201dversion\u201d values

    Apart from the actual versions you can use two special values for this setting:

    "},{"location":"clojure-lsp/#using-a-custom-clojure-lsp","title":"Using a Custom Clojure-lsp","text":"

    You can set a path to a custom clojure-lsp to be used by Calva by configuring the calva.clojureLspPath setting. This should be an absolute path to a native binary or JAR file.

    Example:

    \"calva.clojureLspPath\": \"/usr/local/bin/clojure-lsp\"\n

    Will override any calva.clojureLspVersion setting

    When calva.clojureLspPath is set, the binary at the path will be used uncoditionally, and the calva.clojureLspVersion setting will be ignored.

    "},{"location":"clojure-lsp/#extra-commands","title":"Extra commands","text":"

    clojure-lsp provides many useful [commands], and Calva has configuration for most of them. The clojure-lsp team works fast and sometimes Calva might miss some command. And Calva's configuration only really work for clojure-lsp commands that take no argument, or where it makes sense to prompt for the argument. Therefore Calva provides a generic command id, clojure-lsp.command which can be used with keyboard shortcuts and that allow for providing arguments that way. (The command can be used from Joyride too, of course.)

    When using the command, provide the args as an tuple of [command-name, arguments], where arguments is an array of any arguments after file-uri, row, col which are common for all clojure-lsp extra commands and are provided automatically by Calva, based on active text editor and where the cursor is. It can look like so when binding a shortcut for extract-function:

        {\n        \"key\": \"ctrl+alt+r f\",\n        \"command\": \"clojure-lsp.command\",\n        \"args\": [\"extract-function\", [\"new-function\"]]\n    },\n

    Note that even though extract-function takes only one argument, you should still provide it via an array.

    "},{"location":"clojure-lsp/#troubleshooting","title":"Troubleshooting","text":""},{"location":"clojure-lsp/#viewing-the-logs-between-the-client-and-server","title":"Viewing the Logs Between the Client and Server","text":"

    If something doesn't seem to be working correctly, and you suspect the issue is related to clojure-lsp, a good place to start investigating is the request and response logs between the LSP client and server. In your settings, set clojure.trace.server to verbose, then in the VS Code output tab, select the Clojure Language Client output channel.

    It may be helpful to clear the output channel, then perform the action with which you're experiencing a problem, then read through the log for clues or paste the logs into a related issue in the Calva repo.

    "},{"location":"clojure-lsp/#server-info-command","title":"Server Info Command","text":"

    You can run the Clojure-lsp Server Info command to get information about the running clojure-lsp server, such as the version the server being used, the version of clj-kondo it's using, and more. This info is printed to the \"Calva says\" output channel.

    "},{"location":"clojure-lsp/#opening-the-server-log-file","title":"Opening the Server Log File","text":"

    You can open the clojure-lsp log file by running the command Calva Diagnostics: Open Clojure-lsp Log File. The log file will only be opened with this command if the clojure-lsp server is running and has finished initializing. If you need to open the file when the server is failing to run or initialize, see the clojure-lsp docs for information on the file location.

    "},{"location":"clojure-lsp/#server-initialization-failed","title":"Server initialization failed","text":"

    If clojure-lsp fails to start with \u201cServer initialization failed\u201d messages, it could be because the path to your project contains non-ASCII characters, or that the system PATH variable has been corrupted. (Or something else, of course.)

    See this issue for some findings about it: Issue #2251: Server initialization failed error

    "},{"location":"clojure-lsp/#related","title":"Related","text":"

    See also:

    "},{"location":"clojuredart/","title":"Using Calva with ClojureDart","text":"

    Since ClojureDart is Clojure, Calva just works with it. Calva is also automatically configured to make VS COde treat .cljd files as a Clojure code.

    ","boost":4},{"location":"clojuredart/#dart-clojure-conversion","title":"Dart->Clojure Conversion","text":"

    Similar to when using ClojureScript you will often find examples for Dart and Flutter written in, you guessed it, Dart. And then you will often wish there was a converter, because manually transpiling can be a bit tedious and error prone. Luckily you are in the Clojure community, and such a converter is provided:

    There are several ways you can leverage this converter, and since you are using Calva, a very convenient way is available. There is a command Calva: Convert Dart code to Clojure/ClojureDart. This command takes whatever text is selected and uses DartClojure to convert it. Lacking a selection, the command will use the whole file.

    The workflow demoed in the video is something like so:

    1. Open a new untitled file/tab
    2. Paste your Dart/Flutter code in this file (VS Code will probably automatically figure out that it is Dart code, even if that doesn't matter for the converter.)
    3. Run Calva: Convert Dart code to Clojure/ClojureDart
    4. An, untitled, Clojure tab will open with the converted code in it.

    NB: The conversion will not always work. DartCLojure is work in progress. See the project repo for limitations and scope. Often when conversion, the error message will give you a clue to what is problematic. Try adjust your code selection and you will probably be able to get at least some help from the converter.

    Speaking of WIP...

    ","boost":4},{"location":"clojuredart/#work-in-progress","title":"Work in Progress","text":"

    ClojureDart is very new and being super actively developed. Some feature are still missing. Like a REPL. Once that is added we will also add ClojureDart jack-in and connect support to Calva.

    ","boost":4},{"location":"clojuredart/#happy-clojuredart-hacking","title":"Happy ClojureDart Hacking!","text":"

    Please feel welcome to the #clojuredart and #calva channel at the Clojurians Slack for questions, suggestions and support.

    ","boost":4},{"location":"clojuredocs/","title":"ClojureDocs integration","text":"

    clojuredocs.org is the goto place #1 for finding out more about Clojure core(-ish) functions, macros, etcetera. It contains the doc strings from the functions and adds crowd sourced examples of usage and see alsos. You can surf for quite long on that site without getting bored. \ud83d\ude04

    You can surf ClojureDocs in Calva

    Calva integrates this information in two ways:

    1. Commands for requesting the ClojureDocs information for a symbol under the cursor:
      • Print clojuredocs.org examples to Rich Comment, default keybinding: ctrl+alt+r d
      • Print clojuredocs.org examples to OutputWindow, ctrl+alt+o d
    2. ClojureDocs information is included in the symbol lookup hovers, where each example has two buttons:
      • To Rich Comment
      • To Output Window

    That means that if you just want to glance at the examples, you look in the hover. And when you want to bring the examples to the REPL to play with them, you can do so very easily.

    ClojureScript support

    ClojureDocs information is available both for Clojure and ClojureScript files. However, clojuredocs.org only keeps info for Clojure. Thus: All information Calva shows about a symbol will be about the Clojure respresentation of that symbol. (The symbol might not even exist in ClojureScript.)

    ","boost":4},{"location":"clojuredocs/#clojuredocs-repl-surfing","title":"ClojureDocs REPL Surfing","text":"

    Since the ClojureDocs information includes see-alsos, you can go for super interactive ClojureDocs surfing right in the file you are editing. Say you have this function:

    (defn trim-text\n  \"Returns text without surrounding whitespace if not empty, otherwise nil\"\n  [text]\n  (let [trimmed-text (clojure.string/trim text)]\n    (when-not (empty? trimmed-text)\n      trimmed-text)))\n

    Then you hover on when-not and scroll down a bit in the hover:

    That first example would be interesting to play with, right? Click To Rich Comment and you will get:

    (defn trim-text\n  \"Returns text without surrounding whitespace if not empty, otherwise nil\"\n  [text]\n  (let [trimmed-text (clojure.string/trim text)]\n    (when-not (empty? trimmed-text)\n      trimmed-text)))\n\n(comment\n  ;; = when-not - Example 1 = \n\n  ;; build tuples over sets with the same cardinality \n  (map\n   #(when-not (= %2 %3) [%1 %2 %3])\n   (iterate inc 0)   ; a lazy list of indices\n   [:a :b :c]\n   [:a :a :a])\n  ;;=> (nil [1 :b :a] [2 :c :a])\n\n  ;; See also:\n  when\n  when-let\n  if\n  )\n

    There you can evaluate the (map ...) form using alt+enter, modify it and evaluate again. You can also hover over map, iterate, or any of the \u201dSee also:\u201d symbols to find more fun examples to play with. And so on and so forth.

    See these two tweets for some videos of early versions of this functionality:

    Please retweet!

    ","boost":4},{"location":"clojuredocs/#quirks","title":"Quirks","text":"

    Some of the ClojureDocs entries have text that is not really Clojure code, and sometimes even structural errors. This can break the structural integrity of your Clojure file. If you run into trouble trying to heal things, you can always use Undo until the Rich Comment is gone.

    ","boost":4},{"location":"commands-top10/","title":"The Top 10 Calva Commands","text":"

    There are not all that many Calva commands. You can learn them all if you like, but here are the most important ones to know about for effective Clojure/ClojureScript coding:

    There are also two commands for bringing over the current form and the current top level form over to the repl window:

    You can also switch the name space of the output/repl window to that of the current file: alt+ctrl+c alt+n

    "},{"location":"commands-top10/#some-more-commands-to-try","title":"Some More Commands to Try","text":"

    See also:

    "},{"location":"connect-sequences/","title":"REPL Jack-in and Connect Sequences","text":"

    Many projects grow out of the template phase and call for custom developer workflows involving application start commands, customized REPLs, and what have you. Even some templates add this kind of complexity. To make Jack-in usable for a broader set of projects, Calva has a setting keyed calva.replConnectSequences which lets you configure one ore more connect sequences.

    NB: Connect sequence configuration affects Calva's Jack-in menu in the following ways:

    1. With no sequence configured, Calva will prompt for the built-in sequences it has that seems to match your project.
    2. When any number of connection sequences are configured, Calva will prompt for your custom sequences, as well as the built-in sequences. Whether built-in or custom, only sequences relevant to your project will be included in the prompt.
    ","boost":6},{"location":"connect-sequences/#settings-for-adding-custom-sequences","title":"Settings for adding Custom Sequences","text":"

    A connect sequence configures the following:

    The Calva built-in sequences also use this format, check them out to get a clearer picture of how these settings work.

    Force the project type menu to show

    The convenience of autoSelectForJackIn/Connect can be an inconvenience when you want to use another project type/sequence for a project. For this reason, the calva.connect and calva.jackIn can be provided with an option disableAutoSelect, which forces the project root and project type menus to show. See Options for the Connect Command and Options for the Jack-in Command for more on this.

    Path segments

    projectRootPath and nReplPortFile both take an array of path segments. This is to make the paths work cross-platform. If you can't be bothered splitting up the path in segments, put the whole path in the first segment, though please note that if you use Windows path separators, these will not work for users with Linux or macOS.

    ","boost":6},{"location":"connect-sequences/#custom-command-line","title":"Custom Command Line","text":"

    Custom command lines are there to bridge the gap to those situations where standard Jack-in command lines don't reach. Like:

    1. You want to provide command line options to a supported tool, which Jack-in does not provide
    2. Your project has some script through which it is started
    3. The REPL is provided by some tool that Calva does not know of
    4. Any other reason...

    A custom command line is executed from same directory as the REPL project root (See projectRootPath, above), and can be as simple as my-repl-jack-in-command. You can use a relative or absolute path to your command line.

    If your custom command line starts a REPL of a project type that is not \u201dknown\u201d/built-in to Calva, use custom as the projectType for the connect sequence.

    ","boost":6},{"location":"connect-sequences/#custom-command-line-substitutionsplaceholdersenvironment-variables","title":"Custom Command Line Substitutions/Placeholders/Environment variables","text":"

    You can use placeholders in your command line, and Calva will substitute them before executing the command. All these placeholders will also be provided to your script via environment variables with the same names (except dashes will be underscores in the env variable names):

    nREPL dependency versions:

    Paths:

    Depending on the project type Calva will also look for these placeholders:

    ","boost":6},{"location":"connect-sequences/#example-custom-jack-in-command-lines","title":"Example Custom Jack-in Command lines","text":"","boost":6},{"location":"connect-sequences/#start-a-babashka-repl-via-wsl","title":"Start a Babashka REPL via WSL","text":"

    Calva has a built-in jack-in sequence for starting a Babashka REPL and connect to it. It works as long as the bb process is on the same host as VS Code/Calva is running. So if you want it to run in WSL, but VS Code is running on your computer you need to start bb slightly differently. These settings in your VS Code settings file will give you a jack-in option that works for this:

      \"calva.replConnectSequences\": [\n    {\n        \"name\": \"Bashbabka (WSL)\",\n        \"projectType\": \"custom\",\n        \"customJackInCommandLine\": \"bash -c 'bb --nrepl-server JACK-IN-NREPL-PORT'\",\n    },\n  ],\n

    If you place it in your user settings you will have access to it from any workspace.

    ","boost":6},{"location":"connect-sequences/#an-exampleskeleton-script","title":"An example/skeleton script","text":"

    This script doesn't actually start a REPL, it's provided more for giving you an idea about what it could look like, and as a starting point for your real scripts:

    #!/usr/bin/env bb\n\n(require '[clojure.string :as str])\n\n(defn parse-args [args]\n  (loop [args args\n         parsed {}]\n    (if (empty? args)\n      parsed\n      (let [[flag value & rest-args] args]\n        (case flag\n          \"--aliases\" (recur rest-args (assoc parsed :aliases value))\n          \"--cider-nrepl-version\" (recur rest-args (assoc parsed :cider-nrepl-version value))\n          (do (println \"Unknown parameter:\" flag) (System/exit 1)))))))\n\n(defn process-args [args]\n  (let [aliases (str/split (:aliases args) #\",\")\n        cider-nrepl-version (:cider-nrepl-version args)\n        project-root-path (System/getenv \"JACK_IN_PROJECT_ROOT_PATH\")]\n    (println \"Aliases:\")\n    (doseq [alias aliases]\n      (println alias))\n    (println \"CIDER nREPL version:\" cider-nrepl-version)\n    (println \"JACK_IN_PROJECT_ROOT_PATH:\" project-root-path)))\n\n(def parsed-args (parse-args *command-line-args*))\n\n(when (= *file* (System/getProperty \"babashka.file\"))\n  (process-args parsed-args))\n

    It's written in Babashka to encourage you to write your shell scripts in a civilized language. \ud83d\ude00 See the article Changing my mind: Converting a script from bash to Babashka for a small success-story about this mindset. See also bash2bb.

    The script reads JACK-IN-CLJS-LAUNCH-BUILDS and JACK-IN-CIDER-NREPL-VERSION from the command line, and JACK_IN_PROJECT_ROOT_PATH from the environment. It could be configured for use in a custom connect sequence like this:

        \"customJackInCommandLine\": \"../../custom-jack-in.bb --aliases JACK-IN-CLJS-LAUNCH-BUILDS --cider-nrepl-version JACK-IN-CIDER-NREPL-VERSION\",\n

    Note how in this case the REPL is started two directories \u201ddown\u201d from the workspace root where the script resides.

    ","boost":6},{"location":"connect-sequences/#example-sequences","title":"Example Sequences","text":"

    Whether you just want to speed up your workflow or encode some workflow/mechanics into it, it's often the case that you can create a custom sequence that helps.

    ","boost":6},{"location":"connect-sequences/#minimal-menus-with-full-stack-shadow-cljs-repls","title":"Minimal menus with full stack shadow-cljs REPLs","text":"

    Minimize the amount of selecting from the Jack-in/Connect menu when working with a full-stack shadow-cljs + deps/lein project:

        {\n      \"name\": \"backend + frontend\",\n      \"projectType\": \"shadow-cljs\",\n      \"cljsType\": \"shadow-cljs\",\n      \"menuSelections\": {\n        \"cljsLaunchBuilds\": [\n          \":app\",\n          \":test\",\n        ],\n        \"cljsDefaultBuild\": \":app\"\n      }\n    }\n

    See shadow-cljs + Clojure with Calva: The basics for how Calva and nREPL work with ClojureScript.

    ","boost":6},{"location":"connect-sequences/#polylith","title":"Polylith","text":"

    This is the connect sequences used in the Polylith Real World App. The (start) sequence lets you jack-in to the project, and starts the Real World App without any prompts. The (connect) sequence can be used if you prefer to start the REPL manually, and want to connect without prompts.

        \"calva.replConnectSequences\": [\n        {\n            \"projectType\": \"deps.edn\",\n            \"afterCLJReplJackInCode\": \"(require '[dev.server] :reload) (in-ns 'dev.server) (start! 6003)\",\n            \"name\": \"Polylith RealWorld Server REPL (start)\",\n            \"autoSelectForJackIn\": true,\n            \"projectRootPath\": [\".\"],\n            \"cljsType\": \"none\",\n            \"menuSelections\": {\n                \"cljAliases\": [\"dev\", \"test\"]\n            }\n        },\n        {\n            \"projectType\": \"deps.edn\",\n            \"name\": \"Polylith RealWorld Server REPL (connect)\",\n            \"autoSelectForConnect\": true,\n            \"projectRootPath\": [\".\"],\n            \"cljsType\": \"none\",\n        }\n    ],\n    \"calva.autoConnectRepl\": true,\n

    The calva.autoConnectRepl, when set to true, makes Calva, at project open, look for the nRepl port file and automatically connect the repl if the file exists. Therefore, you can leave the app running when you close the project in VS Code, and Calva will reconnect when you open the project again. (Alternatively, maybe you just need to reload the VS Code window and not lose the REPL state.)

    ","boost":6},{"location":"connect-sequences/#minimal-menus-with-full-stack-depsedn-and-figwheel-main-repls","title":"Minimal menus with full stack deps.edn and Figwheel Main REPLs","text":"

    Setting for a full-stack application. It starts the backend server when the CLJ REPL has started. Then proceeds to create a custom CLJS REPL (calling in to the application code for this). And then connects to it.

    {\n    \"calva.replConnectSequences\": [\n        {\n            \"name\": \"Example Sequence\",\n            \"projectType\": \"Clojure-CLI\",\n            \"afterCLJReplJackInCode\": \"(go)\",\n            \"cljsType\": {\n                \"startCode\": \"(do (require '[cljs-test.main :refer :all])(start-nrepl+fig))\",\n                \"isReadyToStartRegExp\": \"Prompt will show\",\n                \"connectCode\": \"(do (use 'cljs-test.main) (cljs-repl))\",\n                \"isConnectedRegExp\": \"To quit, type: :cljs/quit\",\n                \"printThisLineRegExp\": \"\\\\[Figwheel\\\\] Starting Server at.*\"\n            }\n        }\n    ]\n}\n
    ","boost":6},{"location":"connect-sequences/#juxt-edge","title":"JUXT Edge","text":"

    Here is an example from the JUXT Edge project template. It adds two sequences, one for when only the Clojure REPL should be launched and one for when the customized Edge cljs repl should also be connected. The Edge backend + frontend sequence specifies that the web app should be opened by Calva, making cljs repl connection more stable, and also adds menuSelections to skip the launch aliases prompt.

    {\n    \"calva.replConnectSequences\": [\n        {\n            \"name\": \"Edge backend only\",\n            \"projectType\": \"deps.edn\"\n        },\n        {\n            \"name\": \"Edge backend + frontend\",\n            \"projectType\": \"deps.edn\",\n            \"cljsType\": {\n                \"dependsOn\": \"Figwheel Main\",\n                \"startCode\": \"(do (require 'dev-extras) (dev-extras/go) (println \\\"Edge Figwheel Main started\\\") ((resolve 'dev-extras/cljs-repl)))\",\n                \"isReadyToStartRegExp\": \"Edge Figwheel Main started\",\n                \"openUrlRegExp\": \"Website listening on: (?<url>\\\\S+)\",\n                \"printThisLineRegExp\": \"\\\\[Edge\\\\]\",\n                \"shouldOpenUrl\": true,\n                \"connectCode\": \"(do (require 'dev-extras) ((resolve 'dev-extras/cljs-repl)))\",\n                \"isConnectedRegExp\": \"To quit, type: :cljs/quit\",\n                \"buildsRequired\": false\n            },\n            \"menuSelections\": {\n                \"cljAliases\": [\n                    \"dev\",\n                    \"build\",\n                    \"dev/build\"\n                ],\n            }\n        }\n    ]\n}\n
    ","boost":6},{"location":"connect-sequences/#plain-depsedn","title":"Plain deps.edn","text":"

    A deps.edn sequence that does not promote the ClojureScript repl at all (leaving it a Clojure REPL), and leaves that up to you to do interactively. (Could be useful while you are developing a custom cljs repl.) The example is for when adapting a Figwheel Main repl.

    {\n    \"calva.replConnectSequences\": [\n        {\n            \"name\": \"Do not promote to cljs\",\n            \"projectType\": \"deps.edn\",\n            \"cljsType\": {\n                \"dependsOn\": \"Figwheel Main\",\n                \"connectCode\": \"\\\"Don't promote me bro!\\\"\",\n                \"isConnectedRegExp\": \"Don't promote me bro!\"\n            }\n        }\n    ]\n}\n
    ","boost":6},{"location":"connect/","title":"Connect Calva to Your Project","text":"

    When connected to your project's REPL Calva lets you evaluate code, supporting Interactive Programming. The REPL connection is also used to provide IDE functionality through the dynamic knowledge about the project that the REPL enables. The REPL communication depends on that your project has an nREPL server running, and that the cider-nrepl middleware is enabled.

    For the easiest way to provide your project with these dependencies, the recommended way to connect is to use the so called Jack-in command.

    ","boost":7},{"location":"connect/#jack-in-let-calva-start-the-repl-for-you","title":"Jack-in: Let Calva Start the REPL For You","text":"

    This way Calva can make sure it is started with the dependencies needed for a working Clojure and/or ClojureScript session. This is often referred to as Jack in (because that is what it is called in CIDER).

    Jack-in supports both CLJ and for CLJS, and has built-in configurations for Leiningen, deps.edn, shadow-cljs, Gradle projects, as well as for the CLJS repl types: Figwheel Main, lein-figwheel (legacy Figwheel), shadow-cljs, and ClojureScript built-ins for both browser and node.js. Using jack-in provides your development environment with all the dependencies you need for Calva to work.

    It works like so:

    1. Open your project in VS Code.
    2. Issue the command Start a Project REPL and Connect: ctrl+alt+c ctrl+alt+j.
    3. Answer the quick-pick prompts telling Calva about project types and what profiles to start. (See the Jack-in Project Types and Profiles wiki page for more info if needed.)

    See also: Workspace Layouts

    About project roots

    You must have a project file, such as project.clj for Leiningen, or deps.edn for deps.edn, or shadow-cljs.edn for shadow-cljs, or settings.gradle/settings.gradle.kts for Gradle in the directory opened in VS Code in order for jack-in to work. If, after adding the project file, you experience an error during jack-in that says something could not be located, make sure you have the correct dependencies in your project file. For example, when using the Figwheel Main project type, you should have com.bhauman/figwheel-main in your project dependencies.

    See also below, regarding multiple projects in a workspace

    ","boost":7},{"location":"connect/#aliases-profiles-builds","title":"Aliases, Profiles, Builds","text":"

    When Jack-in starts it will depend on the project type, and whether ClojureScript is involved or not, and if it is, what kind of ClojureScript project, what will happen next. Calva will analyze the project files and will then give you prompts with selections based on what is found there.

    You will need some basic knowledge about the project and the project type terminologies to answer the prompts.

    There are ways to tell Calva the answers to these prompts beforehand, so that Jack-in can be a zero-prompting command. Read on.

    ","boost":7},{"location":"connect/#customizing-jack-in","title":"Customizing Jack-in","text":"

    The main mechanism for customizing your Jack-in, including automating menu selections, and custom CLJS REPL types is Custom Connect Sequences. See also Customizing Jack-in and Connect

    ","boost":7},{"location":"connect/#connecting-without-jack-in","title":"Connecting Without Jack-in","text":"

    If, for whatever reasons, you can't use Jack-in with your project (possibly because the REPL is started as part of some other job) all is not lost. Old fashioned Connect to a running REPL is still there for you. For all features to work in Calva while connecting to a running REPL, your environment needs to have REPL related dependencies set up.

    However, just as before it can be tricky to get the dependencies right. Consider using Jack in to inform yourself on how to start your REPL to Calva's satisfaction. When you use Jack in, Calva starts a VS Code task for it and the command line used is displayed in the terminal pane used to handle the task. Reading that command line tells you what dependencies are needed for your project.

    Even better: Copying that command line gives you the command to start the REPL with the correct dependencies.

    All this said, I still recommend you challenge the conclusion that you can't use Jack-in.

    Copy the Jack-in command line

    There is a Calva command for copying the Jack-in command line to the clipboard. It will copy the command line including commands to change to the current REPL project root, avoiding hard-to-detect errors when starting the REPL in the wrong directory.

    The Generic Project Type

    A reason to use the connect to a running REPL way, can be that Calva does not have a built in connect sequence/project type for the particular REPL you want to connect to. Maybe it is something like Lingy which doesn't yet have a built in Calva connect sequence. As long as there is an nREPL server to connect to, you can Connect with Calva, using the Generic connect sequence/project type. (You can also create a connect sequence with a custom command line, and use Jack-in anyway.)

    See also Customizing Jack-in and Connect

    ","boost":7},{"location":"connect/#starting-the-repl-from-application-code","title":"Starting the REPL from application code?","text":"

    If your project is setup so that the REPL server is started by the application code, you will need to get the cider-nrepl middleware in place. See the cider-nrepl docs about embedding nREPL in your application.

    ","boost":7},{"location":"connect/#auto-select-project-type-and-project-root","title":"Auto-select Project Type and Project Root","text":"

    You can make both Jack-in and Connect stop prompting you for project type and project root path in projects where you always want to use the same. See Connect Sequences.

    ","boost":7},{"location":"connect/#monorepos-multiple-clojure-projects-in-one-workspace","title":"Monorepos / multiple Clojure projects in one workspace","text":"

    If the workspace is a monorepo, Polylith repo or just a repository with more than one Clojure project, Calva will start the connect sequence with prompting for which project to start/connect to.

    ","boost":7},{"location":"connect/#shadow-cljs","title":"shadow-cljs","text":"

    Please see the shadow-cljs page.

    ","boost":7},{"location":"connect/#troubleshooting","title":"Troubleshooting","text":"","boost":7},{"location":"connect/#jack-in-and-main-opts","title":"Jack-in and :main-opts","text":"

    When Calva starts the project REPL and connects to it (a.k.a. Jack-in), this is done by starting an nREPL server. For deps.edn projects this by default means that Calva will add -m ... with options that starts the server.

    However: If you choose an alias at Jack-in that specifies :main-opts, it will make the Clojure CLI to add main opts and Calva will then not override these by adding -m ... to the command line. This means that an alias that specify :main-opts must result in an nREPL server being started, or else Calva won't have a server to connect to. Calva won't further analyze this, but will just warn you at Jack-in.

    If you don't know if an alias starts an nREPL server or not, by all means, try it, if you have reasons for using that alias. You will notice if Jack-in works or not. If it doesn't work, you will need to run without that alias, or fix what happens when that alias is used so that an nREPL server is started. See https://nrepl.org/nrepl/usage/server.html about ways to do this.

    ","boost":7},{"location":"connect/#command-not-found-errors-when-jacking-in","title":"Command Not Found Errors When Jacking In","text":"

    If you get command not found error when Calva tries to start your project, and you know you have the command installed, it's probably because VS Code starts from an environment where the command is not on the $PATH. It can look like so:

    lein update-in :dependencies conj '[nrepl,\"0.8.3\"]' -- update-in :plugins conj '[cider/cider-nrepl,\"0.25.8\"]' -- update-in '[:repl-options,:nrepl-middleware]' conj '[\"cider.nrepl/cider-middleware\"]' -- repl :headless\n/bin/sh: lein: command not found\nJack-in process exited. Status: 127\n

    The fix is to always start VS Code from the command line:

    $ code\n

    You might need to first run the Shell Command: Install code command in PATH.

    This will also make sure your REPL has access to the environment you probably expect it to have access to. See below.

    ","boost":7},{"location":"connect/#go-to-definition-not-working-for-java-definitions","title":"Go to Definition Not Working for Java Definitions","text":"

    On some systems, the Java source may not be installed along with the JDK. The source must be present on your system in order to navigate to Java definitions. See this comment for more details.

    ","boost":7},{"location":"connect/#environment-variables-are-not-readable-from-repl","title":"Environment Variables Are Not Readable From REPL","text":"

    If you've added environment variables in your OS, such as in your ~/.bashrc file (Linux), in order for them to be read in a REPL created by Calva's jackin command, VS Code must be started from a shell where the environment variables are defined. For example, if you can open a bash terminal and run echo $SOME_VAR and see the value there, then open VS Code from that terminal with code <project path>.

    ","boost":7},{"location":"connect/#viewing-the-communication-between-nrepl-and-calva","title":"Viewing the Communication Between nREPL and Calva","text":"

    It may be helpful to view the messages sent between nREPL and Calva when troubleshooting an issue related to the REPL. See how to do that here.

    ","boost":7},{"location":"contribute/","title":"Contribute to Calva","text":"

    There are many ways to contribute:

    Be creative!

    "},{"location":"contribute/#please-star-the-calva-repo","title":"Please star the Calva repo!","text":"

    Happy Coding! \u2764\ufe0f

    "},{"location":"custom-commands/","title":"Custom REPL Commands","text":"

    Calva supports configuration of custom command snippets that you can evaluate in the REPL at will. This is useful if your workflow has you repeatedly evaluating a particular piece of code. There are two ways to use these:

    1. You can use the setting calva.customREPLCommandSnippets to configure it. Then either bind keyboard shortcuts to them or use the command Run Custom REPL Command to access it. The command will give you a menu with the snippets you have configured.
    2. You can bind a keyboard shortcut directly to a custom command snippet by inlining it in the shortcut definition. See Binding Keyboard Shortcuts

    Joyride

    For some use cases you might be better served by/want to combine these with using the VS Code Extension API, and that of Calva, or any other extension, through Joyride.

    The calva.customREPLCommandSnippets is an array of objects with the following fields (required fields in bold):

    There are also substitutions available, which will take elements from the current state of Calva and splice them in to the text of your command before executing it. They are

    ","boost":4},{"location":"custom-commands/#user-and-workspace-settings","title":"User and Workspace Settings","text":"

    Settings from your User (global) level and the workspace are merged.

    With these User settings:

        \"calva.customREPLCommandSnippets\": [\n        {\n            \"name\": \"Call Current Form\",\n            \"key\": \"c\",\n            \"snippet\": \"($current-form)\"\n        },\n        {\n            \"name\": \"Call Current Top Level Form\",\n            \"key\": \"t\",\n            \"snippet\": \"($top-level-form)\"\n        },\n        {\n            \"name\": \"CLJ Test Top Level Defined Symbol\",\n            \"repl\": \"clj\",\n            \"snippet\": \"(clojure.test/test-var #'$top-level-defined-symbol)\"\n        },\n        {\n            \"name\": \"CLJS Test Top Level Defined Symbol\",\n            \"repl\": \"cljs\",\n            \"snippet\": \"(cljs.test/test-var #'$top-level-defined-symbol)\",\n            \"key\": \"tab\"\n        }\n    ],\n

    And these Workspace settings:

        \"calva.customREPLCommandSnippets\": [\n        {\n            \"name\": \"Remount CLJS App\",\n            \"key\": \"r\",\n            \"repl\": \"cljs\",\n            \"ns\": \"example.app\",\n            \"snippet\": \"(start)\"\n        }\n    ],\n

    Issuing Run Custom REPL Command will then render this VS Code menu:

    The default keyboard shortcut for the command is ctrl+alt+space space. (Beware: on MacOS it may conflict with the default shortuct for Input Sources - Select next source in Input menu.)

    ","boost":4},{"location":"custom-commands/#binding-keyboard-shortcuts","title":"Binding Keyboard Shortcuts","text":"

    There are four ways to bind shortcuts to custom commands:

    1. Use a predefined key shortcut. These are predefined as ctrl+alt+space <something>, where <something> is one of:
      • The digits 0 through 9
      • The English letters a through z
      • Arrow keys right, left, up, or down
      • One of tab, backspace, ,, ., or -
    2. Bind calva.runCustomREPLCommand to a shortcut with whatever code you want to evaluate in the args slot. You have access to the substitution variables here as well.
    3. Bind calva.runCustomREPLCommand to a keyboard shortcut referencing the key of one of your calva.customREPLCommandSnippets. (If not using any of the keys mentioned in 1.)
    4. Bind calva.runCustomREPLCommand to a shortcut with a customREPLCommandSnippets in the args slot. You have access to the substitution variables here as well.

    Here's an example shortcut entry for the 4th option:

        {\n        \"key\": \"ctrl+cmd+u alt+enter\",\n        \"command\": \"calva.runCustomREPLCommand\",\n        \"args\": {\n            \"ns\": \"user\",\n            \"snippet\": \"$current-form\",\n        }\n    },\n

    This would evaluate the current form in the user namespace. Please note that this Custom REPL Command will not show up in the custom commands menu mentioned above.

    ","boost":4},{"location":"custom-commands/#custom-repl-hover-snippets","title":"Custom REPL Hover Snippets","text":"

    Calva supports custom snippets that will display their result inside the tooltip. They will only work when connected to a repl, since they eval code in it. This is mostly useful for tooling authors that want to integrate with calva. Be careful with these, since they will be executed anytime Calva displays a tooltip. So they should be fast and probably not have any side effects.

    The hover snippets accept the same inputs as the Custom REPL Commands, except for the hotkey:

        \"calva.customREPLHoverSnippets\": [\n        {\n            \"name\": \"eval text on hover\",\n            \"repl\": \"clj\",\n            \"ns\": \"example.app\",\n            \"snippet\": \"(str \\\"$hover-text\\\")\"\n        }\n    ]\n

    With this setting anything the mouse is over will also be shown inside its tooltip. There are now also hover- versions of most substitutions. Those currently only work inside the hover snippets.

    ","boost":4},{"location":"custom-commands/#configedn","title":"config.edn","text":"

    :customREPLCommandSnippets and :customREPLHoverSnippets can be also be configured in your user config at .config/calva/config.edn realative to your system home directory, or .calva/config.edn relative to the workspace root. Three things to note about this:

    1. None of these two configs get synced through VS Code Settings Sync.
    2. Changes to workspace .calva/config.edn will be automatically noticed by Calva, and refresh the config. This will not happen with the user config file.
    3. Internally in Calva, the settings are keyed on the snippet :name entry, and if you change the name, the old entry won't be removed until the VS Code window is reloaded.

    As for 2.: There is a command Calva: Refresh REPL snippets from User config.edn.

    There is also a command to open the User config.edn, for convenience: Calva: Open REPL snippets User config.edn. This command creates the file if it doesn't previously exist.

    ","boost":4},{"location":"custom-commands/#snippets-inside-deps","title":"Snippets Inside Deps","text":"

    A new experimental feature lets library authors ship snippets inside their jar files. These accept the same options as above but should be placed in \"resources/calva.exports/config.edn\" inside the jar.

    {:customREPLCommandSnippets\n [{:name \"edn test\"\n   :key \"a\"\n   :snippet ($current-form)}]\n :customREPLHoverSnippets\n [{:name \"edn hover\"\n   :snippet (str \"$hover-tex\")}\n  {:name \"edn hover show val\"\n   :snippet (str \"### EDN show val\\n```clojure\\n\" (pr-str (eval (symbol (str \"$ns\" \"/\" \"$hover-top-level-defined-symbol\")))) \"\\n```\")}]}\n
    ","boost":4},{"location":"customizing-jack-in-and-connect/","title":"Customize Jack-in and Connect","text":"

    Since Jack-in and connect both are about connecting the REPL, and only differ in how the REPL is started, many settings and configuration points are shared between the two concepts. A major customization point is Custom Connect Sequences, which are relevant for both Jack-in and Standalone Connect scenarios.

    This page lists some more Jack-in and Connect configuration options.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#auto-evaluate-code-on-connect","title":"Auto-evaluate Code on Connect","text":"

    You can have Calva evaluate code whenever a REPL has been connected via the calva.autoEvaluateCode.onConnect setting. It has two entries clj and cljs:

    Set either of these to null to disable the feature for that REPL type. (The Settings linter will complain, but it works.)

    For Clojure this is in addition to afterCLJReplJackInCode

    There are two mechanisms for evaluating code when a Clojure REPL is connected. The afterCLJReplJackInCode setting of custom connect sequences, and this calva.autoEvaluateCode.onConnect.clj setting. There is no fundamental difference between them. This one has a default function of auto-refering in the Clojure REPL utilities. And it will be run before the connect sequence after-Jack-in code.

    All configured code is concatenated

    If you configure this both in User/global settings and in a Workspace, the workspace configured code will be concatenated on the user level code. Meaning both code snippets will be evaluated, first the User level code, then the Workspace level code. Also null disables the feature:

    ","boost":7},{"location":"customizing-jack-in-and-connect/#auto-evaluate-code-at-filenamespace-loadevaluation","title":"Auto-evaluate Code at file/namespace load/evaluation","text":"

    You can also make Calva auto-evaluate code when a file has been loaded in the REPL (via the Calva command for loading files). You add code for this via the calva.autoEvaluateCode.onFileLoaded setting. Like with onConnect you provide code for clj and cljs separately.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#customizing-connect","title":"Customizing Connect","text":"

    If there is an nRepl port file, Calva will use it and not prompt for host:port when connecting. You can make Calva prompt for this by setting the boolean config calva.autoSelectNReplPortFromPortFile to false.

    With the setting calva.autoConnectRepl you can make Calva automatically connect the REPL if there is an nRepl port file present when the project is opened.

    With this and the below mentioned auto-select options you can make connect a prompt-less experience. See: Connect Sequences.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#options-for-the-connect-command","title":"Options for the Connect Command","text":"

    The calva.connect command takes an optional options argument defined like so:

      options?: {\n    host?: string;\n    port?: string;\n    connectSequence?: string | ReplConnectSequence;\n    disableAutoSelect?: boolean;\n  }\n

    Where ReplConnectSequence is a Connect Sequences. If you provide a string it needs to match against a built-in or custom connect sequence. With disableAutoSelect you can force the connect menus to be provided even if a custom connect sequence is set to be autoSelected.

    You can provide these options from keyboard shortcuts or from Joyride scripts.

    Here's a keyboard shortcut for connecting to a running REPL bypassing any connect sequence with autoSelectForConnect.

        {\n        \"command\": \"calva.connect\",\n        \"args\": {\"disableAutoSelect\": true},\n        \"key\": \"ctrl+alt+c shift+c\",\n    },\n

    A Joyride command for connecting to a REPL on port 55555, without being asked for project type:

    (vscode/commands.executeCommand \"calva.connect\" (clj->js {:port \"55555\" :connectSequence \"Generic\"}))\n
    ","boost":7},{"location":"customizing-jack-in-and-connect/#customizing-jack-in","title":"Customizing Jack-in","text":"

    The main mechanism for customizing your Jack-in, including automating menu selections, and custom CLJS REPL types is Custom Connect Sequences.

    There are also these settings:

    Note

    When processing the calva.jackInEnv setting you can refer to existing ENV variables with ${env:VARIABLE}.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#jack-in-dependency-versions","title":"Jack-in Dependency Versions","text":"

    Calva Jack-in injects the following dependencies in order for the REPL session to support IDE features

    The versions used are configurable via the VS Code settings calva.jackInDependencyVersions.

    Java 1.8 compatible versions

    The default dependency versions are not compatible with Java 1.8. If your project needs that version of Java you can use these settings in your Workspace .vscode/settings.json:

    \"calva.jackInDependencyVersions\": {\n  \"nrepl\": \"1.0.0\",\n  \"cider-nrepl\": \"0.28.5\",\n  \"cider/piggieback\": \"0.5.3\"\n}\n
    ","boost":7},{"location":"customizing-jack-in-and-connect/#options-for-the-jack-in-command","title":"Options for the Jack-in Command","text":"

    The calva.jackIn command takes an optional options argument defined like so:

      options?: {\n    connectSequence?: string | ReplConnectSequence;\n    disableAutoSelect?: boolean;\n  }\n

    Where ReplConnectSequence is a Connect Sequences. If you provide a string it needs to match against a built-in or custom connect sequence. With disableAutoSelect you can force the jack-in menus to be provided even if a custom connect sequence is set to be autoSelected.

    You can provide these options from keyboard shortcuts or from Joyride scripts.

    Here's a keyboard shortcut for connecting to a running REPL bypassing any connect sequence with autoSelectForConnect.

        {\n        \"command\": \"calva.jackIn\",\n        \"args\": {\"disableAutoSelect\": true},\n        \"key\": \"ctrl+alt+c shift+j\",\n    },\n

    A Joyride command for starting a deps.edn REPL for a project in the root of the workspace.

    (vscode/commands.executeCommand\n \"calva.jackIn\"\n (clj->js {:connectSequence {:projectType \"deps.edn\"\n                             :projectRootPath [\".\"]}}))\n

    It will prompt for any aliases it finds in the deps.edn file.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#starting-the-repl-from-application-code","title":"Starting the REPL from application code?","text":"

    If your project is setup so that the REPL server is started by the application code, you will need to get the cider-nrepl middleware in place. See the cider-nrepl docs about embedding nREPL in your application.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#auto-select-project-type-and-project-root","title":"Auto-select Project Type and Project Root","text":"

    You can make both Jack-in and Connect stop prompting you for project type and project root path in projects where you always want to use the same. See Connect Sequences.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#project-roots-search-globing","title":"Project roots search globing","text":"

    When searching for project roots in your workspace, Calva will glob for all files matching project.clj, deps.edn, or shadow-cljs.edn. This is done using VS Code's workspace search engine, and is very efficient. However, in a large monorepo, it is still a substantial task. In order to not waste resources Calva will exclude any directories in the setting calva.projectRootsSearchExclude.

    Exclude entry globs

    Each entry is a partial glob and will be part of a resulting glob of the form **/{glob1,glob2,...,globN}. This means that all directories in the workspace matching an entry will be excluded, regardless of where in the workspace they reside.

    ","boost":7},{"location":"customizing-jack-in-and-connect/#viewing-the-communication-between-nrepl-and-calva","title":"Viewing the Communication Between nREPL and Calva","text":"

    It may be helpful to view the messages sent between nREPL and Calva when troubleshooting an issue related to the REPL. See how to do that here.

    ","boost":7},{"location":"customizing/","title":"Customizing Calva","text":"

    Don't like the defaults? On this page we can collect some of the customizations that people have done, and maybe write a thing or two about it some day.

    Tip for VS Code newcomers: The search box in Settings is your friend. Also, some Calva settings are more complex than the Settings UI can handle. VS Code will then show you a link to settings.json. And VS Code's built-in json extension is awesome. To add settings for Calva's Pretty Printing, for example, search for \u201dprettyprint\u201d in VS Code Settings and follow the link to settings.json. Start typing \u201dcalvapretty\u201d until auto-complete suggests calva.prettyPrintingOptions. Press ENTER and VS Code will fill in these defaults:

        \"calva.prettyPrintingOptions\": {\n        \"enabled\": true,\n        \"printEngine\": \"pprint\",\n        \"width\": 40\n    },\n
    "},{"location":"customizing/#clojure-defaults","title":"Clojure Defaults","text":"

    Calva sets some VS Code settings for all Clojure files. Some of these are needed for Calva to function correctly, which should not be tampered with unless you really know what you are doing, and some of them are convenient defaults. If you add a setting to your settings.json and accept the snippet help you get when you type \"[clojure]\", you will get the Calva defaults pasted:

        \"[clojure]\": {\n        \"editor.wordSeparators\": \"\\t ()\\\"':,;~@#$%^&{}[]`\",\n        \"editor.autoClosingBrackets\": \"always\",\n        \"editor.autoClosingQuotes\": \"always\",\n        \"editor.autoClosingQuotes\": \"always\",\n        \"editor.formatOnType\": true,\n        \"editor.autoIndent\": \"full\",\n        \"editor.formatOnPaste\": true,\n        \"editor.matchBrackets\": \"never\",\n        \"editor.renderIndentGuides\": false,\n        \"editor.parameterHints.enabled\": false\n    }\n

    Note

    The above editor.wordSeparators setting establish Clojure word boundaries. E.g - is considered to be part of words. This affects what happens when double-clicking symbols and other things. If you want to include - or something else as a word boundary, just add it to the setting.

    "},{"location":"customizing/#pretty-printing","title":"Pretty Printing","text":"

    Calva's pretty printing mode can be configured a bit. See Pretty Printing.

    "},{"location":"customizing/#calva-highlight","title":"Calva Highlight","text":"

    This is highly customizable. See Syntax highlighting

    "},{"location":"customizing/#color-customizations","title":"Color customizations","text":"

    Calva defines a set of themable colors which can be provided by the user using workbench.colorCustomizations.

        \"workbench.colorCustomizations\": {\n        \"calva.inlineErrorForegroundColor\": \"#ff0000\",\n        \"calva.inlineForegroundColor\": \"#ff9000\"\n    }\n

    "},{"location":"customizing/#automatic-parameter-hints-poppup","title":"Automatic Parameter Hints Poppup","text":"

    Calva has helpful parameter hints to aid when typing function calls. They look like so:

    To have the hints automatically pop up when you are typing, set editor.parameterHints.enabled to true in the above [clojure] scoped setting. (To call them up on demand the default VS Code keybindings are cmd+shift+space on Mac and ctrl+shift+space on Linux/Windows.)

    "},{"location":"customizing/#code-formatting","title":"Code Formatting","text":"

    See Formatting for information on how to configure this.

    "},{"location":"customizing/#jack-in-and-connect","title":"Jack-in and Connect","text":"

    Jack-in and Connect are very customizable through Custom Connect Sequences.

    See also Customizing Jack-in and Connect

    "},{"location":"customizing/#key-bindings","title":"Key bindings","text":"

    Most of Calva's commands have default keybindings. They are only defaults, though, and you can change keybindings as you wish. To facilitate precision in binding keys Calva keeps some when clause contexts updated.

    "},{"location":"customizing/#when-clause-contexts","title":"When Clause Contexts","text":"

    The following contexts are available with Calva:

    "},{"location":"customizing/#some-custom-bindings","title":"Some Custom Bindings","text":"

    Here is a collection of custom keybindings from here and there.

    Are you a vim extension user? See: Using with VIM extension.

    "},{"location":"customizing/#move-by-word","title":"Move by word","text":"

    By default Calva changes the move-by-word key bindings to move by sexpr/form when the cursor is in structural Clojure code. Within line comments the editor default word movement is active.

    If you want the VS Code default word movement shortcuts, use these settings:

        {\n        \"key\": \"ctrl+right\",\n        \"win\": \"ctrl+right\",\n        \"mac\": \"alt+right\",\n        \"command\": \"cursorWordRight\"\n    },\n    {\n        \"key\": \"ctrl+left\",\n        \"win\": \"ctrl+left\",\n        \"mac\": \"alt+left\",\n        \"command\": \"cursorWordLeft\"\n    },\n    {\n        \"key\": \"ctrl+right\",\n        \"mac\": \"ctrl+right\",\n        \"win\": \"alt+right\",\n        \"command\": \"paredit.forwardSexp\",\n        \"when\": \"calva:keybindingsEnabled && editorTextFocus && editorLangId == 'clojure' && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+left\",\n        \"mac\": \"ctrl+left\",\n        \"win\": \"alt+left\",\n        \"command\": \"paredit.backwardSexp\",\n        \"when\": \"calva:keybindingsEnabled && editorTextFocus && editorLangId == 'clojure' && paredit:keyMap =~ /original|strict/\"\n    }\n

    Use it as an inspiration for customizing things to your own liking. \ud83d\ude04

    "},{"location":"customizing/#wrap-using-like-cursive","title":"Wrap using (, [, { (like Cursive)","text":"

    Something I use in IntelliJ/Cursive is the ability to select an expression and hit one of (, [, { to wrap it. And after wrapping the expression I don't want the selection anymore, so if I were wrapping (foo) then I would want to get ( | (foo)) where | would be my cursor.

    Here's how you can make this work with Calva Paredit: Update all of the Paredit: Wrap Around ... commands so that their respective shortcuts are the wrappers themselves and update the when clause to include editorHasSelection (otherwise when you open a paren the next expression would get slurped in).

    The change would look like this in your keybindings.json:

        {\n        \"key\": \"shift+9\",\n        \"command\": \"paredit.wrapAroundParens\",\n        \"when\": \"editorTextFocus && editorHasSelection && !editorReadOnly && editorLangId =~ /clojure|scheme|lisp/ && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"[\",\n        \"command\": \"paredit.wrapAroundSquare\",\n        \"when\": \"editorHasSelection && editorTextFocus && !editorReadOnly && editorLangId =~ /clojure|scheme|lisp/ && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"shift+[\",\n        \"command\": \"paredit.wrapAroundCurly\",\n        \"when\": \"editorHasSelection && editorTextFocus && !editorReadOnly && editorLangId =~ /clojure|scheme|lisp/ && paredit:keyMap =~ /original|strict/\"\n    }\n
    "},{"location":"debugger/","title":"Debugger","text":"

    Calva comes with a powerful expression-based debugger, inspired by Cider's debugger, and using the same underlying library, cider-nrepl. We hope you love it!

    Note

    The debugger currently does not support ClojureScript. Calva's debugger utilizes cider-nrepl for debugging. See this Cider issue for more information.

    "},{"location":"debugger/#features","title":"Features","text":""},{"location":"debugger/#current","title":"Current","text":""},{"location":"debugger/#future-goals","title":"Future goals","text":""},{"location":"debugger/#dependencies","title":"Dependencies","text":"

    The debugger itself relies pretty heavily on cider-nrepl, as do other parts of Calva. This library is loaded as a dependency when you use Calva Jack-in. If you are not using Calva Jack-in, you can add these dependencies in your project definition or user profile. See the Calva Jack-in guide for more information.

    "},{"location":"debugger/#using-the-debugger","title":"Using the Debugger","text":"

    If you're new to Clojure or expression-based debuggers, this debugger may function differently than what you're used to. Instead of placing breakpoints in the side margin and then hitting F5 to start debugging, you instead use Clojure reader tags, #break and #dbg, to denote breakpoints anywhere in a Clojure form. When you evaluate a call to a function that has been evaluated with that reader tag, the debugger will start when execution reaches the first breakpoint. There's also a convenience command to instrument functions. Read below about both options.

    Note

    The debugger is not configured via a launch.json file, and is not started in the same way as you may be used to when working with other languages in VS Code. The debugger is used by way of the REPL. If you are new to Clojure, please visit the Getting Started section of the documentation and get familiar with evaluating code using the REPL before using the debugger.

    "},{"location":"debugger/#instrumenting-a-function","title":"Instrumenting a Function","text":"

    You can instrument a top level function for debugging with ctrl+alt+c i. This places invisible breakpoints throughout the function where pausing makes sense. When you evaluate a call to this function, the debugger will start and execution will pause at the first breakpoint. Annotations show the value of the form at the cursor.

    A border is placed around the definition of the instrumented function and its references to show that it's instrumented. You can remove instrumentation by evaluating the function again normally, such as with alt+enter.

    "},{"location":"debugger/#setting-breakpoints-with-break","title":"Setting Breakpoints with #break","text":"

    You can insert a breakpoint manually into any code by placing a #break in front of the form where you want execution to pause, and then evaluating the top level form with alt+enter. When you evaluate a call to this code the VS Code debugger will start, the cursor will move to right after the form that's preceded by #break, and the line will be highlighted to show execution is paused there.

    Note

    Code will be executed up to and including the form after the breakpoint.

    "},{"location":"debugger/#conditional-breakpoints","title":"Conditional Breakpoints","text":"

    You can set conditional breakpoints by adding metadata before the form that the #break applies to.

    (defn print-nums [n]\n  (dotimes [i n]\n    #break ^{:break/when (= i 7)} ;; This breakpoint will only be hit when i equals 7\n    (prn i)))\n
    "},{"location":"debugger/#instrumenting-a-form-with-dbg","title":"Instrumenting a Form with #dbg","text":"

    Adding #dbg before a form then evaluating the form with alt+enter will instrument the form. This has the same effect as using the instrument command.

    "},{"location":"debugger/#evaluating-code-in-the-paused-context","title":"Evaluating Code in the Paused Context","text":"

    When execution is paused at a breakpoint, you can evaluate code in that context. This can be done in the editor or in the REPL window, as usual.

    "},{"location":"debugger/#viewing-variable-values","title":"Viewing Variable Values","text":"

    While debugging, you can view the values of variables in VS Code's debugger side pane. You can also view values by hovering over the variables in the editor.

    Metadata not available

    The variable viewer does not have access to any metadata attached to the variable values.

    "},{"location":"debugger/#viewing-the-call-stack","title":"Viewing the Call Stack","text":"

    While debugging, you can view the call stack in VS Code's call stack side pane. Clicking the stack frames will show the related line of code in an editor.

    Note

    You may only see one stack frame in the call stack side pane, as the change for adding additional frames was rolled back due to an issue. You can follow the change for this at #1150.

    "},{"location":"debugger/#stepping-commands","title":"Stepping Commands","text":"

    You can use VS Code's debugger UI to advance execution while debugging.

    Note

    Clicking restart does nothing, since this functionality does not make sense for our debugger.

    "},{"location":"debugger/#caveats","title":"Caveats","text":""},{"location":"debugger/#breakpoints-in-looprecur","title":"Breakpoints in loop/recur","text":"

    One construct where the debugger is limited is loop/recur. As recur always has to appear in a tail-position inside a loop or a fn and the debugger uses macros to interleave breakpoints in the forms, it might happen that a recur no longer appears in a tail position. In that case we have to avoid setting up the breakpoint. An example of such a case is:

    (loop [i 0]\n  #break\n  (when (< i 10)\n    (println i)\n    (recur (inc i))))\n

    Here the breakpoint is exactly in front of a form that contains as its last expression a recur which is wrapped in a loop. This breakpoint has no effect. This does not mean you cannot use the debugger with loop, it just means you have to set your debug statements more carefully.

    "},{"location":"debugger/#loading-the-file-and-eval-on-save","title":"Loading the File and \"Eval On Save\"","text":"

    When you load a file, any breakpoints that were previously set in functions will be unset. If you have the \"Eval On Save\" setting enabled, your file is also loaded with each save, therefore saving the file will remove breakpoints previously set.

    "},{"location":"debugger/#troubleshooting","title":"Troubleshooting","text":""},{"location":"debugger/#debugger-hangs-when-stepping-over-infinite-seqs","title":"Debugger hangs when stepping over infinite seqs","text":"

    This is because the debugger tries to evaluate the form when it's stepped over, and if clojure.core/*print-length* is set to nil as it is by default, evaluation will never complete. If you want to debug a form with an infinite seq, make sure to set *print-length* beforehand. For example:

    (set! *print-length* 3)\n;; Or, to be more precise\n(set! clojure.core/*print-length* 3)\n

    Calva does not set this for you during debug mode, instead leaving it up to you to decide the value.

    "},{"location":"debugger/#my-breakpoint-isnt-being-hit","title":"My breakpoint isn't being hit","text":"

    It's likely that your breakpoint is in a place that cider-nrepl does not see as an appropriate place to break execution. For example, if you put a breakpoint before a literal number, it will not be hit, because there's no need to show the value of a literal.

    (defn simple [x]\n  (+ 1 #break 1)) ;; This breakpoint will not be hit\n

    Another possible issue is that you're loading the file again after setting breakpoints, which unsets them. See Loading the File and \"Eval On Save\" under Caveats.

    "},{"location":"debugger/#my-breakpoint-in-a-test-isnt-being-hit","title":"My breakpoint in a test isn't being hit","text":"

    If you're using the test commands like \"Run current test\" to run your tests, breakpoints will not be hit. This is because Calva loads the file before running the tests to make sure the latest version of test code is being run, and when the file is loaded, breakpoints are unset.

    If you want a breakpoint to work within the test, evaluate the test form with a breakpoint tag in it, then call the test directly.

    "},{"location":"debugger/#no-reader-function-for-tag-error","title":"\"No reader function for tag\" error","text":"

    If you get an error like this, it's likely that you connected to a REPL instead of jacking in, and you don't have the proper dependencies loaded in your REPL. You can run the command \"Copy Jack-in Command Line to Clipboard\" to see what command would be run if you jacked in.

    Most importantly, make sure you have cider/cider-nrepl as a dependency, and cider.nrepl/cider-middleware as middleware loaded in your REPL. For example, this is a jack-in command line for a deps.edn project:

    clojure -Sdeps '{:deps {nrepl/nrepl {:mvn/version,\"0.8.3\"},cider/cider-nrepl {:mvn/version,\"0.25.8\"}}}' -m nrepl.cmdline --middleware \"[cider.nrepl/cider-middleware]\"\n
    "},{"location":"debugger/#passing-options-to-the-repl-jvm","title":"Passing options to the REPL JVM","text":"

    There are times when Clojure debugging tools are not enough or not right for the job. This is usually true when use an (open source) Java library and you want to set some breakpoints in Java code. For those cases and others, you need to start the JVM in debug mode.

    Typical use cases:

    Calva supports passing environment variables via jackInEnv. You can set that option inside VSCode settings.json file.

    You can configure global settings.json file or a project wide version, inside <project-root>/.vscode/settings.json.

    Configuring the global option will impact all projects you work on using Calva, so be aware. See the documentation for settings.json for more information.

    The bellow snippet configures JAVA_TOOL_OPTIONS environment variable. We configure slf4j-simple logging level via a Java system property (-D) and JVM specific options (-X).

    NOTE: You can of course pass other env variables here.

    .vscode/settings.json

    {\n    \"calva.jackInEnv\": {\n        \"JAVA_TOOL_OPTIONS\": \"${env:JAVA_TOOL_OPTIONS} -Dorg.slf4j.simpleLogger.defaultLogLevel=TRACE -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=7896\"\n    }\n}\n

    Once you saved the file, the next time you Jack in the project, this variable is read by the JVM and the configuration is applied accordingly.

    You should see something like the message below in the Calva terminal output window:

    clojure -Sdeps '{:deps {nrepl/nrepl {:mvn/version,\"0.8.3\"},cider/cider-nrepl {:mvn/version,\"0.26.0\"}}}' -A:debug -m nrepl.cmdline --middleware \"[cider.nrepl/cider-middleware]\"\nPicked up JAVA_TOOL_OPTIONS:  -Dorg.slf4j.simpleLogger.defaultLogLevel=TRACE -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=7896\nListening for transport dt_socket at address: 7896\nnREPL server started on port 46691 on host localhost - nrepl://localhost:46691\n
    "},{"location":"emacs-keybindings/","title":"Emacs Keybindings","text":"

    Some keybindings to make it easier for Emacs users 

    [\n    {\n        \"key\": \"ctrl+cmd+b\",\n        \"command\": \"paredit.backwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+alt+left\",\n        \"command\": \"-paredit.backwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"shift+cmd+]\",\n        \"command\": \"-workbench.action.nextEditor\"\n    },\n    {\n        \"key\": \"ctrl+shift+]\",\n        \"command\": \"paredit.barfSexpBackward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+right\",\n        \"command\": \"-paredit.barfSexpBackward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+[\",\n        \"command\": \"paredit.barfSexpForward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+left\",\n        \"command\": \"-paredit.barfSexpForward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+cmd+f\",\n        \"command\": \"paredit.forwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+alt+right\",\n        \"command\": \"-paredit.forwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+cmd+f\",\n        \"command\": \"-workbench.action.toggleFullScreen\"\n    },\n    {\n        \"key\": \"ctrl+shift+backspace\",\n        \"command\": \"-paredit.killSexpForward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"shift+cmd+k\",\n        \"command\": \"-editor.action.deleteLines\",\n        \"when\": \"textInputFocus && !editorReadonly\"\n    },\n    {\n        \"key\": \"ctrl+shift+0\",\n        \"command\": \"paredit.slurpSexpForward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+right\",\n        \"command\": \"-paredit.slurpSexpForward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+9\",\n        \"command\": \"paredit.slurpSexpBackward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+left\",\n        \"command\": \"-paredit.slurpSexpBackward\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+c ctrl+c\",\n        \"command\": \"calva.evaluateCurrentTopLevelForm\",\n        \"when\": \"calva:activated\"\n    },\n    {\n        \"key\": \"ctrl+alt+c space\",\n        \"command\": \"-calva.evaluateCurrentTopLevelForm\",\n        \"when\": \"calva:activated\"\n    },\n    {\n        \"key\": \"ctrl+x ctrl+e\",\n        \"command\": \"calva.evalCurrentTopLevelFormInREPLWindow\",\n        \"when\": \"calva:activated\"\n    },\n    {\n        \"key\": \"ctrl+alt+c ctrl+alt+space\",\n        \"command\": \"-calva.evalCurrentTopLevelFormInREPLWindow\",\n        \"when\": \"calva:activated\"\n    },\n    {\n        \"key\": \"ctrl+x ctrl+s\",\n        \"command\": \"workbench.action.files.save\"\n    },\n    {\n        \"key\": \"cmd+s\",\n        \"command\": \"-workbench.action.files.save\"\n    },\n    {\n        \"key\": \"cmd+s\",\n        \"command\": \"paredit.spliceSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+alt+s\",\n        \"command\": \"-paredit.spliceSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+cmd+k\",\n        \"command\": \"paredit.cutForwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+x right\",\n        \"command\": \"-paredit.cutForwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+cmd+backspace\",\n        \"command\": \"paredit.cutBackwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+shift+x left\",\n        \"command\": \"-paredit.cutBackwardSexp\",\n        \"when\": \"calva:activated && calva:pareditValid && paredit:keyMap =~ /original|strict/\"\n    },\n    {\n        \"key\": \"ctrl+1\",\n        \"command\": \"-workbench.action.openEditorAtIndex1\"\n    },\n    {\n        \"key\": \"ctrl+1\",\n        \"command\": \"editor.action.quickFix\",\n        \"when\": \"editorHasCodeActionsProvider && editorTextFocus && !editorReadonly\"\n    },\n    {\n        \"key\": \"cmd+.\",\n        \"command\": \"-editor.action.quickFix\",\n        \"when\": \"editorHasCodeActionsProvider && editorTextFocus && !editorReadonly\"\n    },\n    {\n        \"key\": \"cmd+.\",\n        \"command\": \"editor.action.revealDefinition\",\n        \"when\": \"editorHasDefinitionProvider && editorTextFocus && !isInEmbeddedEditor\"\n    },\n    {\n        \"key\": \"f12\",\n        \"command\": \"-editor.action.revealDefinition\",\n        \"when\": \"editorHasDefinitionProvider && editorTextFocus && !isInEmbeddedEditor\"\n    }\n]\n

    "},{"location":"eval-tips/","title":"Code Evaluation","text":"

    Calva tries to make it easy to evaluate code, supporting interactive development. The fastest path to learning about it is to use the Fire up the Getting Started REPL command, which you can learn more about in the Getting Started section.

    NB: The below assumes you have read about Finding Calva Commands and Shortcuts.

    ","boost":7},{"location":"eval-tips/#interruptingstopping-running-evaluations","title":"Interrupting/stopping running evaluations","text":"

    Sometimes you evaluate things that take a very long time to complete, or might not even ever complete (infinite loops, lazy sequences, things like that). Calva has a command for interrupting running evaluations. You find it in the VS Code command palette, as well as in the REPL status bar item menu, when the REPL is connected.

    ","boost":7},{"location":"eval-tips/#evaluation-in-a-file-editor","title":"Evaluation in a File Editor","text":"

    Calva has many commands for evaluating forms, including the current form and the current top-level form.

    Some of the commands also let you choose what should happen with the results:

    1. Inline. This will display the results (or some of it, if it is long) inline in the editor.
    2. This also creates a hover pane including the full results and a button which will copy the results to the clipboard.
    3. There is also a command for copying the last result to the clipboard.
    4. The full results are always available in the output window.
      • There is a command for showing the output window, allowing for a workflow where you either generally have it closed, or have it as one of the tabs in the same editor group as the files you are working with.
    5. To comments. This will add the results as line comments below the current line.
    6. Replace the evaluated code. This will do what it says, the evaluated code will be replaced with its results.
    ","boost":7},{"location":"eval-tips/#wait-current-form-top-level-form","title":"Wait, Current Form? Top-level Form?","text":"

    These are important concepts in Calva in order for you to create your most effective workflow. This video explains it a bit:

    ","boost":7},{"location":"eval-tips/#current-form","title":"Current Form","text":"

    Default shortcut for evaluating the current form: ctrl+enter.

    The current form either means the current selection, or otherwise is based on the cursor position. Play some with the command Calva: Select current form, ctrl+alt+c s, to figure out what Calva thinks is the current form for some different situations. Try it inside a symbol, adjacent to a symbol (both sides) and adjacent to an opening or closing bracket (again, both sides). Generally the current form is determined like so:

    1. If text is selected, then that text
    2. If the cursor is \u201din\u201d a symbol, then that symbol 
      foob|ar ; foobar\n
    3. If the cursor is adjacent to a form (a symbol or a list of some kind), then that form 
      (foo bar |(baz)) ; (baz)\n
    4. If the cursor is between to forms, then the left side form 
      (foo bar | (baz)) ; bar\n
    5. If the cursor is before the first form of a line, then that form 
      (foo\n| bar (baz)) ; bar\n
    ","boost":7},{"location":"eval-tips/#current-top-level-form","title":"Current Top-level Form","text":"

    Default shortcut for evaluating the current top level form: alt+enter.

    The current top-level form means top-level in a structural sense. It is not the topmost form in the file. Typically in a Clojure file you will find def and defn (and defwhatever) forms at the top level, which also is one major intended use for evaluating top level form: to define and redefine variables. However, Calva does not check the contents of the form in order to determine it as a top-level forms: all forms not enclosed in any other form are top level forms.

    An \u201dexception\u201d is introduced by the comment form. It will create a new top level context, so that any forms immediately inside a (comment ...) form will be considered top-level by Calva. This is to support a workflow with what is often referred to the Rich Comments.

    At the top level the selection of which form is the current top level form follows the same rules as those for the current form.

    ","boost":7},{"location":"eval-tips/#evaluate-enclosing-form","title":"Evaluate Enclosing Form","text":"

    The default keyboard shortcut for evaluating the current enclosing form (the list the cursor is in) is ctrl+shift+enter.

    (let [foo :bar]\n  (when false (str| foo))) ; => \":bar\"\n
    ","boost":7},{"location":"eval-tips/#evaluate-to-cursor","title":"Evaluate to Cursor","text":"

    There are several commands for evaluating a piece of code, closing brackets. It's good, especially in threads, but can also come in handy in other situations, for instance when you want to evaluate something that depends on bindings, such as in a let form.

    ","boost":7},{"location":"eval-tips/#evaluate-from-start-of-list-to-cursor-closing-brackets","title":"Evaluate From Start of List to Cursor, Closing Brackets","text":"

    This command evaluates the text from the start of the current enclosing list to where the cursor is, and it adds the missing closing bracket for you. Convenient for checking intermediate results in thread or doto, or similar pipelines. The cursor is right behind :d in this form:

      (->> [1 1 2 3 5 8 13 21]\n       (partition 2)\n       (zipmap [:a :b :c :d])\n       :d| ; => (13 21)\n       (apply -)\n       (Math/abs))\n

    The default shortcut for this command is ctrl+alt+enter.

    ","boost":7},{"location":"eval-tips/#evaluate-selection-closing-brackets","title":"Evaluate Selection, Closing Brackets","text":"

    This is the most versatile of the \u201devaluation, closing brackets\u201d commands. It will do what it says. \ud83d\ude04 It's extra handy in combination with the command Paredit: Select Backward Up Sexp/Form (shift+ctrl+up). Consider this contrieved form (buggy code, because it was supposed to result in 42, not -42):

    (defn fortytwo-from-thirty\n  []\n  (let [thirty 30]\n    (-> thirty\n        inc            ;1\n        (send-off)\n        (+ 1 2 3)\n        (->>\n         (+ 2 2)       ;2\n         (+))\n        list\n        (->>\n         (into [1])\n         (reduce + 1))\n        (- 1)          ;3\n        (* -1))))\n

    At ;1, you can do backward up sexp (shift+ctrl+up) twice to select up to the (let ..), then issue Evaluate Selection, Closing Brackets. It has the same default keybinding as the command for evaluating the current list up to the cursor: ctrl+alt+enter.

    At ;2 you need select backwards up three times.

    ;3 is included because it is close to the bug. (Which was introduced when the thread-last, ->> was added to make this example.) Please practice the Evaluate Selection, Closing Brackets command to fix the bug.

    ","boost":7},{"location":"eval-tips/#evaluate-from-start-of-top-level-form-to-cursor-closing-brackets","title":"Evaluate From Start of Top Level Form to Cursor, Closing Brackets","text":"

    This command has a default shortcut keybinding of shift+alt+enter. It will create a form from the start of the current top level form, up to the cursor, close all brackets, and this will then be evaluated. Good for examining code blocks up to a certain point. Often comes in handy in Rich comments ((comment ...)).

    Take this example and paste it in a file loaded into the REPL, then place the cursor in front of each line comment and try the command.

    (comment\n (do\n   (def colt-express\n     {:name \"Colt Express\"\n      :categories [\"Family\"\n                   \"Strategy\"]\n      :play-time 40\n      :ratings {:pez 5.0\n                :kat 5.0\n                :wiw 5.0   ; 1, then eval `colt-express`\n                :vig 3.0\n                :rex 5.0\n                :lun 4.0}})\n\n   (defn average [coll]\n     (/ (apply + coll) (count coll)))\n\n   (let [foo-express (-> colt-express\n                         (assoc :name \"Foo Express\")\n                         (assoc-in [:ratings :lyr] 5.0)\n                         (update-in [:ratings :vig] inc))]\n     (->> foo-express   ; 2\n          :ratings      ; 3\n          vals          ; 4\n          average       ; 5\n          ))))\n
    ","boost":7},{"location":"eval-tips/#evaluate-from-start-of-file-to-cursor-closing-brackets","title":"Evaluate From Start of File to Cursor, Closing Brackets","text":"

    Yup, that command also exists. \ud83d\ude04

    ","boost":7},{"location":"eval-tips/#copying-the-inline-results","title":"Copying the inline results","text":"

    There is a command called Copy last evaluation results, ctrl+alt+c ctrl+c.

    This works regardless if you have evaluated in a file editor or in a REPL window.

    ","boost":7},{"location":"eval-tips/#evaluating-in-a-repl-window","title":"Evaluating in a REPL window","text":"

    Since the REPL Window is mostly just a regular file, things work pretty similar at the REPL prompt. You use alt+enter to evaluate. Selecting the current form (default key binding ctrl+w on Mac and shift+alt+right on Windows and Linux) after evaluating will select the result.

    ","boost":7},{"location":"evaluation/","title":"Code Evaluation","text":"

    Calva tries to make it easy to evaluate code, supporting interactive development. The fastest path to learning about it is to use the Fire up the Getting Started REPL command, which you can learn more about in the Getting Started section.

    NB: The below assumes you have read about Finding Calva Commands and Shortcuts.

    ","boost":7},{"location":"evaluation/#interruptingstopping-running-evaluations","title":"Interrupting/stopping running evaluations","text":"

    Sometimes you evaluate things that take a very long time to complete, or might not even ever complete (infinite loops, lazy sequences, things like that). Calva has a command for interrupting running evaluations. You find it in the VS Code command palette, as well as in the REPL status bar item menu, when the REPL is connected.

    ","boost":7},{"location":"evaluation/#evaluation-in-a-file-editor","title":"Evaluation in a File Editor","text":"

    Calva has many commands for evaluating forms, including the current form and the current top-level form.

    Some of the commands also let you choose what should happen with the results:

    1. Inline. This will display the results (or some of it, if it is long) inline in the editor.
    2. This also creates a hover pane including the full results and a button which will copy the results to the clipboard.
    3. There is also a command for copying the last result to the clipboard.
    4. The full results are always available in the output window.
      • There is a command for showing the output window, allowing for a workflow where you either generally have it closed, or have it as one of the tabs in the same editor group as the files you are working with.
    5. To comments. This will add the results as line comments below the current line.
    6. Replace the evaluated code. This will do what it says, the evaluated code will be replaced with its results.
    ","boost":7},{"location":"evaluation/#wait-current-form-top-level-form","title":"Wait, Current Form? Top-level Form?","text":"

    These are important concepts in Calva in order for you to create your most effective workflow. This video explains it a bit:

    ","boost":7},{"location":"evaluation/#current-form","title":"Current Form","text":"

    Default shortcut for evaluating the current form: ctrl+enter.

    The current form either means the current selection, or otherwise is based on the cursor position. Play some with the command Calva: Select current form, ctrl+alt+c s, to figure out what Calva thinks is the current form for some different situations. Try it inside a symbol, adjacent to a symbol (both sides) and adjacent to an opening or closing bracket (again, both sides). Generally the current form is determined like so:

    1. If text is selected, then that text
    2. If the cursor is \u201din\u201d a symbol, then that symbol 
      foob|ar ; foobar\n
    3. If the cursor is adjacent to a form (a symbol or a list of some kind), then that form 
      (foo bar |(baz)) ; (baz)\n
    4. If the cursor is between to forms, then the left side form 
      (foo bar | (baz)) ; bar\n
    5. If the cursor is before the first form of a line, then that form 
      (foo\n| bar (baz)) ; bar\n
    ","boost":7},{"location":"evaluation/#current-top-level-form","title":"Current Top-level Form","text":"

    Default shortcut for evaluating the current top level form: alt+enter.

    The current top-level form means top-level in a structural sense. It is not the topmost form in the file. Typically in a Clojure file you will find def and defn (and defwhatever) forms at the top level, which also is one major intended use for evaluating top level form: to define and redefine variables. However, Calva does not check the contents of the form in order to determine it as a top-level forms: all forms not enclosed in any other form are top level forms.

    An \u201dexception\u201d is introduced by the comment form. It will create a new top level context, so that any forms immediately inside a (comment ...) form will be considered top-level by Calva. This is to support a workflow with what is often referred to the Rich Comments.

    At the top level the selection of which form is the current top level form follows the same rules as those for the current form.

    ","boost":7},{"location":"evaluation/#evaluate-enclosing-form","title":"Evaluate Enclosing Form","text":"

    The default keyboard shortcut for evaluating the current enclosing form (the list the cursor is in) is ctrl+shift+enter.

    (let [foo :bar]\n  (when false (str| foo))) ; => \":bar\"\n
    ","boost":7},{"location":"evaluation/#evaluate-to-cursor","title":"Evaluate to Cursor","text":"

    There are several commands for evaluating a piece of code, closing brackets. It's good, especially in threads, but can also come in handy in other situations, for instance when you want to evaluate something that depends on bindings, such as in a let form.

    ","boost":7},{"location":"evaluation/#evaluate-from-start-of-list-to-cursor-closing-brackets","title":"Evaluate From Start of List to Cursor, Closing Brackets","text":"

    This command evaluates the text from the start of the current enclosing list to where the cursor is, and it adds the missing closing bracket for you. Convenient for checking intermediate results in thread or doto, or similar pipelines. The cursor is right behind :d in this form:

      (->> [1 1 2 3 5 8 13 21]\n       (partition 2)\n       (zipmap [:a :b :c :d])\n       :d| ; => (13 21)\n       (apply -)\n       (Math/abs))\n

    The default shortcut for this command is ctrl+alt+enter.

    ","boost":7},{"location":"evaluation/#evaluate-selection-closing-brackets","title":"Evaluate Selection, Closing Brackets","text":"

    This is the most versatile of the \u201devaluation, closing brackets\u201d commands. It will do what it says. \ud83d\ude04 It's extra handy in combination with the command Paredit: Select Backward Up Sexp/Form (shift+ctrl+up). Consider this contrieved form (buggy code, because it was supposed to result in 42, not -42):

    (defn fortytwo-from-thirty\n  []\n  (let [thirty 30]\n    (-> thirty\n        inc            ;1\n        (send-off)\n        (+ 1 2 3)\n        (->>\n         (+ 2 2)       ;2\n         (+))\n        list\n        (->>\n         (into [1])\n         (reduce + 1))\n        (- 1)          ;3\n        (* -1))))\n

    At ;1, you can do backward up sexp (shift+ctrl+up) twice to select up to the (let ..), then issue Evaluate Selection, Closing Brackets. It has the same default keybinding as the command for evaluating the current list up to the cursor: ctrl+alt+enter.

    At ;2 you need select backwards up three times.

    ;3 is included because it is close to the bug. (Which was introduced when the thread-last, ->> was added to make this example.) Please practice the Evaluate Selection, Closing Brackets command to fix the bug.

    ","boost":7},{"location":"evaluation/#evaluate-from-start-of-top-level-form-to-cursor-closing-brackets","title":"Evaluate From Start of Top Level Form to Cursor, Closing Brackets","text":"

    This command has a default shortcut keybinding of shift+alt+enter. It will create a form from the start of the current top level form, up to the cursor, close all brackets, and this will then be evaluated. Good for examining code blocks up to a certain point. Often comes in handy in Rich comments ((comment ...)).

    Take this example and paste it in a file loaded into the REPL, then place the cursor in front of each line comment and try the command.

    (comment\n (do\n   (def colt-express\n     {:name \"Colt Express\"\n      :categories [\"Family\"\n                   \"Strategy\"]\n      :play-time 40\n      :ratings {:pez 5.0\n                :kat 5.0\n                :wiw 5.0   ; 1, then eval `colt-express`\n                :vig 3.0\n                :rex 5.0\n                :lun 4.0}})\n\n   (defn average [coll]\n     (/ (apply + coll) (count coll)))\n\n   (let [foo-express (-> colt-express\n                         (assoc :name \"Foo Express\")\n                         (assoc-in [:ratings :lyr] 5.0)\n                         (update-in [:ratings :vig] inc))]\n     (->> foo-express   ; 2\n          :ratings      ; 3\n          vals          ; 4\n          average       ; 5\n          ))))\n
    ","boost":7},{"location":"evaluation/#evaluate-from-start-of-file-to-cursor-closing-brackets","title":"Evaluate From Start of File to Cursor, Closing Brackets","text":"

    Yup, that command also exists. \ud83d\ude04

    ","boost":7},{"location":"evaluation/#copying-the-inline-results","title":"Copying the inline results","text":"

    There is a command called Copy last evaluation results, ctrl+alt+c ctrl+c.

    This works regardless if you have evaluated in a file editor or in a REPL window.

    ","boost":7},{"location":"evaluation/#evaluating-in-a-repl-window","title":"Evaluating in a REPL window","text":"

    Since the REPL Window is mostly just a regular file, things work pretty similar at the REPL prompt. You use alt+enter to evaluate. Selecting the current form (default key binding ctrl+w on Mac and shift+alt+right on Windows and Linux) after evaluating will select the result.

    ","boost":7},{"location":"fiddle-files/","title":"Fiddle Files Support","text":"

    In the podcast Functional Design in Clojure, Episode 014: Fiddle with the REPL, they discuss a workflow in which you keep some of your exploratory code in separate files, which they call Fiddle Files. It's like Rich Comments, and the files often consist of such comments. The Fiddle files are typically not on the classpath, and are only loaded in the REPL by you when you are developing your project. Some developers keep personal fiddle files. In some projects they are meant to be shared, and in other projects it's a combination.

    Calva has some extra support for the fiddle file workflow, beyond what VS Code offers in terms of navigating between files. The support comes in the form of three commands supported by a little configuration.

    ","boost":5},{"location":"fiddle-files/#the-three-fiddle-file-commands","title":"The Three Fiddle File Commands","text":"

    The commands let you quickly navigate between your implementation code (called Source here) and your Fiddle file, and to evaluate the Fiddle file without leaving the Source file.

    Command Action Shortcut Active Calva: Open Fiddle File for Current File Opens the Fiddle file corresponding to the current Clojure Source file. ctrl+alt+cf When the currently active file is not a Fiddle file. Calva: Open Source File for Current Fiddle File Opens the Source file corresponding to the current Fiddle file. ctrl+alt+cf When the currently active file is a Fiddle file + there is an existing, and corresponding, source file. Calva: Evaluate Fiddle File for Current File Evaluates the Fiddle file corresponding to the current Clojure Source file. ctrl+alt+cctrl+alt+f When the currently active file is not a Fiddle file.

    The commands for opening and evaluating corresponding Fiddle files will offer to Create the Fiddle file if it does not already exist. But the Calva: Open Source File for Current Fiddle File command will not offer to create the target file.

    What does corresponding mean here? Without any configuration Calva will look for \u201csibling\u201d files, where files with Clojure file extensions (E.g. .clj, .cljs, .bb) will be treated as Source files, and files with the .fiddle extension will be treated as Fiddle files. \"Sibling file\" here means residing side by side in the file system. If this default behaviour is not your cup of tea, there is some flexibility added by configuration.

    ","boost":5},{"location":"fiddle-files/#the-fiddle-file-configuration","title":"The Fiddle File Configuration","text":"

    To know how to map between Fiddle <-> Source files, Calva has three different modes of operation:

    1. The sibling files, as described above. This is the default. Example:
      • src/a/b/c.cljc corresponding to:
      • src/a/b/c.fiddle
    2. Parallel directory structures. Mapping a Source directory tree to a Fiddle directory tree. Example:
      • src/a/b/c.cljc corresponding to:
      • env/dev/fiddles/a/b/c.cljc
    3. A dedicated Fiddle file for a Source directory tree. E.g. both:
      • src/a/b/c.cljc and:
      • src/d/e/f.cljc corresponding to:
      • env/dev/fiddles/x.cljc

    The setting is named calva.fiddleFilePaths and is an array of source and fiddle root paths, relative to the project root.

    The Project Root

    It is important to note that the project root depends on whether you are connected to a REPL or not, and to which project you are connected, in case the workspace contains several projects.

    Without a REPL connection (disregarding that fiddle files are not very interesting then) the project root is the same as the first workspace root. And if you have a regular VS Code window open, it is the root of the folder you have opened in that window.

    With a REPL connection, the project root will be the root of the project, i.e. where the project file (deps.edn, project.clj, shadow-cljs.edn) is.

    ","boost":5},{"location":"fiddle-files/#example-configurations","title":"Example Configurations","text":"","boost":5},{"location":"fiddle-files/#single-parallel-directory-structure","title":"Single Parallel Directory Structure","text":"
    \"calva.fiddleFilePaths\": [\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddles\"]\n  }\n]\n

    This will make any file in the src directory tree correspond to a matching file with the same relative path. E.g.:

    ","boost":5},{"location":"fiddle-files/#single-dedicated-fiddle-file","title":"Single Dedicated Fiddle File","text":"

    If you generally work with one Fiddle file at a time, you can configure a mapping to a Dedicated Fiddle file. E.g.:

    \"calva.fiddleFilePaths\": [\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddle.clj\"]\n  },\n]\n

    This will make any file in the src directory tree correspond to the same Fiddle file. E.g.:

    Jumping from a dedicated fiddle to a source file

    Calva's command for opening the corresponding source file won't work in this case because it is a one->many situation. If you want to open the last file you worked with before using Open Fiddle File for Current File, consider using the VS Code command: Go Previous.

    ","boost":5},{"location":"fiddle-files/#multiple-mappings","title":"Multiple Mappings","text":"

    The configuration is an array so that you can configure different mappings for different Source directories. Given several mappings with overlapping Source, the longest mapping will win. Given several mappings with the same Source, the first one will win, unless one of them is a dedicated Fiddle, in which case that one will win.

    \"calva.fiddleFilePaths\": [\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddles\"]\n  },\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddle.clj\"]\n  },\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddle.cljs\"]\n  },\n  {\n    \"source\": [\"src\"],\n    \"fiddle\": [\"env\", \"dev\", \"fiddle.bb\"]\n  },\n  {\n    \"source\": [\"src\", \"b\"],\n    \"fiddle\": [\"env\", \"dev\", \"b-fiddles\"]\n  },\n]\n

    With this configuration we would get a behaviour like so:

    ","boost":5},{"location":"fiddle-files/#tips","title":"Tips","text":"

    Organize your Fiddle files such that they do not get automatically loaded as part of your application. This can lead to strange errors and hard-to-detect bugs. Most often it should only be you manually loading the fiddle file, not clj/clojure or Leiningen or any such system which loads your application.

    When you want your fiddle code to be evaluated in the same workspace as its corresponding Source file, you can use the same namespace declaration for both files. The linter might complain, but the REPL will happily comply.

    If you primarily evaluate the fiddle file using the provided command for it, from the Source files, you can omit the namespace declaration, and Calva will evaluate it in the namespace of the Source file.

    The linter and fiddle files

    For some fiddle files you will get a lot of linter warnings, because clj-kondo doesn't know about fiddle files, and they are often not on the classpath. You might find yourself wanting to silence some linters for some fiddle files. E.g. like this:

    (ns main.core\n  {:clj-kondo/config\n   '{:linters {:unresolved-symbol {:level :off}}}})\n

    See clj-kondo Configuration for more on what options you have for this.

    ","boost":5},{"location":"fiddle-files/#see-also","title":"See Also","text":"","boost":5},{"location":"finding-commands/","title":"Finding Calva Commands","text":"

    Calva relies a lot on that VS Code makes it really easy to find commands by opening the command palette: ctrl+shift+p (Windows/Linux), cmd+shift+p (Mac), and then start typing some words (or parts of words) that you think might be in the command.

    To leverage this, all Calva commands are prefixed with Calva. As an example, say you want to find commands related to evaluating the top level form. Then you can do this:

    1. Open the command palette
    2. Type calevtop

    VS Code will match cal to \u201dCalva\u201d, ev to \u201dEvaluate\u201d, and top to \u201dTop\u201d. It looks like so:

    As you can see on the screenshot, VS Code will also reveal the keyboard shortcut for each command. My advice is to make it a habit to try to remember those shortcuts and use them for a more effective workflow.

    Now might be a good time to see Calva Top 10 Commands

    "},{"location":"finding-commands/#all-the-settings-and-commands","title":"All the Settings and Commands","text":"

    Did you know? There is a complete list of Calva settings and commands in the Contributions tab of the Calva entry in the Extensions pane in VS Code.

    "},{"location":"finding-commands/#toggling-keyboard-shortcuts-onoff","title":"Toggling Keyboard Shortcuts On/Off","text":"

    The command calva.toggleKeybindingsEnabled can be used to quickly enable and disable (almost) all keyboard shortcuts. This allows you to quickly toggle between Calva keybindings and other keybindings which would otherwise not be available when Calva is enabled. This is particularly useful with the Paredit keyboard shortcuts, whose default shortcuts conflict with the default VS Code shortcuts for textual (non-structural) editing.

    By default it is not bound to a shortcut so as not to cause confusion by users unwittingly pressing it, but if this is something you'd like to use often, you may want to bind it to a shortcut.

    "},{"location":"formatting/","title":"Formatting","text":"

    We have tried to make Calva's formatter so that it just works. It is enabled by default for Clojure files, and with the default configuration it mostly follows Bozhidar Batsov's Clojure Style Guide. Calva uses cljfmt for the formatting.

    Tab formats the current surrounding form

    Calva's code formatter sets the default keybinding of its Format Current Form command to tab. Meaning that most often when things look a bit untidy, you can press tab to make things look pretty. Good to know, right? For performance reasons it only formats the current enclosing form, so sometimes you want to move the cursor up/out a form (ctrl+up) first. See The Paredit Guide for more on moving the cursor structurally through your code.

    With the default settings, Calva's formatting behaves like so:

    Infer parens at will

    Calva has a command that will \u201dheal\u201d the bracket structure if it is correctly indented using Parinfer Infer parens. This command is default bound to ctrl+alt+p i.

    Also: If you have Format on Save enabled in VS Code, it will be Calva doing the formatting for Clojure files.

    Calva's formatting is mostly about indenting, but it also (again, defaults):

    Not a fan of some default setting? The formatter is quite configurable.

    "},{"location":"formatting/#format-current-form-command-variants","title":"Format current form command variants","text":"

    There are three special commands for formatting the current form:

    "},{"location":"formatting/#1-format-and-align-current-form","title":"1. Format and Align Current Form","text":"

    Aligns associative structures and bindings in two columns. See more below.

    "},{"location":"formatting/#2-format-current-form-and-trim-space-between-forms","title":"2. Format Current Form and trim space between forms","text":"

    This formats the text, and trims consecutive, non-indent, whitespace on a line to just one space. Something like:

    (let [a    :b]\n(str \"foo\"     \"bar\" \"baz\"\n\"a\"    a))\n

    Becomes:

    (let [a :b]\n  (str \"foo\" \"bar\" \"baz\"\n       \"a\" a))\n

    Basically, it behaves like if :remove-multiple-non-indenting-spaces? true was added to the cljfmt config. Which, in fact, is what happens. Calva merges that onto your cljfmt config when this command is used.

    "},{"location":"formatting/#3-replace-current-form-or-selection-with-pretty-printed-form","title":"3. Replace Current Form (or Selection) with Pretty Printed Form","text":"

    This command will run the code of the Current Form through Calva's pretty printer (the engine named calva, which is using zprint) and replace the current form inline in the editor with the pretty printed results.

    Unlike with the \u201dreal\u201d Calva Formatter, which never breaks up lines, this one will follow your pretty printing options and break up lines if you have set maxWidth to something that calls for breaking up lines.

    Applies to the other Current Form

    Unlike the other Format commands, which applies to the current enclosing form, this one applies to the Current Form, same as with evaluations. That is because this is not really part of the Calva formatter, but rather is a convenience command for tidying up code or data.

    "},{"location":"formatting/#configuration","title":"Configuration","text":"

    You can adjust the above mentioned defaults, and the default indents, by configuring the formatting using cljfmt's configuration EDN.

    This configuration can either be provided via a file or via clojure-lsp. See Providing configuration via clojure-lsp below.

    "},{"location":"formatting/#providing-configuration-via-a-config-file","title":"Providing configuration via a config file","text":"

    Calva will look for the configuration in one of the default cljfmt paths ('.cljfmt.edn', '.cljfmt.clj', 'cljfmt.edn', or 'cljfmt.clj' in the workspace root). If your file is somewhere else use the calva.fmt.configPath to tell Calva where to find it. The path should either be absolute, or relative to the workspace root directory. If your config file is somewhere in the workspace root, Calva will hot reload it when you update it.

    Wherever the config file is, a suggested path for providing your configuration is to start changing the Calva formatting defaults by pasting the following map into a file and save it.

    {:remove-surrounding-whitespace? true\n :remove-trailing-whitespace? true\n :remove-consecutive-blank-lines? false\n :insert-missing-whitespace? true\n :remove-multiple-non-indenting-spaces? false}\n

    If the file is in the workspace, you can quickly test how different settings affect the formatting. Try:

    1. Adding :align-associative? true to the config
    2. then save
    3. then hit tab, and see what happens.
    :align-associative? is experimental

    This particular setting is experimental and known to cause trouble together with namespaced keywords. Consider using ctrl+alt+l instead of tab as your formatting command, instead of enabling this setting. See below for more info about this. See more below about this.

    No Leiningen config support

    The cljfmt docs mention the :cljfmt config key of Leiningen projects. Calva does not yet read the config from there, so if your Leiningen project has such a configuration, you will need to copy it out into a file.

    "},{"location":"formatting/#providing-configuration-via-clojure-lsp","title":"Providing configuration via clojure-lsp","text":"

    If you work in a team where some members use clojure-lsp for formatting, you can make Calva format using the same configuration by telling setting calva.fmt.configPath to CLOJURE-LSP (case sensitive). See Clojure LSP Settings) for how to provide the configuration. (It might not be provided from where you think it is, specifically check clojure-lsp's global config in you user home directory.) Use the command Calva Diagnostics: Clojure-lsp Server Info to see what cljfmt configuration is being used (under the cljfmt-raw key).

    Note that doing this you will not have hot reload of the formatting configuration, and of course you will be depending on that clojure-lsp is running and functioning.

    "},{"location":"formatting/#indentation-rules","title":"Indentation rules","text":"

    The cljfmt indents are highly configurable. They, and the rest of the configuration options, are masterly detailed here.

    :extra-indents vs :indents

    Since Calva v2.0.383 we are using cljfmt 0.11.x which has a breaking configuration change. From the cljfmt README:

    The :indents key has been split into :indents and :extra-indents. The :indents key replaces all default indents, while the :extra-indents key will append to the default indents.

    If something prevents you from using a config with :extra-indents, there's an escape hatch to keep using the :indents key as before, by adding :legacy/merge-indents? true to the config map.

    Calva is an extra good tool for experimenting with these settings. cljfmt doesn't care about keys in the map that it doesn't know about so you can sneak in test code there to quickly see how it will get formatted by certain rules. Try this, for instance:

    {:remove-surrounding-whitespace? true\n :remove-trailing-whitespace? true\n :remove-consecutive-blank-lines? false\n :insert-missing-whitespace? false\n :indents {#re \"^\\w\" [[:inner 0]]}\n :test-code\n (concat [2]\n         (map #(inc (* % 2))\n              (filter #(aget sieved %)\n                      (range 1 hn))))}\n

    Save, then hit tab, and the code should get formatted like so:

     :test-code\n (concat [2]\n    (map #(inc (* % 2))\n      (filter #(aget sieved %)\n        (range 1 hn))))\n

    That's somewhat similar to Nikita Prokopov's Better Clojure Formatting suggestion. (Please be aware that this setting might not be sufficient to get complete Tonsky Formatting, please share any settings you use to get full compliance.)

    "},{"location":"formatting/#rich-comments","title":"Rich Comments","text":"

    To encourage use of (comment ...) forms for development, the default settings give these forms get a special treatment when formatting. Use the calva.fmt.keepCommentTrailParenOnOwnLine setting to control this behaviour. See Rich Comments first.

    "},{"location":"formatting/#etecetera","title":"Etecetera","text":""},{"location":"formatting/#about-aligning-associative-forms","title":"About aligning associative forms","text":"

    Calva loooks in the config map for the key :align-associative? and if it is true it will use an old version of cljfmt which is patched with functionality for doing this alignment. Note, though:

    You are hereby warned, and let us also remind you about the Format and Align Current Form command which lets you apply this formatting a bit more surgically, and on demand.

    This old version of cljfmt is inlined in the Calva repository along with the discontinued rewrite-cljs project. Regard it as frozen code. If you want Calva's formatter to have full support for newer Clojure constructs and the bugs in the alignment code fixed, contribute to cljfmt. See this issue for starting to collect context.

    "},{"location":"get-started-with-clojure/","title":"Get Started with Clojure","text":"

    Welcome to a zero-install, interactive, guide to get you started with Clojure using:

    I have VS Code and Java

    Clojure runs on the JVM. How to install it is a big topic. Since you have already done that, you can, if you want, choose to install Calva in your local VS Code and fire up the Getting Started REPL. By all means read this page anyway, you can just skip the Gitpod parts.

    Also: If you are using Windows your Java might have a bug that prevents things from working. Then you might want to defer fixing that and use the zero-install option first.

    Is Gitpod Code exactly as VS Code?

    Almost! But, yeah, there are some difference between regular VS Code and Gitpod's ditto. Most of it doesn't matter, but finding the main menu can be a bit tricky:

    ","boost":10},{"location":"get-started-with-clojure/#what-youll-learn","title":"What you'll learn","text":" I am not convinced I should spend time on learning Clojure

    Fair enough. We can recommend watching any or all of these videos to get excited about Clojure and the rather unique mood of development it offers:

    ","boost":10},{"location":"get-started-with-clojure/#what-you-wont-learn","title":"What you won't learn","text":" Why won't I learn about this?

    All in due time. \ud83d\ude04 It can be a bit confusing with all the things you find out about installing Clojure and creating projects when searching for information about it. We want you to relax about all that and just enjoy learning a bit about this fantastic programming language and the wonderful mode of development it offers.

    There is a lot of info about this out there already. And since you will learn where to find Clojurians, you will also find guidance. But we suggest do these things later. First, let's focus on having fun with Interactive Programming!

    ","boost":10},{"location":"get-started-with-clojure/#what-you-need","title":"What you need","text":" The browser ate my keyboard shortcuts!

    There is always a competition for which system gets to catch keyboard shortcuts first. This worsens a bit when an application like VS Code runs in the web browser. Remember this if some shortcut/command doesn't work.

    On some machines, with some web browsers, some shortcuts are caught by the web browser and instead re-opening a closed tab or whatever. These have been observed:

    Sometimes the workaround is to redefine the shortcuts in VS Code, sometimes making your web browser stop catching the shortcut.

    I am new to VS Code

    You might want to have a look at this Getting Started with VS Code video. (You can of course ignore the parts about installing for now.) Also, have this overview of the VS Code interface handy.

    ","boost":10},{"location":"get-started-with-clojure/#how-it-works","title":"How it works","text":"
    1. You will open an instance of VS Code in a development environment running in the browser. The environment will have Java, Clojure tools, and Calva installed.
      • Gitpod Sign-in You will be asked to sign in to Gitpod, if you aren't already. You need to use the \u201dSign in with GitHub\u201d option.
    2. Instructions will be automatically displayed (very brief such, because it is mainly about firing up the Getting Started REPL)
    3. The guides are a mix of prose (in Clojure line comments), Clojure code, and exercises. What's extra poetic is that you will use Calva and Clojure to learn Calva and Clojure.

    Use a desktop/laptop computer. Even if it actually works on the phone, it is far from convenient.

    It sometimes takes a while (several minutes) for the environment to initialize. Take some deep breaths and be patient. \ud83d\ude0e

    ","boost":10},{"location":"get-started-with-clojure/#lets-go","title":"Let's go!","text":"

    Ready? Awesome. Click this button to start the guide in a new browser tab.

    https://gitpod.io/#https://github.com/PEZ/get-started-with-clojure Stuck? Something not working? Or just unclear?

    Please don't hesitate to reach out for help, should you get stuck. See below for where to find Clojurians. As for the Calva team, we are almost always (true story) to be found at the Clojurians Slack, especially in the #calva Channel. We are @pez and @bringe there.

    Happy Interactive Programming! \u2764\ufe0f

    ","boost":10},{"location":"get-started-with-clojure/#and-where-do-i-find-those-clojurians","title":"And where do I find those Clojurians?","text":"

    We Clojurians inhabit a lot of community platforms. I'll list some of the more popular ones here in some order of popularity.

    You can also ask questions, and find answers, about Clojure at ask.clojure.org

    ","boost":10},{"location":"get-started-with-clojure/#learn-and-practice-clojure-using-rich-4clojure","title":"Learn and Practice Clojure using Rich 4Clojure","text":"

    If you like the style of interactive learning that this guide provides, you should definitely check Rich 4Clojure out. It also can be used in the zero-installed way.

    You can regard it as a companion to this guide. It is aimed at practicing Clojure, starting at the elementary levels, bringing you to advanced stuff.

    Can I use Rich 4Clojure instead of this guide?

    We suggest you start by opening up this guide and do the Calva part of the excerises. Then use the welcome_to_clojure.clj guide in combination with Rich 4Clojure..

    ","boost":10},{"location":"get-started-with-clojure/#run-the-clojure-exercism-track-in-your-browser","title":"Run the Clojure Exercism Track in your browser","text":"

    In a similar manner to the Get Started with Clojure project, you can run the Clojure Exercism Track in your browser without installing anything and with full Interactive Programming enabled using this Template project.

    ","boost":10},{"location":"get-started-with-clojure/#clojuredocs","title":"ClojureDocs","text":"

    Clojurians draw tremendous value from ClojureDocs. At ClojureDocs the concise documentation for Clojure core functions, etcetera, are amended with examples and advice from fellow Clojurians. Crowdsourcing at its very best! It is a big part of the reason why you won't find an abundance of Clojure information at StackOverflow.

    ","boost":10},{"location":"get-started-with-clojure/#other-learning-resources","title":"Other learning resources","text":"","boost":10},{"location":"get-started-with-clojure/#help-us-help-beginners","title":"Help us help beginners","text":"

    Give us feedback. Spread the word. Please consider:

    Please also consider other ways to contribute.

    Thanks! \ud83d\ude4f

    ","boost":10},{"location":"getting-started/","title":"Getting Started","text":"

    Depending on wether you want to just start a Clojure REPL or you have a project you want to work with, getting started looks similar but a bit different. Regardless, you need to first:

    ","boost":10},{"location":"getting-started/#install-vs-code-and-calva","title":"Install VS Code and Calva","text":"
    1. Downloading VS Code and run the installer.
      • Also get aquainted to the basics of VS Code, if you aren't already. Here's an excellent intro: Getting Started with VS Code
    2. Install Calva. The easiest way to do that is to start VS Code and search for Calva in the VS Code Extension pane, then click Install.
    ","boost":10},{"location":"getting-started/#say-hello-to-calva","title":"Say hello to Calva","text":"

    If you have a Clojure or ClojureScript project, you will be interested in how to get Calva connected to the REPL of your project. But before you run over there, you might want to familiarize yourself with Calva a bit, which you can do without a project.

    The demo tells you about the command (and some about the Clojure Beginner's material that it makes available).

    I am completely new to Clojure

    The \u201dGetting Started\u201d REPL below introduces you to Clojure as well as to Calva. You might however, not want to start with installing the right version of Java and such to run the guide. If so you should definitely check the Get Started with Clojure guide on this site.

    Three clicks will have you running Calva in your browser with the REPL ready to serve.

    I don't have Java installed

    If you like, you can defer installing anything at all and still get started with Calva (not kidding).

    See Get Started with Clojure.

    ","boost":10},{"location":"getting-started/#theres-a-getting-started-repl","title":"There's a \u201dGetting Started\u201d REPL","text":"

    If you are new to Calva, a good place to start is using the command Fire up the \u201dGetting Started\u201d REPL. (You can open the command palette using the VS Code top menu by going to View -> Command Palette... or by running the associated keyboard shortcut for your OS.) Demo:

    It will open up a three files in a temporary directory, and start and connect a REPL. The files are:

    The only prerequisite here is that you have Java installed. No pre-installed clojure tools required. (You will want to install these tools later, of course.)

    Note

    On Windows the Oracle Java installer sets Java up in some funny way so that the Getting Started REPL fails to start. We are figuring about workarounds for this, but for now, if you are on Windows, you will need to make VS Code have some other Java in the PATH of its environment for this feature to work. See this issue on the Calva repo for more on this, including any progress.

    ","boost":10},{"location":"getting-started/#there-are-standalone-clojurescript-quick-start-repls","title":"There are standalone \u201dClojureScript Quick Start\u201d REPLs","text":"

    Without creating a project structure or installing anything but Calva, you can start standalone ClojureScript REPLs both in a browser and for node:

    The browser REPL app looks like so:

    ","boost":10},{"location":"getting-started/#you-have-a-project","title":"You have a Project?","text":"

    If you are new to Calva, please consider the above option first. Then when it will be time to get Calva connected to the REPL of your project.

    ","boost":10},{"location":"getting-started/#clojure-resources","title":"Clojure Resources","text":"

    If you are new to Clojure or ClojureScript altogether, please check out the guide material on the respective official sites:

    There are also many great books on Clojure. Clojure for the Brave and True can be read for free online. It is a great resource for beginners.

    ","boost":10},{"location":"getting-started/#there-is-also-standalone-repl","title":"There is also Standalone REPL","text":"

    When you are more familiar with Calva, and want a standalone REPL, there is a separate command: Start a standalone REPL (not in project). It will open up a user.clj in a temporary directory, containing only an (ns user) form, and start and connect the REPL.

    ","boost":10},{"location":"getting-started/#dram-where-the-guides-live","title":"Dram - Where the Guides Live","text":"

    The command for starting the Getting Started REPL will download the files from this repository. It is very much work in progress, and there is not even a finished Clojure Beginner's Guide there yet. When you run the command again, and from then on, you will get the option to download new files or keep using your existing. Downloading new ones will not overwrite your existing ones, because they will be downloaded to a new temp directory. You can find the directory easily using VS Codes context menu command for revealing a file in the Explorer/Finder.

    ","boost":10},{"location":"getting-started/#one-last-thing","title":"One Last Thing","text":"

    Happy coding! \u2665\ufe0f

    ","boost":10},{"location":"hiccup/","title":"Converting HTML to Hiccup","text":"

    Calva can help you convert HTML to Hiccup.

    ","boost":7},{"location":"hiccup/#features","title":"Features","text":"","boost":7},{"location":"hiccup/#three-commands","title":"Three commands","text":"

    The resulting data structure is formatted with zprint using it's :style :hiccup configuration.

    ","boost":7},{"location":"hiccup/#conversion-capabilities","title":"Conversion capabilities","text":"

    In addition to, optionally, being able to convert style attributes to maps and kebab-case attributes, the conversion:

    ","boost":7},{"location":"hiccup/#it-is-somewhat-configurable","title":"It is somewhat configurable","text":"

    The Hiccup converstion can be tweaked with two options using the setting calva.html2HiccupOptions, which is a map/object:

    ","boost":7},{"location":"hiccup/#copy-as-menus-copy-html-as-hiccup","title":"Copy as menus: Copy HTML as Hiccup","text":"

    The Copy HTML as Hiccup command is available from VS Code's Edit menu, as well as the editor context menu, in both cases under the Copy as sub menu.

    ","boost":7},{"location":"hiccup/#the-commands-take-arguments","title":"The commands take arguments","text":"

    This options map can also be provided as an argument to the commands, so you can bind keyboard shortcuts to a particular configuration for the conversion.

    The command calva.convertHtml2Hiccup takes a map as an argument:

    The calva.pasteHtmlAsHiccup and calva.copyHtmlAsHiccup commands takes only a calva.html2HiccupOptions map.

    ","boost":7},{"location":"hiccup/#example-keyboard-shortcuts","title":"Example keyboard shortcuts","text":"

    The commands have no default keyboard shortcuts, you use the Command Palette to execute them, or you bind your own shortcuts. Here are some examples:

        // calva.convertHtml2Hiccup\n    {\n        // With args, `\"toUntitled\": true` is necessary for keyboard shortcuts\n        // without it, the command just returns the result to the caller\n        \"key\": \"ctrl+alt+c ctrl+h\",\n        \"command\": \"calva.convertHtml2Hiccup\",\n        \"args\": {\"toUntitled\": true, \"options\": {\"mapify-style?\": false}}\n    },\n    {\n        // Only for completeness, providing the HTML is only useful from e.g. Joyride \n        \"key\": \"ctrl+alt+c shift+h\",\n        \"command\": \"calva.convertHtml2Hiccup\",\n        \"args\": {\"html\": \"<foo style='a: b' bar='baz'>gaz<foo>\", \"toUntitled\": true}\n    },\n    {\n        // Without args, the command uses the `calva.html2HiccupOptions` configuration\n        // And writes the results to an Untitled document\n        \"key\": \"ctrl+alt+c h\",\n        \"command\": \"calva.convertHtml2Hiccup\",\n    },\n\n    // calva.pasteHtmlAsHiccup\n    {\n        // Override the `calva.html2HiccupOptions` configuration\n        \"key\": \"ctrl+alt+h ctrl+v\",\n        \"command\": \"calva.pasteHtmlAsHiccup\",\n        \"args\": {\"mapify-style?\": true, \"kebab-attrs?\": true}\n    },\n    {\n        // Without args, the command uses the `calva.html2HiccupOptions` configuration\n        \"key\": \"ctrl+alt+h v\",\n        \"command\": \"calva.pasteHtmlAsHiccup\"\n    },\n\n    // calva.copyHtmlAsHiccup\n    {\n        // Override the `calva.html2HiccupOptions` configuration\n        \"key\": \"ctrl+alt+h ctrl+c\",\n        \"command\": \"calva.copyHtmlAsHiccup\",\n        \"args\": {\"mapify-style?\": false, \"kebab-attrs?\": true}\n    },\n    {\n        // Without args, the command uses the `calva.html2HiccupOptions` configuration\n        \"key\": \"ctrl+alt+h c\",\n        \"command\": \"calva.copyHtmlAsHiccup\"\n    },\n

    The default/args-less bindings are placed last because reasons.

    ","boost":7},{"location":"hiccup/#using-from-joyride-or-some-other-vs-code-extension","title":"Using from Joyride (or some other VS Code extension)","text":"

    As with any VS Code command using these from Joyride is a matter of calling executeCommand.

    ","boost":7},{"location":"hiccup/#calvapastehtmlashiccup-and-calvapastehtmlashiccup","title":"calva.pasteHtmlAsHiccup and calva.pasteHtmlAsHiccup","text":"
    (-> (vscode/commands.executeCommand \"calva.pasteHtmlAsHiccup\"\n                                    #js {:mapify-style? true})\n    (.then ...))\n\n(-> (vscode/commands.executeCommand \"calva.copyHtmlAsHiccup\"\n                                    #js {:mapify-style? true})\n    (.then ...))\n
    ","boost":7},{"location":"hiccup/#calvaconverthtml2hiccup","title":"calva.convertHtml2Hiccup","text":"

    Without options the command behaves just like selecting the command from the command palette. If there is a selection it will be converted, otherwise the whole file. The result will be opened in a new Untitled document.

    (-> (vscode/commands.executeCommand \"calva.convertHtml2Hiccup\")\n    (.then ...))\n

    Called with arguments it will by default return an object with a .-result member which is a string with the Hiccup.

    (-> (vscode/commands.executeCommand \"calva.convertHtml2Hiccup\" \n                                    #js {:html \"<foo class='clz1 clz2>bar</foo>\"})\n    (.then #(println (.-result %))))\n\n(-> (vscode/commands.executeCommand \"calva.convertHtml2Hiccup\" \n                                    #js {:options #js {:mapify-style? false}})\n    (.then #(println (.-result %))))\n

    To make it put the text in a new Untitled document instead, provide the argument option :toUntitled true

    (-> (vscode/commands.executeCommand \"calva.convertHtml2Hiccup\" \n                                    #js {:toUntitled true\n                                         :html \"<foo class='clz1 clz2>bar</foo>\"\n                                         :options #js {:mapify-style? true\n                                                       :kebab-attrs? true}})\n    (.then ...))\n
    ","boost":7},{"location":"inspector/","title":"Unfold that data","text":"

    All REPL evaluation results are added to the Calva Inspector, a tree view that lets you expand and collapse Clojure data structures. (This happens in addition to results being printed to the configured Output Destination.)

    Only for realized data

    Results are added to the inspector after they have been processed by your pretty printer, if you have pretty printing enabled. This means that maxLength and maxDepth applies. The inspector can't be used to explore infinite sequences.

    "},{"location":"inspector/#uifeatures","title":"UI/Features","text":"

    The inspector view can be placed in the left or right side bars, or in the bottom panel. It can also be placed as a section in an existing side bar view, or in split with any existing bottom panel view.

    Inspector items are not expandable until you make them so with the Inspect Result Item button. This is because parsing and building the structure for the tree can take a little while and we don't want it to lock the UI for you when you edit and evaluate code.

    Speaking of buttons. Items in the view have context commands that show up as buttons on hover. The Inspect Result Item button is one of them. All rows in the inspector have a Copy button, letting you copy the data at any folding level to the clipboard.All root items also have a clear button for removing the item from the inspector.

    The view itself has two buttons, one for clearing all results and one for pasting whatever is on the clipboard as an inspector item.

    "},{"location":"inspector/#commands","title":"Commands","text":"

    There are four commands for the inspector:

    The command for adding the current form to the inspector has a command ID of calva.addToInspector. The command takes an optional argument, a string to be added. This is meant for Joyride scripts that want to add things to the inspector.

    "},{"location":"inspector/#configuration","title":"Configuration","text":"

    There is only one setting for the inspector: calva.autoOpenInspector controls wether the view is revealed as part of connecting the REPL to Calva. It defaults to false.

    "},{"location":"jack-in-guide/","title":"Learn about Calva Jack-in","text":"

    The Calva Jack-In Academy, by @pez

    Like with CIDER Jack-in, Calva's let-me-help-you-start-your-project-and-connect feature might seem a bit mysterious. It really is helpful, but also really isn't mysterious. Here are a few things about it that is good to know about.

    Note

    If you came here to find out how to configure the versions of the dependencies that Calva Jack-in injects, see Customizing Calva - Jack-in Dependency Versions.

    ","boost":6},{"location":"jack-in-guide/#what-it-solves","title":"What it Solves","text":"

    At first it might seem that something like lein repl in a terminal and then connecting Calva is enough. It sometimes might be, but only if you are in luck. To provide many of its IDE features, Calva relies on nREPL middleware, mainly cider-nrepl and, for ClojureScript, piggieback. When starting your Clojure(Script) app and its REPL, it needs to be started with these dependencies satisfied. There are mainly three ways this can be achieved.

    1. In the project definition (files like project.clj, deps.edn, shadow-cljs.edn, and combination of these).
    2. In your user profile (files like ~/.lein/profiles.clj and ~/.clojure/deps.edn).
    3. On the command line.

    Because 1 and 2 are hard to keep in sync with the various editor environments people in your project might be using, Calva Jack-In is about 3.

    Ideally, you will be able to rid your project files completely of editor dependencies when people working on the project can rely on the Jack-In features of their Clojure editor.

    ","boost":6},{"location":"jack-in-guide/#a-controlled-shell-command","title":"A Controlled Shell Command","text":"

    At its core Calva Jack-In is just a glorified, REPL-starting, command-line. No, it is more than that, but anyway. The command line can look like so for a Leiningen project using legacy Figwheel for its ClojureScript assistance:

    lein update-in :dependencies conj '[nrepl\"0.6.0\"]' -- update-in :dependencies conj '[cider/piggieback\"0.4.1\"]' -- update-in :dependencies conj '[figwheel-sidecar\"0.5.18\"]' -- update-in :plugins conj '[cider/cider-nrepl\"0.22.4\"]' -- update-in '[:repl-options :nrepl-middleware]' conj '[\"cider.nrepl/cider-middleware\"]' -- update-in '[:repl-options :nrepl-middleware]' conj '[\"cider.piggieback/wrap-cljs-repl\"]' -- with-profile +dev repl :headless\n

    Even if a bit long, it might look simple enough. But actually it has taken quite some effort to make Calva craft it. Shell quoting can be really tricky. Look at how '[nrepl\"0.6.0\"]' doesn't have a space between nrepl and the version. That was the only way I could find that was cross platform enough to make all supported shells parse the command line. (The trick relies on that the string is read by the super reliable Clojure Reader, which does not need that space to tokenize it.)

    It is awesome that Clojure is used on so many platforms, but for a tool smith this also means more work. (I think Windows and its shell hell ate up about 95% of the many hours spent on getting the quoting good enough.)

    The command-line crafted is then used to start a shell command that Calva controls, but we are getting ahead of ourselves...

    ","boost":6},{"location":"jack-in-guide/#project-types-builds-aliases-profiles-etcetera","title":"Project Types, Builds, Aliases, Profiles, etcetera","text":"

    In order to cook the right command for your project, Calva looks for project files, reads them, and figures out what possible project types and ClojureScript tools could be involved. Then Calva presents you with a menu with the options it has found. You need to know enough about your project to answer this question. It looks like this in a shadow-cljs project that uses a deps.edn file for setting up its classpath.

    (I know enough about this particular project to know that I should choose the shadow-cljs project type.)

    But Calva isn't ready to cook the command-line just yet. Depending on the project type, and contents of your project files, more info is needed. E.g. in the case of shadow-cljs projects, Calva needs to know what builds to start.

    Here you can select any combination of builds defined in the project, and Calva will cook a command line that starts them.

    You might get more prompts from Calva before it issues the command, but for this example project, Calva goes ahead, cooks the command line, and issues it. On my Mac, it looks like so:

    npx shadow-cljs -d cider/piggieback:0.4.1 -d cider/cider-nrepl:0.22.4 watch :app\n

    (Much shorter than the one with lein-figwheel, right? It is because shadow-cljs is aware of CIDER dependencies, so it doesn't need as many dependencies specified as some other project types do.)

    ","boost":6},{"location":"jack-in-guide/#connecting","title":"Connecting","text":"

    When the command is issued Calva needs to wait until the REPL Server is started, before connecting to it and possibly continuing with starting a ClojureScript REPL and connecting to that as well. It also needs to know which port to connect to.

    Because reasons, Calva can't yet read the stdout of the shell command it has issued, so to know when the REPL server is started, and on which port, Calva monitors the filesystem for the .nrepl-port file. (This file is not always named like that. shadow-cljs, for instance, creates the file .shadow-cljs/nrepl.port.)

    When the port file is created, Calva picks up the port number from it and connects to the nREPL server. At this point you have a Clojure REPL backing your Calva session, providing all sorts of nice IDE help for you.

    ","boost":6},{"location":"jack-in-guide/#starting-your-clojure-app","title":"Starting Your Clojure App","text":"

    Once you have the Clojure REPL connected you can start your Clojure app/server. See Custom Connect Sequences for how to let Calva do this for you automatically. See the same article for ways to automate more of the Jack-In process. It can be brought down to a single Jack-In command/action, even for a full stack Clojure and ClojureScript application.

    ","boost":6},{"location":"jack-in-guide/#clojurescript","title":"ClojureScript","text":"

    For ClojureScript, things are not done yet, though, far from it. It turns out that cooking the command line was the easy part.

    In order for Calva to provide REPL power for ClojureScript projects, several things need to happen:

    1. A Clojure nREPL connection needs to be established. We've covered that above. Calva makes an nREPL session clone to use for the ClojureScript REPL and then:
    2. Your ClojureScript app needs to be compiled.
    3. Your ClojureScript app needs to be started.
    4. The Clojure nREPL session needs to be promoted to a ClojureScript nREPL session. (This is what piggieback helps with.)
    ","boost":6},{"location":"jack-in-guide/#compiling-the-app-and-watchers","title":"Compiling the App and Watchers","text":"

    Depending on ClojureScript project type, Calva uses different methods to start the compilation and the watcher:

    This results in a bit of difference in the user interaction. Mainly that for shadow-cljs, the user needs to check the Jack-In Terminal tab to follow what's going on.

    ","boost":6},{"location":"jack-in-guide/#starting-the-app","title":"Starting the App","text":"

    Number 3 above, the app needs to be started, might seem obvious, but it actually trips many people up. Because of this, Calva goes to quite some lengths to provide assistance. Many projects are configured not to spawn a browser session automatically, requesting the app once it has been compiled, so we can't rely on that.

    What Calva does instead is to monitor the output of the commands it uses for starting the compilation, looking for information that the app is ready to be requested/started. It then tells the user this, providing a URL, in case it is a browser app. (There are also settings that tell Calva to open the URL automatically for you, regardless what the project settings are.)

    ","boost":6},{"location":"jack-in-guide/#connecting_1","title":"Connecting","text":"

    Meanwhile, Calva is monitoring the output and when it sees that the app is started, it continues to hook up the REPL connection to the editor.

    This whole connection sequence is quite configurable, using Custom Connect Sequences. In fact, Calva's built in ClojureScript sequences (Figwheel Main, lein-figwheel, shadow-cljs, and ClojureScript built-ins for both Browser and Node) are all built using those same settings mechanisms.

    ","boost":6},{"location":"jack-in-guide/#shadow-cljs-is-less-managed-by-calva","title":"shadow-cljs is Less Managed by Calva","text":"

    NB: The managed way in which Calva creates and connects the ClojureScript REPL breaks apart a bit for shadow-cljs, which works a bit differently and also outputs most of the information Calva is looking for on the stdout of the REPL start command (where Calva can't see it, remember?). We'll figure out a better way to support shadow-cljs, but for now, the user needs to do more of this figuring out than is needed with Figwheel projects.

    ","boost":6},{"location":"jack-in-guide/#hack-away","title":"Hack Away","text":"

    So, there are things going on when you start Jack-In, and even more things for ClojureScript projects, but Calva tries to keep it together, so as a user it is a matter of paying attention and responding to a few prompts/menus with pre-populated options (prompts which can be configured away, even).

    ","boost":6},{"location":"jack-in-guide/#switch-clojurescript-builds","title":"Switch ClojureScript Builds","text":"

    Once the REPL is connected you might want to change which ClojureScript build you have Calva connected to. For this Calva has the Select CLJS Build Connection command. Please note that you can only switch between builds that you have started.

    ","boost":6},{"location":"jack-in-guide/#play-with-starting-the-cljs-repl-yourself","title":"Play With Starting the cljs-repl Yourself","text":"

    To get a good grip on what is going on when creating and connecting the ClojureScript REPL, I can recommend making a custom connect sequence which leaves the REPL unpromoted (e.g. give it nil as connectCode), and then evaluate the cljs-repl start commands yourself. So for instance, promoting it to a ClojureScript Node.js REPL looks something like so:

    user=> (require 'cljs.repl.node)\nuser=> (cider.piggieback/cljs-repl (cljs.repl.node/repl-env))\nClojureScript 1.10.844\nTo quit, type: :cljs/quit\nnil\ncljs.user=> |\n

    It is the piggieback middleware there telling you that you can unpromote the REPL by \u201devaluating\u201d :cljs/quit.

    ","boost":6},{"location":"jack-in-guide/#about-full-stack-applications","title":"About Full Stack Applications","text":"

    Because Calva uses the Clojure REPL connection to spawn the ClojureScript REPL, and because Calva only handles one Clojure REPL per VS Code window, some projects need special handling by the user.

    If your full stack project is using shadow-cljs for the frontend, like this Fulcro template project does, maybe you first try to Jack-In to your backend Clojure REPL, and then to your shadow-cljs frontend. This works if you do it in separate VS Code windows, but if you do it in the same window, the second Jack-In will kill the backend session! See also connect shadow-cljs in fullstack projects.

    See Workspace Layouts for tips about how to open the same project folder in two separate VS Code windows.

    Please also consider to play around with starting the REPL and ClojureScript wiring entirely from the terminal, see this example project for some instructions on that. You can also use that project together with the nil for connectCode sequence mentioned above.

    ","boost":6},{"location":"jack-in-guide/#please-grab-your-calva-jack-in-certificate","title":"Please Grab your Calva Jack-In Certificate","text":"

    There, you now know all there is to know about Calva Jack-In.

    Just kidding, there are a few more details to it, some of which might find their way into this article at a later time.

    To really get to know it all, you will need to spend some time with the Calva Jack-In code. Head over to the Calva Development Wiki to learn how to hack on Calva.

    ","boost":6},{"location":"joyride/","title":"Using Calva With Joyride","text":"

    Joyride is a VS Code extension for user space scripting of VS Code itself. You find the extension here. The scripting language for Joyride is the best you language imaginable: Clojure. And, as is proper for a Clojure implementation, it has a REPL, even an nREPL server.

    This means you can connect Calva to Joyride and interactively develop your VS Code scripts.

    This video shows Joyride in action, using Calva as the nREPL client.

    "},{"location":"joyride/#how-to-connect","title":"How to connect","text":"

    Once you have the Joyride extension installed you can start its REPL and connect Calva to it (a.k.a Jack-in).

    Start the Joyride REPL and Connect

    This 1 minute video shows the following steps:

    1. Installing the Joyride Extension
    2. Isssuing the command Calva: Start a REPL in your Project and (a.k.a Jack-in)
    3. Selecting joyride project type
    4. Isssuing the command Calva: Load/Evaluate Current File and its Requires/Dependencies
    5. Evaluating some non-vscode code
    6. Evaluating code exercising something from the VS Code API

    (Right-click the video and choose Full Screeen if it is too tiny embedded.)

    "},{"location":"joyride/#how-to-get-started-with-joyride","title":"How to Get Started with Joyride","text":"

    The Joyride README has some Quick Start pointers for you. Please feel invited to the #joyride channel on the Clojurians Slack and chat with us and other Joyride users.

    Come on, Join the Joyride! \u2764\ufe0f

    "},{"location":"krell/","title":"Using Calva With Krell","text":"

    Krell is \u00e0 la carte ClojureScript tooling for React Native.

    Even if Calva does not yet have built-in support, all is not lost. You can add support yourself by way of a Custom REPL Connect Sequence. Here's how;

    "},{"location":"krell/#starting-the-krell-clojurescript-repl","title":"Starting the Krell ClojureScript REPL","text":"

    Add this REPL Connect Sequence to your workspace settings.json:

        \"calva.replConnectSequences\": [\n        {\n            \"name\": \"deps.edn + Krell\",\n            \"projectType\": \"deps.edn\",\n            \"cljsType\": {\n                \"connectCode\": \"(require '[clojure.edn :as edn] \\n    '[clojure.java.io :as io]\\n    '[cider.piggieback] \\n    '[krell.api :as krell]\\n    '[krell.repl])\\n\\n(def config (edn/read-string (slurp (io/file \\\"build.edn\\\"))))\\n(apply cider.piggieback/cljs-repl (krell.repl/repl-env) (mapcat identity config))\",\n                \"dependsOn\": \"User provided\"\n            }\n        }\n    ]\n

    Then issue the command Start a Project REPL and Connect (aka Jack-In). It start the project and connect to the Krell REPL once the app is running on a device (wether real or virtual/emulated).

    "},{"location":"krell/#additional-vs-code-tips","title":"Additional VS Code Tips","text":"

    For a smooth workflow you can also:

    Together with the connect sequence this will make for a start of a Krell session like this:

    1. Open the project root in VS Code
    2. Issue the Jack-in command
    3. Issue the React Native; Run Android on Emulator (or Run iOS on Simulator) command. (Disable Fast Refresh from the *React Native dev menu, if it is enabled.)
    4. Issue the React Native: Run Element Inspector command (You might need to install the React Native inspector globally): ```sh yarn global add react-devtools ````
    5. Launch Debugger (F5)
    6. Hack away, with hot reload and interactive REPL

    Once the debugger (a Chrome session) is running, you probably will want to enable Custom Formatters in order for clojure structures to be logged conveniently.

    "},{"location":"linting/","title":"Linting","text":"

    Calva does no linting, yet with Calva you get excellent linting. That is because Calva uses clojure-lsp, which provides linting powered by clj-kondo.

    clj-kondo comes with great default rules, and the configuration can be customized. One of your options for the configuration file is to placed a config.edn file in .clj-kondo/ at the root of your project. This folder may or may not already exist. It is safe to create it manually if it doesn't.

    The configuration will be merged with the default set of rules, you can only specify the rules you want to override. The full list of available options can be found on clj-kondo's github

    clojure-lsp is customizable, see Clojure LSP Settings for your options. It is safe to manually create the .lsp folder if it doesn't exist.

    You might want to read about how to configure clj-kondo. These two sections might be of extra interest:

    If you see a linting squiggle under the first character of the file with an error you don't quite understand, it is probably something wrong with your clj-kondo configuration.

    Files are linted as they're being edited. If you want to lint the whole project, use the clj-kondo cli command. See https://github.com/borkdude/clj-kondo for more info on that. Windows users might like to know that they too can get a clj-kondo cli command now, via npm install -g clj-kondo. It'll be a bit slower to start than the native build, but for sure it's better than not having a clj-kondo command! See https://github.com/borkdude/clj-kondo/blob/master/doc/install.md#npm-linux-macos-windows for more on this.

    "},{"location":"linting/#resolve-macro-as","title":"Resolve Macro As","text":"

    When your cursor is on a macro form in the editor, you may notice a code action (click the light bulb that appears) called Resolve Macro As. Running this code action will ask you what macro you'd like to resolve the current macro as, and then what clj-kondo config file you want the macro to be saved to. This code action is also available as a command.

    "},{"location":"live-share/","title":"Using Calva with Live Share","text":"

    Live Share is a Microsoft provided VS Code extension. It allows you to share the workspace that you have open in your computer with somebody else. Everybody is then working on the same source code files, namely those on your computer. You can edit files at the same time, everyone has their own caret. You can follow each other (i.e. when someone switches to a different file, you will as well). This is great for remote pair programming, for example.

    An extra nice thing is that each participant is using their own VSCode configuration, including fonts, colors, keyboard shortcuts, etc.

    Disable Calva Spritz to get rid of Notebooks interference

    The headline below Calva Supports Live Share is true. However, due to a bug in LiveShare, guest participants always get their Clojure files opened in the Calva Clojure Notebooks editor. To workaround this issue Calva uses a \u201dside-car\u201d extension named Calva Spritz for the Notebooks associations of Clojure files. You can disable that extension when participating in LiveShare sessions.

    "},{"location":"live-share/#calva-supports-live-share","title":"Calva Supports Live Share","text":"

    When using Calva, you can use Live Share as well. Editing works exactly the same as for any other programming language. What makes Calva a bit special, is the REPL. When using Live Share, Calva allows the host to share the REPL with guests as well. If you use any of the supported configuration, this will be pretty much automatic.

    You need to enable the LiveShare support

    Due to an issue in the LiveShare API, for some users, this feature stops Calva from connecting the REPL. Therefore the support is disabled by default. The setting is calva.useLiveShare.

    This is what a typical scenario looks like:

    1. The host jacks-in.
    2. The host shares its workspace using Live Share. Calva will detect that the workspace is being shared, so it will offer to share the REPL port that was opened when jacking in. The host clicks \"Allow\" to start sharing the port. (Note: steps 1 and two can also be done in the reverse order.)
    3. The host sends the Live Share URL to the guest(s).
    4. The guest joins the Live Share session using the URL it received.
    5. The guest connects to the host's REPL using the command \"Connect to a running REPL server in the project\". If needed, the guest chooses the same build configuration as the host.

    Voila! Both the guest and the host can now use the REPL that is running on the host. Things like documentation lookup now also work on the guest's machine.

    "},{"location":"live-share/#control-visibility-of-calva-folder","title":"Control Visibility of .calva Folder","text":"

    Calva depends on the output.calva-repl file to be available. If you have the .calva folder listed in your .gitignore, this also causes the folder to be hidden from guests in Live Share by default. In order to make the folder visible, you can put a file called .vsls.json in your project. In its simplest form, the contents can be this:

    {\n  \"$schema\": \"http://json.schemastore.org/vsls\",\n  \"hideFiles\": [\n    \"!.calva\"\n  ]\n}\n

    Now the .calva folder is shared as well. But also any other file and folder that you may have in your .gitignore. If you want to have more fine-grained control, please refer to the section Controlling file access and visibility of the Live Share documentation.

    "},{"location":"live-share/#some-things-to-keep-in-mind","title":"Some Things To Keep In Mind","text":""},{"location":"live-share/#calva-spritz","title":"Calva Spritz","text":"

    Together with Calva there is an extension called Calva Spritz installed. All it does is to provide the association of Clojure file types to Clojure Notebooks. We do it this way because of the LiveShare issues mentioned above. So that you can disable the Notebook association when participating as a guest in LiveShare sessions. The issue is tracked here:

    Calva Spritz can be disabled and enabled at will, and it will take immediate effect, without any reload of VS Code needed.

    "},{"location":"luminus/","title":"How to Use Calva with Luminus","text":"

    Luminus is a powerful and versatile Leiningen template for creating web development projects. It comes with built in configuration which makes it easy to use Calva as your Clojure(Script) editor.

    "},{"location":"luminus/#server-shadow-cljs","title":"Server + shadow-cljs","text":"

    Basically this is the same wokflow as with Server only. Behind the scenes there is more happening, though. Such as the ClojureScript app being built and the CLJS REPL connected once the web app is running.

    1. If you haven't created the project yet, create a new shadow-cljs Luminus project. E.g.: 
      $ lein new luminus my-luminus-shadow +reagent +re-frame +shadow-cljs\n
    2. Install npm dependencies 
      $ npm i\n
      (Or yarn if you prefer.)
    3. This creates the folder my-luminus-shadow. Open it in VS Code: 
      $ code my-luminus-shadow\n
    4. Use the Calva command Start a Project REPL and Connect (aka Jack-in): ctrl+alt+c ctrl+alt+j
    5. Select to start my-luminus-shadow Server + Client, and wait for the Terminal Calva Jack-in output to say [:app] Build completed.
    6. Open 127.0.0.1:3000 in your web browser and start hacking.

    Note

    Currently Calva has troubles following the app-start with shadow-cljs, so Calva will report Jack-in done. in the output window before shadow-cljs is actually done building the app. If you open the app page at that stage, you will see a message to \u201cPlease run lein shadow watch app\u201d. Rest assured that this is already underway. Follow the Jack-in process in the Terminal tab in VS Code for the message that the app is built, then reload the app page in the web browser.

    "},{"location":"luminus/#server-only","title":"Server Only","text":"

    The workflow here is really just: Jack-in and start hacking. However, the first time it will involve these steps:

    1. If you haven't created the project yet, create a new server only Luminus project. For a all-defaults setup it is like so: 
      $ lein new luminus my-luminus-server\n
    2. This creates the folder my-luminus-server. Open it in VS Code: 
      $ code my-luminus-server\n
    3. Use the Calva command Start a Project REPL and Connect (aka Jack-in): ctrl+alt+c ctrl+alt+j
      • Select to start my-luminus-shadow Server and wait until you see Jack-in done. in the output window.
    4. Open 127.0.0.1:3000 in your web browser and start hacking.
    "},{"location":"luminus/#server-figwheel","title":"Server + Figwheel","text":"

    This is Legacy Figwheel (lein-figwheel), so the recommendation is to use the shadow-cljs setup instead. As with the server only, the workflow here is really just: Jack-in and start hacking. The first time it involves these steps:

    1. If you haven't created the project yet, create a new server only Luminus project. E.g.: 
      $ lein new luminus my-fw +reagent\n
    2. This creates the folder my-fw. Open it in VS Code: 
      $ code my-fw\n
    3. Use the Calva command Start a Project REPL and Connect (aka Jack-in): ctrl+alt+c ctrl+alt+j, select Server + Client - my-fw in the Project type picker menu, and wait for the web app to pop open in your web browser.
    4. Start hacking.

    If you prefer to open the web app yourself, open .vscode/settings.json and change \"shouldOpenUrl\" to false in the pre-configured Calva connect sequence. Calva will then print the URL 127.0.0.1:3000 in the output, so that you can click it open.

    "},{"location":"luminus/#etcetera","title":"Etcetera","text":"

    You will have three Calva Custom Command Snippets configured. Invoke them by issuing the Run Custom REPL Command, ctrl+alt+c . (that's a dot). These commands control the Luminus server:

    1. Start <project> Server
    2. Stop <project> Server
    3. Restart <project> Server

    When used, Calva will open its REPL window and execute the command, if it is not already opened. You can close this window if you prefer to use the REPL directly from the Clojure files.

    Calva also opens the REPL window, and starts the Luminus server, as part of the Jack-in process.

    "},{"location":"merch/","title":"Calva Merch","text":"

    In this video, there is a question about where you can buy the Calva T-shirt:

    You couldn't, then. But now you can! On Amazon.

    Zero profit

    To keep the admin of this shop to a minimum the merch is sold at production prize (or as close to production prize as the respective store allows). There is no royalty going to anyone in the Calva team when you buy one of these t-shirts. You will represent, which is certainly a way to support the project. You are of course encouraged to support us via sponsoring as well:

    Calva Merch is available on Zazzle and on Amazon

    ","boost":10},{"location":"merch/#zazzle","title":"Zazzle","text":"","boost":10},{"location":"merch/#calva-symbol-sticker","title":"Calva Symbol Sticker","text":"Calva Symbol Sticker by BetterThanTomorrow","boost":10},{"location":"merch/#joyride-symbol-sticker","title":"Joyride Symbol Sticker","text":"Joyride Symbol Sticker by BetterThanTomorrow","boost":10},{"location":"merch/#amazon-merch","title":"Amazon Merch","text":"","boost":10},{"location":"merch/#the-designs","title":"The designs","text":"

    There are four design, all featuring the Calva symbol (the Calva glass), which are all available for a Standard T-shirt, in men's, women's and kid's cut, and in some different colors. In the .com store there are also Premium T-shirts**.

    ","boost":10},{"location":"merch/#symbol-logo","title":"Symbol + Logo","text":"

    Available at:

    ","boost":10},{"location":"merch/#symbol-logo-we-do-it-with-rich-comments","title":"Symbol + Logo + We do it with Rich Comments","text":"

    The Calva symbol and Logo front, Rich Comments back.

    Available at:

    ","boost":10},{"location":"merch/#symbol-only","title":"Symbol Only","text":"

    Available at:

    ","boost":10},{"location":"merch/#symbol-we-do-it-with-rich-comments","title":"Symbol + We do it with Rich Comments","text":"

    The Calva symbol front, Rich Comments Back.

    Available at:

    Note

    What's available on this or that Amazon site will vary a bit and it is a bit slow to add a particular design to a particular market. Eventually I hope to have both designs up on these markets: .com, .co.uk, .de, .fr, .it, .es, and .co.jp

    ","boost":10},{"location":"namespace-form-auto-creation/","title":"Namespace Form Auto-creation","text":"

    When you create a new clojure file, a file with .clj, .cljc or .cljs extension, an appropriate namespace form will be added to the file. This feature is provided by clojure-lsp.

    "},{"location":"nbb/","title":"Using Calva with nbb","text":"

    Since nbb can be started such that it is an nREPL server, Calva can connect to it and a lot of the features will work.

    Calva can also start nbb and connect its REPL for you, using the Jack-in command. This will start an nbb nREPL server on a random port and connect Calva to it. Check out this video where they use Calva and nbb to create a CLI tool as an executable npm module:

    In that video they ask for a JavaScript to ClojureScript converter. And there is one: https://mauricioszabo.gitlab.io/js2cljs/

    Though if you are using Calva, this converter is easier to use directly via the command Calva: Convert JavaScript to ClojureScript:

    Errors jacking in to nbb on Windows?

    On some machines it seems necessary to first run npx nbb from the CMD prompt to make jack-in work. Or try first install it npm i -g nbb. (You probabl want nbb installed globally anyway.)

    Don't expect complete support

    nbb's nREPL server is completely new and and WIP. It will be a bit limited compared to a full cider-nrepl enhanced \"regular\" Clojure nREPL server. Things like function signatures, and more do not work.

    It's a bit hacky

    The nbb nREPL server is the first ClojureScript nREPL server around and throws Calva's assumption that an nREPL server is always started in a Clojure process out the window. The nbb Jack-in/connect option \u201dpretends\u201d it is connecting to a Clojure nREPL and then the code fro promoting the nREPL session to a ClojureScript one is just dummy code.

    This means that if you open a Clojure (.clj) file while connected to an nbb nREPL server, it will still be a ClojureScript session serving even though Calva will indicate that it is a Clojure one. Bare with us until we can fix this properly in Calva.

    ","boost":4},{"location":"notebooks/","title":"Clojure Notebooks","text":"

    WIP: Notebook support is very basic and experimental

    Please help test the feature. We're looking forward to your feedback!

    You can open any Clojure file as a notebook by right clicking the file -> Open with... -> Clojure Notebook.

    Running cells sends them to the REPL and pretty prints the results. If the return is a string that starts with <html it will be displayed in an html webview.

    Forms inside (comment) blocks get shown as their own cells. When adding code blocks in between those cells they get saved with the same indentation as the first form.

    ","boost":1},{"location":"notebooks/#calva-spritz","title":"Calva Spritz","text":"

    Together with Calva there is an extension called Calva Spritz installed. It only provides the association of Clojure file types to Clojure Notebooks. This is due to the LiveShare issues mentioned above. So that you can disable the Notebook association when participating as a guest in LiveShare sessions. The issue is tracked here:

    ","boost":1},{"location":"nrepl_and_cider-nrepl/","title":"nREPL and cider-nrepl","text":"

    nREPL and cider-nrepl middleware enable Calva to support full Interactive Programming.

    ","boost":2},{"location":"nrepl_and_cider-nrepl/#about-nrepl","title":"About nREPL","text":"

    The REPL is a Clojurists quintessential tool, it\u2019s what we use to do Interactive Development, the hallmark of the LISP style of development.

    In Interactive Development (more commonly but somewhat imprecisely referred to as REPL-driven development), the programmer\u2019s editor has a direct connection with the running application process. This allows evaluating pieces of code in the context of a running program, directly from where the code is written (and so not in some separate \u201cREPL place\u201d), inspecting and manipulating the innards of the process. This is helped along by the dynamic nature of Clojure in which any var can be redefined at any point, allowing for quick incremental and iterative experimentation and development.

    This is why it\u2019s essential to the Clojure development experience to have proper editor support, a plugin which bridges the gap between where the code is written and where the code is run. So we have CIDER for Emacs, Calva for VS Code, Cursive for IntelliJ, Conjure or Iced for Vim, and so forth. Often these will also leverage the same (or a parallel) connection into the process for other editor affordances, like navigation and completion.

    But for these editor plugins to connect to the Clojure process something needs to be listening on the other side, accepting connections, allowing the initiation of a program-to-program dialogue. The most common way to achieve this is by leveraging the nREPL protocol, an asynchronous message-based network protocol for driving interactive development. The application process is started with an embedded nREPL server, so that the editor can connect as an nREPL client.

    From: Lambda Island

    ","boost":2},{"location":"nrepl_and_cider-nrepl/#about-the-nrepl-server-and-middleware","title":"About the nREPL Server and Middleware","text":"

    nREPL is an extensible protocol, the reference server implementation understands certain core operation types like \"eval\". More operations can be supported, or existing operations can be modified or augmented, through nREPL middleware. For example: the Piggieback middleware can intercept \"eval\" messages, and forward them to a ClojureScript environment, rather than evaluating them in the Clojure process itself.

    Which middleware to use will mostly depend on the editor you are using. You\u2019ll typically find that the Clojure-specific functionality for a given editor is partly implemented as a typical editor extension, for instance CIDER written in Emacs LISP, or Calva written in Typescript, and partly as nREPL middleware, providing the functionality the editor extension relies on. For instance, both CIDER and Calva rely on functionality provided by cider-nrepl.

    Also from: Lambda Island

    ","boost":2},{"location":"nrepl_and_cider-nrepl/#viewing-the-communication-between-calva-and-nrepl","title":"Viewing the Communication Between Calva and nREPL","text":"

    You can view the messages sent between Calva and nREPL by running the command Toggle nREPL Logging Enabled. Enabling nREPL message logging triggers the creation of a VS Code output channel called nREPL Messages where the messages will be logged. Messages sent to nREPL from Calva will have -> sent above them, and messages sent from nREPL to Calva will have <- received above them. Disabling nREPL message logging causes the nREPL Messages channel to be removed and messages will no longer be logged.

    Each message is logged as JSON. If you find a need for the messages to be logged as EDN (for example, to transform and analyze them with Clojure) please open a GitHub issue for this change. A PR would be welcome too!

    The example below shows two messages logged when the cursor hovers over println in a Clojure file while a REPL is connected.

    -> sent\n{\n  op: 'info',\n  ns: 'test-lein.core',\n  symbol: 'println',\n  id: '7',\n  session: '1a080b66-b1b6-4b8c-8206-c4af2cc02747'\n}\n\n<- received\n{\n  added: '1.0',\n  'arglists-str': '[& more]',\n  column: 1,\n  doc: 'Same as print followed by (newline)',\n  file: 'jar:file:/Users/brandon/.m2/repository/org/clojure/clojure/1.10.1/clojure-1.10.1.jar!/clojure/core.clj',\n  id: '7',\n  line: 3733,\n  name: 'println',\n  ns: 'clojure.core',\n  resource: 'clojure/core.clj',\n  'see-also': [\n    'clojure.core/prn',\n    'clojure.core/print',\n    'clojure.core/println-str',\n    'clojure.pprint/pprint'\n  ],\n  session: '1a080b66-b1b6-4b8c-8206-c4af2cc02747',\n  static: 'true',\n  status: [ 'done' ]\n}\n
    ","boost":2},{"location":"output/","title":"Output Destinations","text":"

    Calva categorizes output into three types:

    With the setting calva.outputDestinations, you can configure where each category of output should go to:

    The reason there are several options for this is partly legacy and partly because VS Code restricts the placement of different views in different ways. We hope you will find a combination of output destinations that suits you.

    "},{"location":"output/#commands-for-showing-output-destinations","title":"Commands for showing output destinations","text":"

    These are the commands and their default keyboard shortcuts for revealing output destinations

    "},{"location":"output/#about-stdout-in-the-repl-window","title":"About stdout in the REPL Window","text":"

    Since Calva v2.0.423 the REPL Window prints stdout prepended with ; to make it into line comments. This is because stdout output easily breaks the Clojure structure of the REPL Window, making it misbehave in various ways. We made this change because as maintainers of Calva we have seen all too often how this hits users, and it is also taking too much of our Calva time to try mitigate the problem, which is fundamentally not fixable.

    There are now other output destinations that do not have this limitation.

    All that said. If you want to keep using the REPL Window for stdout output, and need the old behavior, you can enable the setting: calva.legacyPrintBareReplWindowOutput. Please note that at some point after we have created a dedicated Output Window, the REPL Window will be retired as a destination for output.

    "},{"location":"output/#repl-process-output-stdout-and-stderr","title":"REPL process output (stdout and stderr)","text":"

    When Calva is connected to the REPL, the Output window will by default print not only results of evaluations, but also:

    1. Things printed to stdout and stderr in the main thread of the evaluations
    2. Things printed to stdout and stderr from child threads of the evaluations
    3. Anything printed to stdout and stderr by the REPL process

    You can control the default via the calva.redirectServerOutputToRepl setting. It defaults to true. Setting it to false before connecting the REPL will result in that 2. and 3. will not get printed in the Output window. It will then instead be printed wherever the REPL process is printing its messages, usually the terminal from where it was started (the Jack-in terminal if Calva started the REPL).

    "},{"location":"output/#see-also","title":"See also","text":""},{"location":"paredit/","title":"Paredit \u2013 a Visual Guide","text":"

    Structural editing and navigation for Clojure.

    ","boost":7},{"location":"paredit/#what-is-paredit","title":"What is Paredit?","text":"

    Calva Paredit helps you navigate, select and edit Clojure code in a structural way. LISP isn't line or character oriented, it is based around S-expressions, a.k.a forms. We strongly recommend that you take advantage of the structural nature of Clojure, and have therefore put a lot of work into making Calva Paredit extra awesome.

    If you are new to Paredit, consider starting with learning the Slurp Forward (pull in the next form into this form) and Barf Forward (push the last form out of this form). It will take you quite far.

    ","boost":7},{"location":"paredit/#strict-mode","title":"Strict Mode","text":"

    To protect the integrity of your code, Strict mode is enabled by default.

    Strict mode keybinding Action Description backspace Delete Backward Deletes one character backwards, unless it will unbalance a form. Otherwise moves past the character instead of deleting it. If the list is empty, it will remove both open and close brackets. delete Delete Forward Deletes one character forwards, unless it will unbalance a form. Otherwise moves past the character instead of deleting it. If the list is empty, it is removed. alt+backspace Force Delete Backward Deletes one character backwards, even if it will unbalance a form. alt+delete Force Delete Forward Deletes one character forwards, even if it will unbalance a form.

    Disable at your own peril. Strict mode can be toggled on/off using the Toggle Paredit Mode command, and there is a status bar indicator telling you:

    Indicator Paredit Mode [\u03bb] Strict (\u03bb) Cave Man (strict mode off) \u03bb No default key bindings

    Toggle between Strict and Cave Man using: ctrl+alt+p ctrl+alt+m

    ","boost":7},{"location":"paredit/#a-keybinding-for-protecting-the-structure-from-semi-colon","title":"A keybinding for protecting the structure from semi-colon","text":"

    Semi-colons (;) in Clojure are non-structural because they comment out the rest of the line regardless of brackets. In a way they can delete brackets. There is a somewhat secret command in Paredit that can be used to insert ; in a safe way:

    paredit.insertSemiColon

    Bind it to the ; key with a when clause that activates it together with the other Strict mode commands:

    {\n    \"command\": \"paredit.insertSemiColon\",\n    \"key\": \";\",\n    \"when\": \"calva:keybindingsEnabled && editorLangId == clojure && editorTextFocus && paredit:keyMap == strict && !editorReadOnly && !editorHasMultipleSelections && !calva:cursorInComment\"\n },\n
    ","boost":7},{"location":"paredit/#commands","title":"Commands","text":"

    The Paredit commands are sorted into Navigation, Selection, and Edit. As mentioned, Slurp and Barf are power commands, which go into the editing category. Learning to navigate structurally, using shortcuts, also saves time and adds precision to your editing. It has the double effect that you at the same time learn how to select structurally, because that is the same, just adding the shift key.

    To make the command descriptions a bit clearer, each entry is animated. When you try to figure out what is going on in the GIFs, focus on where the cursor is at the start of the animation loop.

    ","boost":7},{"location":"paredit/#command-args","title":"Command Args","text":"

    Some Paredit commands accept arguments. You can utilize this in keybindings and from Joyride.

    ","boost":7},{"location":"paredit/#copy-for-all-kill-commands","title":"copy for all kill* commands","text":"

    When specified, will control whether killed text will be copied to the clipboard. This is an alternative to, or supports binding-specific overrides for, calva.paredit.killAlsoCutsToClipboard.

    For example, here's 2 keybindings for paredit.killRight with different copy args, allowing you to choose when or if you want killed text copied at keypress-time, regardless of global calva.paredit.killAlsoCutsToClipboard setting:

    {\n  \"key\": \"ctrl+k\",\n  \"command\": \"paredit.killRight\",\n  \"when\": \"... your when conditions ...\",\n  \"args\": {\"copy\": false}\n},\n{\n  \"key\": \"cmd+k ctrl+k\",\n  \"command\": \"paredit.killRight\",\n  \"when\": \"... your when conditions ...\",\n  \"args\": {\"copy\": true}\n},\n

    Or, you can even have both of them use the same key, but separate when conditions to taste, to allow context-conditional copying.

    ","boost":7},{"location":"paredit/#strings-are-not-lists-but-anyway","title":"Strings are not Lists, but Anyway...","text":"

    In Calva Paredit, strings are treated in much the same way as lists are. Here's an example showing Slurp and Barf, Forward/Backward List, and Expand Selection.

    ","boost":7},{"location":"paredit/#navigating","title":"Navigating","text":"

    (Modify these with shift to select rather than move, see below.)

    Default keybinding Action Description ctrl+right (win/linux)alt+right (mac) Forward Sexp Moves the cursor forward, to the end of the current form. If at the end, moves to the end of the next form. Will not move out of lists. ctrl+left (win/linux)alt+left (mac) Backward Sexp Moves the cursor backward, to the start of the current form. If at the start, moves to the start of the previous form. Will not move out of lists. ctrl+down Forward Down Sexp Moves the cursor into the following list. ctrl+alt+up Backward Down Sexp Moves the cursor into the preceding list. ctrl+alt+down Forward Up Sexp Moves the cursor forwards, out of the current list. ctrl+up Backward Up Sexp Moves the cursor backwards, out of the current list. Unbound Forward Sexp Or Up Moves the cursor forward, to the end of the current form. If at the end, moves to the end of the next form. Moves out of the lists if at the end of it. Unbound Backward Sexp Or Up Moves the cursor backward, to the start of the current form. If at the start, moves to the start of the previous form. Moves out of the list if at the start of it. ctrl+end Forward to List End/Close Moves the cursor forwards, staying within the current list. ctrl+home Backward to List Start/Open Moves the cursor backwards, staying within the current list.","boost":7},{"location":"paredit/#selecting","title":"Selecting","text":"

    Most of these commands are selecting \u201dversions\u201d of the navigation commands above. Repeated use will grow the current selection step by step.

    Default keybinding Action Description shift+alt+right (win/linux)ctrl+w (mac) Expand Selection Starts from the cursor and selects the current form. Then will keep expanding to enclosing forms. shift+alt+left (win/linux)ctrl+shift+w (mac) Shrink Selection Contracts back from an expanded selection performed by any Paredit selection command. (In the animation the selection is first grown using a combination of Expand Selection and some lateral selection commands, then shrunk all the way back down to no selection.) ctrl+alt+w space Select Top Level Form Top level in a structural sense. Typically where your(def ...)/(defn ...) type forms. Please note that(comment ...) forms create a new top level. shift+ctrl+right (win/linux)shift+alt+right (mac) Select Forward Sexp ctrl+shift+k Select Right Select forward to the end of the current form or the first newline. See Kill right below. (The animation also shows Shrink Selection). shift+ctrl+left (win/linux)shift+alt+left(mac) Select Backward Sexp ctrl+shift+down Select Forward Down Sexp (You probably do not need to select like this, but you can!) ctrl+shift+alt+up Select Backward Down Sexp (You probably do not need to select like this, but you can!) ctrl+shift+alt+down Select Forward Up Sexp (You probably do not need to select like this, but you can!) ctrl+shift+up Select Backward Up Sexp (You probably do not need to select like this, but you can!) Unbound Select Forward Sexp Or Up (You probably do not need to select like this, but you can!) Unbound Select Backward Sexp Or Up (You probably do not need to select like this, but you can!) ctrl+shift+end Select Forward to List End/Close ctrl+shift+home Select Backward to List Start/Open","boost":7},{"location":"paredit/#editing","title":"Editing","text":"Default keybinding Action Description ctrl+alt+right (mac/win)ctrl+alt+. (linux) Slurp Forward Moves the closing bracket forward, away from the cursor, past the following form, if any. ctrl+alt+left (mac/win)ctrl+alt+, (linux) Barf Forward Moves the closing bracket backward, towards the cursor, past the preceding form. ctrl+alt+shift+left Slurp Backward Moves the opening bracket backward, away from the cursor, past the preceding form, if any. ctrl+alt+shift+right Barf Backward Moves the opening bracket forward, towards the cursor, past the following form. ctrl+alt+s Splice Sexp Remove enclosing brackets. ctrl+shift+s Split Sexp Splits a string, or a list, into two strings, or lists of the same type as the current. ctrl+shift+j Join Sexps/Forms Joins two strings, or two lists of the same type, into one form (string/list). ctrl+alt+p ctrl+alt+r Raise Sexp Replaces the enclosing list with the current form. ctrl+alt+t Transpose Sexps/Forms Swaps place of the two forms surrounding the cursor. alt+upalt+down Drag Sexp Backward/Forward Moves the current form to the behind/in front of the previous/next one. (See below about behavior in maps and binding boxes.) ctrl+alt+shift uctrl+alt+shift d Drag Sexp Backward UpDrag Sexp Forward Down Moves the current form up/out of the current list, backwards, and down/in to the following list, forwards, keeping the cursor within the sexpr being dragged. ctrl+alt+shift kctrl+alt+shift j Drag Sexp Forward UpDrag Sexp Backward Down Moves the current form up/out of the current list, forwards, and down/in to the preceding list, backwards, keeping the cursor within the sexpr being dragged. ctrl+shift+c Convolute \u00af\\_(\u30c4)_/\u00af ctrl+shift+delete Kill Sexp Forward Deletes the next form in the same enclosing form as the cursor. ctrl+k ctrl+k (win/linux)ctrl+k (mac) Kill Right Delete forward to the end of the current form or the first newline. ctrl+k ctrl+h (win/linux)cmd+backspace (mac) Kill Left Delete backward to the start of the current form or the start of the line. ctrl+alt+backspace Kill Sexp Backward Deletes the previous form in the same enclosing form as the cursor. ctrl+delete Kill List Forward Deletes everything from the cursor to the closing of the current enclosing form. ctrl+backspace Kill List Backward Deletes everything from the cursor to the opening of the current enclosing form. ctrl+alt+shift+delete Splice Killing Forward Delete forward to end of the list, then Splice. ctrl+alt+shift+backspace Splice Killing Backwards Delete backward to the start of the list, then Splice. ctrl+alt+shift+p Wrap Around () Wraps the current form, or selection, with parens. ctrl+alt+shift+s Wrap Around [] Wraps the current form, or selection, with square brackets. ctrl+alt+shift+c Wrap Around {} Wraps the current form, or selection, with curlies. ctrl+alt+shift+q Wrap Around \"\" Wraps the current form, or selection, with double quotes. Inside strings it will quote the quotes. ctrl+alt+rctrl+alt+p/s/c/q/h Rewrap Changes enclosing brackets of the current form to parens/square brackets/curlies/double quotes and set (#{})

    Copy to Clipboard when killing text

    You can have the kill commands always copy the deleted code to the clipboard by setting calva.paredit.killAlsoCutsToClipboard to true. If you want to do this more on-demand, you can kill text by using the selection commands and then Cut once you have the selection.

    clojure-lsp drag fwd/back overlap

    As an experimental feature, the two commands for dragging forms forward and backward have clojure-lsp alternatives. See the clojure-lsp page.

    ","boost":7},{"location":"paredit/#drag-bindings-forwardbackward","title":"Drag bindings forward/backward","text":"

    When dragging forms inside maps and binding boxes, such as with let, for, binding, etcetera, it often makes most sense to drag each binding as a pair. And this is what Calva will do. Like so:

    And like so (wait for it):

    ","boost":7},{"location":"paredit/#about-the-keyboard-shortcuts","title":"About the Keyboard Shortcuts","text":"

    Care has been put in to making the default keybindings somewhat logical, easy to use, and work with most keyboard layouts. Slurp and barf forward are extra accessible to go with the recommendation to learn using these two super handy editing commands.

    You can relax how Paredit's shortcuts replace VS Code built in shortcuts a bit by setting calva.paredit.hijackVSCodeDefaults to false.

    There are some context keys you can utilize to configure keyboard shortcuts with precision. See Customizing Keyboard Shortcuts.

    The Nuclear Option: You can choose to disable all default key bindings by configuring calva.paredit.defaultKeyMap to none. (Then you probably also want to register your own shortcuts for the commands you often use.)

    ","boost":7},{"location":"paredit/#when-clauses-and-vscode-default-bindings","title":"When Clauses and VSCode Default Bindings","text":"

    There are instances where VSCode's built-in command binding defaults are the same as Paredit's, where Paredit's version has less functionality. For example, Calva's Expand Selection and Shrink Selection doesn't support multiple selections (though this may change in the future - see Multicursor section below). In this particular case, adding !editorHasMultipleSelections to the when clause of the binding makes up for this gap by letting the binding fall back to VSCode's native grow/shrink selection.

    For example, here's the JSON version of the keybindings settings demonstrating the above. Note this can also specified in the Keyboard Shortcuts UI:

    {\n  \"key\": \"shift+alt+right\",\n  \"command\": \"paredit.sexpRangeExpansion\",\n  \"when\": \"calva:keybindingsEnabled && editorLangId == clojure && editorTextFocus && paredit:keyMap =~ /original|strict/ && !calva:cursorInComment\"\n}\n

    to

    {\n  \"key\": \"shift+alt+right\",\n  \"command\": \"paredit.sexpRangeExpansion\",\n  \"when\": \"!editorHasMultipleSelections && calva:keybindingsEnabled && editorLangId == clojure && editorTextFocus && paredit:keyMap =~ /original|strict/ && !calva:cursorInComment\"\n}\n

    The point is that when the bindings overlap and default functionality is desired peaceful integration can be achieved with the right when clause. This is left out of Paredit's defaults to respect user preference, and ease of maintenance.

    Happy Editing! \u2764\ufe0f

    ","boost":7},{"location":"paredit/#experimental-feature-multicursor-support","title":"Experimental Feature: Multicursor support","text":"

    There is an ongoing effort to support simultaneous multicursor editing with Paredit. This is an experimental feature and is not enabled by default. To enable it, set calva.paredit.multicursor to true. This feature is still in development and may not work as expected in all cases. Currently, this supports the following categories:

    ","boost":7},{"location":"paredit/#toggling-multicursor-per-command","title":"Toggling Multicursor per command","text":"

    The experimental multicursor-supported commands support an optional command arg - like copy for the kill* commands mentioned above - to control whether multicursor is enabled for that command. This is an alternative to, or supports binding-specific overrides for, calva.paredit.multicursor.

    For example:

    {\n  \"key\": \"ctrl+k\",\n  \"command\": \"paredit.sexpRangeExpansion\",\n  \"when\": \"... your when conditions ...\",\n  \"args\": {\"multicursor\": false}\n}\n
    ","boost":7},{"location":"parinfer/","title":"Calva Parinfer Mode is Reverted","text":"

    Reverted in Calva v2.0.228

    The changes in v2.0.227 seemed to cause problems for some users. Unclear yet if and why. But to not risk causing problems for more users these changes where reverted and Calva v2.0.228 does not contain them. Please consider using v2.0.227 and help find what the problems are about! Please note: Even in v2.0.227 this feature is currently disabled by default.

    Parinfer is a system for editing the structure of LISP text without explicit commands. The structure can be regarded as already being expressed through indentation. With Parinfer you can use your intuition about the structure inferred from the indentation to perform surprisingly many structural edits.

    "},{"location":"parinfer/#quirks","title":"Quirks","text":"

    There are some known quirks, of varying severity, with this feature. Some of them will need to be fixed before we move this feature out of Experimental status.

    For the most times you can always Undo to get back to where the document was fine. You just need to pay some attention and be aware when undo is needed.

    "},{"location":"parinfer/#no-multi-cursor-support","title":"No multi-cursor support","text":"

    The bracket inference will remove all cursors but the first one. So for instance if you edit with multiple cursors and it causes brackets to move, you'll end up with just one cursor and the subsequent edits will not be what you intended. This is particularly important to note when you have cursors that are not in the viewport. In such cases it might be better to turn Parinfer off while you do the edits, fix formatting and such manually and then switch Parinfer on again.

    "},{"location":"parinfer/#wrong-inferences","title":"Wrong inferences","text":"

    For yet unknown reasons an edit such as the following does the wrong thing (the cursor indicated by the vertical bar):

    (foo| (bar)\n      (baz))\n

    backspace => 

    (fo| (bar\n      (baz)))\n

    That is (baz) is slurped. When what should happen is:

    (fo| (bar)\n     (baz))\n
    "},{"location":"parinfer/#lag-causing-errors-when-fast-typing","title":"Lag causing errors when fast typing","text":"

    The way that Calva Parinfer works is that for any edit of the document it first reformats the code around the cursor, then infer brackets. Currently these two steps are not atomic to VS Code, so if you type fast bracket inference might happen on the yet unformatted code, and thus not be correct. You might also see the cursor end up at the wrong position at times.

    "},{"location":"parinfer/#infer-parens","title":"Infer Parens","text":"

    This is no longer available in Calva

    See above about how to try this build anyway, warts and all.

    When you enable Calva's Parinfer it is all about infering brackets from indentation. There are no further Parinfer modes. Calva's auto-formatter will take care of keeping the code correctly indented.

    Enable it with from this setting: calva.fmt.experimental.inferParensAsYouType or from the status bar item.

    "},{"location":"parinfer/#parinfer-status-bar-items","title":"Parinfer Status bar items","text":"

    To the right on the status bar, right before the Paredit status bar item, you will have two items, Parinfer toggle ON/OFF and a health indicator.

    1. Parinfer ON/OFF indicator/button. \u2022() (The dot/circle indicates ON/OFF)
    2. Structure and indentation health indicator. \u2714\ufe0f/\u26a0/\u2298

    When Parinfer is ON, the health indicator will have three states:

    1. \u2714\ufe0f Healthy - meaning both structure and indentation is OK
    2. \u2298 Structure broken - you need to fix the the structure of the code
    3. \u26a0 Bad indentation - meaning that to Parinfer the structure and indentation do not match, _the item is now also a button with which you can fix the indentation.

    Parinfer will be disabled in both the unhealthy states.

    When Parinfer is OFF, only the first two states above are used.

    "},{"location":"parinfer/#some-vs-code-settings-automatically-changed","title":"Some VS Code Settings automatically changed","text":"

    In order for some automatic VS Code behaviour not to interfere with Parinfer the following settings are automatically configured when you toggle Parinfer ON:

        \"[clojure]\": {\n        \"editor.autoClosingBrackets\": \"never\",\n        \"editor.autoClosingOvertype\": \"never\",\n        \"editor.formatOnPaste\": false\n    },\n

    And when you toggle Parinfer OFF:

        \"[clojure]\": {\n        \"editor.autoClosingBrackets\": \"always\",\n        \"editor.autoClosingOvertype\": \"always\",\n        \"editor.formatOnPaste\": true\n    },\n

    It is recommended that you let Calva handle these settings to avoid weird behaviour.

    "},{"location":"parinfer/#no-tab-indenting","title":"No Tab indenting","text":"

    As the tab key is used for formatting the current form in Calva, it is \u201dtaken\u201d. The closest equivalents you have are space and backspace. At least for now. We'll see if we can find out a good way for supporting tab and shift+tab for indent and dedent.

    tab for formatting is of course just a default key binding and you can assign it to something else to get it to do indenting. However, it will not be a very smart indent anyway, there is no Clojure awareness about it. You are hereby adviced to instead use some more spaces.

    "},{"location":"parinfer/#paredit-is-still-there","title":"Paredit is still there","text":"

    In Calva, Parinfer and Paredit are designed to coexist and both be there to let you edit the structure easily and efficiently. Since Paredit commands are always formatted, they leave the code in a state where Parinfer has what it needs to infer bracket placement as you either edit the indentation, or remove/add brackets.

    "},{"location":"parinfer/#disable-the-parinfer-extension","title":"Disable the Parinfer Extension","text":"

    If you want to have Parinfer you are probably best served by Calva's built-in version. It is designed, and will continue to be improved to function well together with Calva's other structural editing and formatting features. It will also probably conflict with the Parinfer Extension.

    "},{"location":"parinfer/#see-also","title":"See also","text":""},{"location":"polylith/","title":"How to Use Calva with Polylith","text":"

    Polylith is an architecture for backend projects that maximizes development ergonomics and code reuse.

    When developing a Polylith application you use one REPL for everything. And as such it is a rather vanilla deps.edn project, so there is really not much more to using Calva with Polylith than:

    1. Jack in, selecting the deps.edn project type
    2. Select aliases, most often :dev and :test
    3. Hack away!
    "},{"location":"polylith/#the-realworld-example","title":"The RealWorld Example","text":"

    To make it easy to try Polylith out with Calva, the Polylith RealWorld example implementation has some Calva config to get the server started and Calva connected to its REPL quickly:

    1. Fork the project and open it in VS Code
    2. Jack-in, selecting the Polylith RealWorld Server REPL project type
    3. Wait for the REPL prompt to read clj\ua789dev.server\ua789>
    4. Evaluate (start! 6003)
    5. Hack away!
    "},{"location":"polylith/#try-it-with-a-frontend","title":"Try it with a Frontend","text":"

    A ClojureScript frontend, of course:

    1. Fork the jacekschae/conduit project and open it in VS Code
    2. Edit the api-url definition in events.cljs file to be 
      (def api-url \"http://localhost:6003/api\")\n
    3. Jack-in, selecting to start and connect to the :app build
    4. Wait for it to compile and then open http://localhost:3000
    5. Hack away!
    "},{"location":"pprint/","title":"Pretty Printing","text":"

    In Calva, pretty printing is a mode. Prettiness is on by default and all your evaluation results will get that treatment.

    You can also pretty print code on demand

    There is a command Replace Current Form (or Selection) with Pretty Printed Form. See Clojure Formmatting for more on this.

    "},{"location":"pprint/#toggle-it","title":"Toggle it","text":"

    There is a pprint indicator to the right in the status bar which shows the status of the mode. Click the indicator to toggle prettification on and off. There is also a Calva: Toggle Pretty Printing for All Evaluations command.

    Tip: If you have evaluated something time consuming, or that is not idempotent, with pretty printing mistakenly off: toggle it on and evaluate *1.

    "},{"location":"pprint/#configuration","title":"Configuration","text":"

    For most people the defaults will probably work, but Calva pretty printing comes a few knobs you can turn, and they are all available through the calva.prettyPrintingOptions settings. Things you can set are:

    Setting Type Effect enabled boolean So this is a third way you can change this mode \ud83d\ude04 printEngine enum Which printer function that will be used. Default is pprint, more about this setting below printFn object You can configure Calva to use a custom nREPL compatible print function, more below. width number The maximum line length of printed output (or at least the printers will try) maxLength number The maximum number of elements printed in nested nodes, good for evaluating something like (iterate inc 0), which you shouldn't do without setting maxLength. Most printers will indicate truncated lists with ... at the end. maxDepth number The maximum number of levels deep that will get printed. Different printers mark a stop different ways. puget doesn't support it at all.

    See Customizing Calva for some tips on adding settings like these.

    Here's an example of how zprint handles maxDepth (from the Calva implementation of it's client side pretty printing.).

      (pretty-print [[[[[[[[:deeper]]]]]]]] {:max-depth 4})\n  ;; => {:value \"[[[[##]]]]\"}\n
    "},{"location":"pprint/#your-selection-of-prettifiers","title":"Your Selection of Prettifiers","text":"

    Pretty printing can happen on the server (i.e. in the JVM, via nREPL), or on the client (i.e. in node, via VS Code/Calva). Client side always uses zprint. Server side you can choose from these printers:

    Print Engine Client or Server Side Comments calva client The nREPL server will plain print the results, and then Calva will pretty it (using zprint). pprint server Current Calva default. clojure.core/pprint is a bit basic, but it's tried and tested, and doesn't suffer from the issues with the other server side printing options, mentioned below. fipp server puget server Lacks maxDepth option. zprint server A very good option. However, it will need to be configured before Jack-in if you want Calva's help to inject its dependencies. (If you are not using Jack-in, you'll need to supply this dependency yourself.)

    These particular server side functions were chosen because they have pre-configured print-functions in cider-nrepl.

    "},{"location":"pprint/#or-configure-printfn","title":"Or configure printFn","text":"

    If the selection of built-in printEngine support doesn't cut it, you can configure a custom function. This function will need to conform to the requirements of nREPL print functions. The VS Code settings editor will help you configure this one. (This is also a bit experimental, please consider giving feedback about how it works for you if you try it.)

    "},{"location":"pprint/#why-does-server-or-client-side-matter","title":"Why does Server or Client Side Matter?","text":"

    This matters because on the server all pretty printers, except pprint does more than just pretty print the result that would be printed with plain printing. Pretty printing results on the server causes some results to get expanded. This can have huge implications depending on the results and which printer is used. E.g. for Datomic transaction results, you will get the whole database printed. Twice. Depending on the database, you could be so unlucky that nothing gets printed, and instead you will soon have a very hot computer.

    Note: With the help of zprint creator, Kim Kinnear, we have found ways to compensate for this problem. Ways that are not yet implemented, but please stay tuned.

    Then why not always do it client side? It turns out that on the client side there are also things going on. Calva gets the results back as a string and therefore it needs to first be parsed back to EDN, before it can be pretty printed by zprint. And \u2013 here's the catch \u2013 all results are not valid EDN and therefore can't be pretty printed by zprint. Datomic transaction results are one example.

    "},{"location":"pprint/#need-more-configurability","title":"Need More Configurability?","text":"

    The current options are limited, because our time developing Calva is limited. But cider-nrepl really allows for fully configurable pretty printing, so it is within reach. Please feel invited to give us feedback on what you would want to configure for the printing of results. File issues and/or chat us up in #calva in the Clojurians slack.

    "},{"location":"pprint/#troubleshooting","title":"Troubleshooting","text":""},{"location":"pprint/#pprint-is-not-working","title":"pprint is not working","text":"

    If pprint is not working, try a different pprint engine or use Calva's jack-in to make sure the necessary dependencies are loaded in your REPL. If you are starting your REPL without jack-in and want to continue doing so, you can use the command Copy Jack-in Command Line to Clipboard then paste the command somewhere to see what dependencies it injects. You can then add these dependencies to your REPL in whatever way suits your needs.

    Enjoy Prettiful Printing! \u2764\ufe0f

    "},{"location":"quirks/","title":"Quirks","text":"

    Here's a shocker for ya': Calva isn't perfect. \ud83d\ude04

    There are quirks and things that flat out do not work. We'll try to collect info about such things here, providing workarounds when available (or, rather, known to us).

    "},{"location":"quirks/#test-features-not-available-with-clojurescript","title":"Test features not available with ClojureScript","text":"

    Currently cider-nrepl does not provide its test functionality for ClojureScript code. Please consider contributing to fixing that.

    "},{"location":"quirks/#using-with-parinfer","title":"Using with Parinfer","text":"

    See Using with Parinfer

    "},{"location":"quirks/#calva-and-the-vim-extension","title":"Calva and the VIM Extension","text":"

    See Using Calva with the VIM Extension.

    "},{"location":"quirks/#command-not-found-errors-on-jack-in","title":"\u201dCommand not found\u201d Errors on Jack-in","text":"

    Jack-in starts by running a command in a new terminal. You will need the commands used installed on your computer:

    Also, in some circumstances VS Code is not spawned from a shell with the environment variables, especially $PATH, which might mean that even though you have the tools installed, they are not found when VS Code/Calva tries to execute them. To fix this you will need to do one of these two things:

    1. Figure out from where VS Code is spawned, and make sure the $PATH there includes the directory with the needed binary.
    2. Start VS Code from a terminal where the $PATH is correctly configured. (Using the code command.)

    See this issue for more clues on this problem.

    "},{"location":"quirks/#strange-linting-errors","title":"Strange linting errors?","text":"

    This is not really a quirk, and most linting errors are not strange when you learn about why they are there. Calva does not do any linting, btw, see also linting.

    "},{"location":"quirks/#consider-uninstalling-these-extensions","title":"Consider uninstalling these extensions","text":"

    Without Calva, many users install other nifty extensions (some of which are old pieces of Calva) that help with this or that problem. It might sometimes work together with Calva, sometimes not. Here's a list of some common extensions you should consider to at least disable:

    "},{"location":"re-frame-template/","title":"How to use Calva with the re-frame template","text":"

    The re-frame template creates a shadow-cljs project, making it easy to use with Calva.

    1. npm install
    2. From VS Code, issue the command Calva: Start a Project REPL and Connect (a.k.a Jack-in), ctrl+alt+c ctrl+alt+j.
    3. Calva will auto-detect that this is a shadow-cljs project and ask for which build to compile.
    4. Calva's output window will open and log some progress information.
    5. When prompted for which build to start, select :app.
    6. :app is the only configured build, but the VS Code menu for this is a bit strange so make sure the :app checkbox is really ticked before proceeding.
    7. This will start the app, so in this workflow you don't do the Run application steps outlined below.
    8. When prompted for which build to connect to, select :app.
      • In the View menu of VS Code, you can tell it to show the Terminal view, where you see which command the jack-in process is started with, and it's output. Ctrl+C in this pane will kill your app and free up all resources it has allocated.
    9. When the app is compiled
      1. Open http://localhost:8280 in your browser.
      2. Confirm that it says Hello from re-frame. (Depending on how long the app takes to compile, you might need to reload the page a few times.)
    10. Open the views.cljs file from src/<your-project-name> and issue Calva: Load/Evaluate Current File and its Requires/Dependencies. ctrl+alt+c enter.
      1. Confirm that you are connected by adding evaluating (js/alert \"Hello from Calva\") (alt+enter and ctrl+enter are your friends).
      2. Confirm that Shadow is hot reloading by changing the greeting message.
    "},{"location":"rebl/","title":"How to Use Calva and REBL Together","text":"

    REBL is a graphical, interactive tool for browsing Clojure data.

    "},{"location":"rebl/#depsedn","title":"deps.edn","text":"

    Add the following aliases to your deps.edn file. Use the deps.edn file in the ~/.clojure directory to enable alias reuse across multiple projects. This is the configuration for REBL on openjdk 12. Check out the REBL github page for more info.

    ;; REBL Base\n:rebl\n{:extra-deps {org.clojure/core.async {:mvn/version \"0.4.490\"}\n                ;; deps for file datafication (0.9.149 or later)\n                org.clojure/data.csv {:mvn/version \"0.1.4\"}\n                org.clojure/data.json {:mvn/version \"0.2.3\"}\n                org.yaml/snakeyaml {:mvn/version \"1.23\"}\n                com.cognitect/rebl\n                ;; adjust to match your install location\n                {:local/root \"/Users/ozimos/REBL/latest/REBL.jar\"}}}\n\n;; REBL 12\n:rebl-12\n{:extra-deps {org.openjfx/javafx-fxml     {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-controls {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-graphics {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-media    {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-swing    {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-base     {:mvn/version \"12.0.1\"}\n                org.openjfx/javafx-web      {:mvn/version \"12.0.1\"}}}\n\n;; nREBL\n:nrebl {:extra-deps {rickmoynihan/nrebl.middleware {:mvn/version \"0.2.0\"}}\n            :main-opts [\"-e\" \"((requiring-resolve,'cognitect.rebl/ui))\" \"-m\" \"nrepl.cmdline\" \"--middleware\" \"[nrebl.middleware/wrap-nrebl]\" \"-I\"]}\n

    Create a Calva custom connect sequence for your VSCode editor. (Read Custom REPL Connect Sequences if you haven't.) Add the following to your vscode settings.json:

    {\n    \"calva.replConnectSequences\": [\n        {\n            \"name\": \"Rebl Connect\",\n            \"projectType\": \"deps.edn\",\n            \"menuSelections\": {\n                \"cljAliases\": [\n                    \"rebl\",\n                    \"rebl-12\",\n                    \"nrebl\"\n                ]\n            }\n        }\n    ]\n}\n
    "},{"location":"rebl/#leiningen","title":"Leiningen","text":"

    Add rebl profiles to your user-wide profiles so that they will be available for all your projects. Here's a sample user profile (located at ~/.lein/profiles.clj on mac):

    {:user {:plugins [[lein-ancient \"0.6.15\"]]}\n\n ;; REBL Base\n :rebl {:resource-paths [\"/Users/ozimos/REBL/latest/REBL.jar\"]\n        :dependencies [[org.clojure/core.async \"0.4.490\"]\n                       [org.clojure/data.csv \"0.1.4\"]\n                       [org.clojure/data.json \"0.2.3\"]\n                       [cljfmt \"0.6.4\"]\n                       [org.yaml/snakeyaml \"1.23\"]]}\n\n ;; REBL 12 for JDK 12.0.1. Swap out for your JDK version\n :rebl-12 {:dependencies [[org.openjfx/javafx-fxml  \"12.0.1\"]\n                          [org.openjfx/javafx-controls \"12.0.1\"]\n                          [org.openjfx/javafx-graphics \"12.0.1\"]\n                          [org.openjfx/javafx-media \"12.0.1\"]\n                          [org.openjfx/javafx-swing \"12.0.1\"]\n                          [org.openjfx/javafx-base  \"12.0.1\"]\n                          [org.openjfx/javafx-web \"12.0.1\"]]}\n\n;; NREBL https://github.com/RickMoynihan/nrebl.middleware\n :nrebl {:repl-options {:nrepl-middleware [nrebl.middleware/wrap-nrebl]}\n        :dependencies [[rickmoynihan/nrebl.middleware \"0.3.1\"]]}}\n
    More info here

    Create a Calva custom connect sequence for your VSCode editor. (Read Custom REPL Connect Sequences if you haven't.) Add the following to your vscode settings.json:

    {\n    \"calva.replConnectSequences\": [\n        {\n            \"name\": \"Lein REBL\",\n            \"projectType\": \"Leiningen\",\n            \"menuSelections\": {\n                \"leinProfiles\": [\"rebl\", \"rebl-12\", \":nrebl\"]\n            },\n            \"afterCLJReplJackInCode\": \"((requiring-resolve 'cognitect.rebl/ui))\"\n        }\n    ]\n}\n
    "},{"location":"rebl/#shadow-cljs-tbd","title":"shadow-cljs (TBD)","text":"

    TBD. If you know how to do it, please update this page.

    "},{"location":"refactoring/","title":"Refactoring","text":"

    There are two \u201dflavours\u201d to refactoring support. Some (just a few) refactorings are made available as Quick Fix suggestions (the light bulb), the rest are regular commands in the clojure-lsp Refactoring category.

    You can enable or disable the Quick Fix suggestion lightbulb using the VS Code setting editor.lightbulb.enabled.

    The refactoring commands do not have default keyboard shortcuts. You find them all by typing \u201dclojure-lsp Refactor\u201d in the Command Palette.

    "},{"location":"refactoring/#commands","title":"Commands","text":"Command Title Command Key Description Clean NS Form clojureLsp.refactor.cleanNs Add Missing Require clojureLsp.refactor.addMissingLibspec Extract to New Function clojureLsp.refactor.extractFunction Cycle/Toggle Privacy clojureLsp.refactor.cyclePrivacy Inline Symbol clojureLsp.refactor.inlineSymbol Introduce let clojureLsp.refactor.introduceLet Creates a new let box with the binding. Follow up with \u201dExpand let\u201d to move it upwards. Expand Let clojureLsp.refactor.expandLet Move to Previous let Box clojureLsp.refactor.moveToLet Thread First clojureLsp.refactor.threadFirst Thread First All clojureLsp.refactor.threadFirstAll Thread Last clojureLsp.refactor.threadLast Thread Last All clojureLsp.refactor.threadLastAll Unwind All clojureLsp.refactor.unwindAll Unwind Thread clojureLsp.refactor.unwindThread

    Formatting

    The way that some of the refactorings are applied to the document, makes it difficult for Calva to format the results. So, sometimes you'll need to navigate the cursor to the enclosing form and hit tab to tidy up the formatting after a refactoring. See also Formatting.

    "},{"location":"refactoring/#thanks-to-clojure-lsp","title":"Thanks to clojure-lsp","text":"

    Most of Calva's refactoring support is sourced directly from clojure-lsp. This also means that most often, if you find issues with refactoring, or have suggestions about it, the clojure-lsp repo is where to direct your reporting.

    "},{"location":"remote-development/","title":"Using Calva with Remote Development","text":"

    VS Code Remote Development is a new feature in version 1.35 of VS Code that allows a developer to use a container, remote machine, or the Windows Subsystem for Linux (WSL) as a full-featured development environment.

    I would recommend reading the introductory blog post and watching the videos. I find the feature extremely exciting and wish more IDEs would implement something like it.

    From a Clojure perspective it allows you to have VS Code installed on your Java-less, Clojure-less hardware and still use it to develop Clojure through it.

    "},{"location":"remote-development/#a-use-case","title":"A use-case","text":""},{"location":"remote-development/#how-to","title":"How to","text":"

    Run Remote-Containers: Add Development Container Configuration Files... and pick a suitable Java base image. Then:

    "},{"location":"remote-development/#modify-dockerfile-to-install-clojure-cli-and-optionally-lein","title":"Modify Dockerfile to install Clojure CLI (and optionally lein)","text":"

    Add:

    # ...\n\n# Install Clojure - see https://github.com/Quantisan/docker-clojure/blob/master/target/openjdk-14-slim-buster/tools-deps/Dockerfile\nENV CLOJURE_VERSION=1.10.1.619\nWORKDIR /tmp\nRUN \\\napt-get update && \\\napt-get install -y curl make rlwrap wget && \\\nrm -rf /var/lib/apt/lists/* && \\\nwget https://download.clojure.org/install/linux-install-$CLOJURE_VERSION.sh && \\\nsha256sum linux-install-$CLOJURE_VERSION.sh && \\\necho \"28b1652686426cdf856f83551b8ca01ff949b03bc9a533d270204d6511a8ca9d *linux-install-$CLOJURE_VERSION.sh\" | sha256sum -c - && \\\nchmod +x linux-install-$CLOJURE_VERSION.sh && \\\n./linux-install-$CLOJURE_VERSION.sh\nRUN \\\nsu vscode -c \"clojure -e '(clojure-version)'\" && \\\nrm ./linux-install-$CLOJURE_VERSION.sh\n\n# Install Lein\nRUN \\\nwget https://raw.githubusercontent.com/technomancy/leiningen/stable/bin/lein -O /bin/lein && \\\nchmod uog+x /bin/lein\nRUN su vscode -c \"/bin/lein\"\n\n# Cleanup\nRUN apt-get purge -y --auto-remove curl wget\n\n# ...\n
    "},{"location":"remote-development/#modify-devcontainerjson","title":"Modify devcontainer.json","text":"

    Add Calva and, optionally, forward some ports to the host::

    \"extensions\": [\"betterthantomorrow.calva\"],\n\"forwardPorts\": [8088, 52162], // example: your webapp, your nREPL\n
    "},{"location":"remote-development/#build-and-start","title":"Build and start","text":"

    Run Remote-Containers: Rebuild and Reopen in container

    "},{"location":"remote-development/#wsl","title":"WSL","text":"

    See Using Calva with WSL

    "},{"location":"repl-window/","title":"The REPL Window/File","text":"

    The Calva REPL Window is actually a regular file with some extra treatment from Calva, like displaying a prompt, offering evaluation history recall and generally \u201cfollowing\u201d the current namespace. This file is created and opened when Calva is connected to a REPL. You can use it for experimental code (though there are also Rich Comments and Fiddle Files for this).

    In ClojureScript projects, the window will be associated with the cljs REPL once it is connected. It will then look something like this:

    The first prompt is from when the clj REPL is connected, and the second from cljs. The first part of the prompt tells you which REPL type the window is currently connected to.

    "},{"location":"repl-window/#using-the-repl-window-for-output","title":"Using the REPL Window for output","text":"

    By default the REPL Window doubles as the place where Calva sends output like stdout/stderr and other messages. See Calva Output for more about this and how to change this behaviour.

    "},{"location":"repl-window/#finding-the-repl-window","title":"Finding the REPL Window","text":"

    If you quickly want to open and/or switch to the REPL Window there is the command Calva: Show/Open REPL Window, ctrl+alt+o r.

    To sync the REPL window namespace with the current file before switching, use the Switch Namespace of the REPL Window to Current Namespace command, ctrl+alt+c alt+n.

    "},{"location":"repl-window/#find-the-file-for-the-current-repl-window-namespace","title":"Find the File for the Current REPL Window Namespace","text":"

    When you are editing things in the REPL window, and want to open the file that defines its current namespace, use the Show File for the Current REPL Window Namespace command, ctrl+alt+o r.

    Note

    This also works for Clojure core and library namespaces.

    "},{"location":"repl-window/#evaluating-code","title":"Evaluating Code","text":"

    The window will be automatically associated with the REPL and the namespace of any project Clojure/ClojureScript file you evaluate code in. So for instance if you evaluate this code in a clj file with the namespace fresh-reagent.handler:

    (def mount-target\n  [:div#app\n   [:h2 \"Welcome to fresh-reagent\"]\n   [:p \"please wait while Figwheel is waking up ...\"]\n   [:p \"(Check the js console for hints if nothing exciting happens.)\"]])\n

    If the REPL Window is the configured destination for evaluation results, the defined var will be printed there. Otherwise, it will be printed to the destination you've configured. In either case, the REPL window will print a new prompt reflecting the current REPL connection and namespace:

    If you then switch to the output window (ctrl+alt+o r), and enter this at the prompt:

    mount-target\n

    then evaluate it using alt+enter, you'll get this:

    ... because the namespace \u201dfollowed\u201d the first evaluation in the REPL window.

    "},{"location":"repl-window/#repl-history","title":"REPL History","text":"

    Recently evaluated forms in the REPL file are persisted and can easily be shown again for modifying and re-evaluating.

    "},{"location":"repl-window/#navigate-repl-history","title":"Navigate REPL History","text":"

    You can navigate up and down the history of evaluated forms in the REPL file by pressing alt+up and alt+down, provided your cursor is at the end of the last form after the prompt. If the cursor is not at the end of the last form, then alt+up and alt+down will do whatever they are mapped to, which is by default \"Move Line Up\" and \"Move Line Down,\" respectively.

    If you have typed some text after the prompt before you start traversing up the history, this text will be preserved and will display when you traverse back down the history. If you modify some text in the history while traversing, the modification will be saved at that location in history.

    "},{"location":"repl-window/#clear-repl-history","title":"Clear REPL History","text":"

    You can clear the repl history by running the command \"Clear REPL History\" from the command palette.

    "},{"location":"repl-window/#stack-traces","title":"Stack Traces","text":"

    When an evaluation produces an error, it will automatically be printed in the REPL Window. If there is a stack trace associated with the error, it can now be printed on demand using the Calva: Print Last Stacktrace to the Output Window command. You can also print the stack trace for any error message printed to the REPL Window via the Codelens button below it.

    For printed stacktraces, when source locations are available (Clojure files), you will be able to navigate to them by pressing ctrl+click (cmd+click on Mac) on the file name. You can also hover over symbols in the stack trace to see the symbol's documentation, and ctrl+click (cmd+click on Mac) the symbol to Peek Definition.

    Output destinations

    If you have configured some other destination for stderr output, the error message will be printed there as well. But it will also be printed to the REPL Window, because the augmented stack traces need this (because reasons).

    "},{"location":"repl-window/#load-current-namespace","title":"Load Current Namespace","text":"

    When navigating namespaces it is easy to forget to first require them and that can be tricky to debug. To help with this, Calva's command Load/Evaluate Current File and its Requires/Dependencies also works in the REPL Window, but there, it acts like Load Current Namespace.

    Suppose you have two files, pez/xxx.clj and pez/yyy.clj, where pez.yyy requires pez.xxx.

    (ns pez.xxx)\n\n(def a :xxx-a)\n\n(def b :xxx-b)\n
    (ns pez.yyy\n  (:require [pez.xxx]))\n\n(def a :yyy-a)\n\n(println \"Hello\" pez.xxx/a)\n

    Then, with a freshly jacked-in REPL, you evaluate (ns pez.yyy) and want to work with the vars defined there, Clojure will complain. But if you Load/Evaluate Current File and its Requires/Dependencies, it will start working. Something like so:

    Note

    This currently suffers from a limitation in Calva where it won't reload dependencies, so you will sometimes have to do this \u201dmanually\u201d anyways (by opening the files and loading them yourself). See Calva issue #907

    "},{"location":"repl-window/#peek-current-namespace","title":"Peek Current Namespace","text":"

    A somewhat hidden feature: You can peek, see documentation for, and navigate to a namespace by hovering on the namespace symbol in one of the REPL Window prompts (just like you would if it was not in the prompt \ud83d\ude04).

    "},{"location":"repl-window/#paredit-enabled","title":"Paredit Enabled","text":"

    The REPL Window is mostly a regular Calva Clojure/ClojureScript file, which makes everything that works in a regular file work in this file, including Paredit. This makes it easy to navigate the input and output there. For instance, to select the last evaluation results, you can press ctrl+w (shift+alt+right on Windows and Linux):

    "},{"location":"repl-window/#debugger-enabled","title":"Debugger Enabled","text":"

    The output window is mostly a regular... (you get it), which means you also have the Calva debugger at your command at the REPL prompt (only for clj sessions, for now). So instead of evaluating a function definition using alt+enter, you can evaluate it and instrument it for debugging using ctrl+alt+c i, and then call the function.

    "},{"location":"repl-window/#it-is-ephemeral","title":"It is Ephemeral","text":"

    The contents of the output/REPL window is written to a file named output.repl in the .calva/output-window directory of your project. The file is recreated every new session, so you should copy or save anything you want to preserve between sessions.

    You probably want to add .calva/output-window/ to your .<something>ignore files. (There are some more files in that directory that you shouldn't keep under source control.)

    "},{"location":"repl-window/#choose-clj-or-cljs-repl-connection","title":"Choose CLJ or CLJS REPL Connection","text":"

    In full-stack projects, you will probably use the window as a REPL for both clj and cljs. You can toggle which REPL the window is connected to by using the command Calva: Toggle REPL Connection for CLJC files. There is also a button for this in the status bar:

    "},{"location":"repl-window/#known-quirks-and-caveats","title":"Known Quirks and Caveats","text":"

    Due to limitations in the VS Code API it is hard for Calva to know if the REPL file is open, and if it was opened more than once. Therefore, we suggest you make it a habit to leave this window open, or even pinned. And if it is open in several tabs, expect evaluation printouts to be a bit unpredictable.

    If you save the REPL file (which most often does not make much sense, but anyway) you will sometimes be presented with a message about VS Code being confused about the file contents being out of sync. Just choose to Overwrite the currently saved version and you should be fine.

    "},{"location":"reveal/","title":"How to use Calva and Reveal together","text":"

    Reveal is a \"Read Eval Visualize Loop for Clojure\". This page describes how to use Reveal in your development setup based on Calva.

    Note

    See https://vlaaad.github.io/reveal for the latest version and use that wherever this page says <version>.

    "},{"location":"reveal/#when-using-toolsdeps","title":"When using tools.deps","text":"

    You can go for the nrepl middleware or just add the dependency.

    Please see the Calva test-data project minimal-reveal for an example.

    "},{"location":"reveal/#middleware","title":"Middleware","text":"

    This will make Reveal to start together with your project.

    Note

    This will make all Calva evaluations go to Reveal. Too chatty for you? Take the dependencies only approach.

    Add this alias deps.edn:

    :aliases\n{:reveal-nrepl-middleware\n    {:extra-deps {vlaaad/reveal {:mvn/version \"<version>\"}}\n     :main-opts  [\"-m\" \"nrepl.cmdline\"\n                  \"--middleware\" \"[vlaaad.reveal.nrepl/middleware,cider.nrepl/cider-middleware]\"]}}\n

    And then jack-in choosing the deps.edn option and then pick the :reveal-nrepl-middleware alias.

    "},{"location":"reveal/#dependencies-only","title":"Dependencies only","text":"

    If you don't want to use the nrepl-middleware you can configure just the dependency and then start Reveal yourself.

    The alias:

    :reveal-dep-only\n  {:extra-deps {vlaaad/reveal {:mvn/version \"<version>\"}}}\n

    A custom REPL command for starting Reveal in your project:

        \"calva.customREPLCommandSnippets\": [\n        ...\n        {\n            \"name\": \"Start Reveal Tapper\",\n            \"snippet\": \"(require '[vlaaad.reveal :as reveal])(add-tap (reveal/ui))\",\n            \"key\": \"sr\"\n        },\n        ...\n    ]\n

    See Custom REPL Command for how to configure more commands, and bind shortcuts to them, to make Reveal integration nice for you.

    "},{"location":"reveal/#when-using-leiningen","title":"When using Leiningen","text":"

    In your project.clj, add a profile named \"reveal\":

    :profiles {:reveal {:dependencies [[vlaaad/reveal \"<version>\"]]\n                    :repl-options {:nrepl-middleware [vlaaad.reveal.nrepl/middleware]}}}\n

    Now when you jack-in using Calva, you enable this profile and Reveal will be started automatically. Please note that Reveal requires Java 8 or higher, and uses JavaFX. Depending on your setup, you may need to make sure it is available.

    "},{"location":"reveal/#tips-about-font-size","title":"Tips about font size","text":"

    If you find the font to small you can add a :jvm-opts key to make it a little bigger:

    :aliases\n{:reveal\n    {:extra-deps {vlaaad/reveal {:mvn/version \"<version>\"}}\n     :jvm-opts   [\"-Dvlaaad.reveal.prefs={:font-size,17}\"]\n     :main-opts  [\"-m\" \"nrepl.cmdline\"\n                  \"--middleware\" \"[vlaaad.reveal.nrepl/middleware,cider.nrepl/cider-middleware]\"]}}\n
    "},{"location":"reveal/#using-java-11","title":"Using Java > 11?","text":"

    Reveal needs some reflective access to internal classes that has since Java 11 been restricted. You can relax this and get things working via JVM options. Tuck this into your reveal alias:

    :jvm-opts [\"--add-opens\" \"javafx.graphics/com.sun.javafx.tk=ALL-UNNAMED\"]\n

    (If you are using the font size tips, just add the options into the :jvm-opts vector.)

    See https://github.com/vlaaad/reveal/issues/1 for some more context around this issue.

    "},{"location":"rich-comments/","title":"Rich Comments Support","text":"

    Why bother with Rich comments? Read on. Consider watching this Youtube video for a demo of the workflow using the (in?)famous FizzBuzz problem as an example.

    ","boost":5},{"location":"rich-comments/#things-in-comment-are-not-evaluated","title":"Things in comment are not evaluated","text":"

    The Clojure comment macro is defined like so:

    (defmacro comment\n  \"Ignores body, yields nil\"\n  {:added \"1.0\"}\n  [& body])\n

    It has no forms in its body and will therefore always (as long as the Clojure Reader can read it) evaluate to nil. That is: nothing in the (comment ...) form will get evaluated when the file is loaded.

    This makes it a very good \u201dplace\u201d where you can develop code, experiment with code, and keep example code. Since you will be able to load/evaluate the current file without worrying that the code in the comment form will get evaluated. This also holds true when using tools that hot-reload the code on save, such as Figwheel, shadow-cljs and Krell.

    To develop or refine a function you might:

    1. Open up a (comment ...) form
    2. Inside this form, type a first, super simple, version (or refinement) of your function and evaluate it
    3. Inside the same comment form, type some code to test your function and evaluate that
      • Or type and evaluate some code you might need for your function
    4. Repeat from 2., until the function does what you want it to do
    5. Move the function definition out of the comment form
    6. Clean up the comment form to keep some of the test code as example use, or \u201ddesign decision log\u201d for the function.

    Note

    Using (comment ...) forms for developing code is very common among Clojure coders. Rich Hickey is known for using it, which is why they are called Rich comments to begin with (even if it also is a very rich experience).

    ","boost":5},{"location":"rich-comments/#calva-encourages-rich-comments","title":"Calva encourages Rich comments","text":"

    Calva has several features to facilitate the Rich comments workflow, e.g.

    1. A command that helps you create a new Rich comment form quickly: Calva: Add Rich Comment, ctrl+alt+r c
    2. A snippet for creating Rich comment form quickly. Typing (rcf, will make it appear.
    3. Special Syntax highlight. By default comment forms are rendered in italics
    4. Special top-level form context
    5. Special formatting

    Note that the command and snippet for creating Rich comments add the keyword :rcf right before the closing paren. This makes the closing paren stay and not fold when you format the code. The special formatting (see below) will treat this and also any ignored (with #_) form at the end of the form specially.

    ","boost":5},{"location":"rich-comments/#comment-is-top-level","title":"comment is top-level","text":"

    To make it easy to evaluate forms in (comment ...) forms, they create a new top-level context. Instead of you having to place the cursor with precision before evaluating the current form, you can have the cursor anywhere within a comment enclosed form and Evaluate Top-Level Form.

    This carries over to all commands in Calva which deal with the top level form. Including custom command snippets.

    ","boost":5},{"location":"rich-comments/#special-formatting","title":"Special formatting","text":"

    To invite a Rich comments workflow, the Calva command Format Current Form will not fold the closing bracket of the (comment ...) form. Instead it will place this bracket on a line of its own (or keep it there).

    (comment\n  )\n

    With the cursor somewhere directly inside the comment form (denoted with a |):

    (comment\n  (def foo\n:foo)|)\n

    tab

    (comment\n  (def foo\n    :foo)\n  |)\n

    !!! Note \"Only for the current comment form\u201d The special formatting only applies in the current comment form. When outside it, formatting tucks the closing paren in again. That's why fold when done, below works like it does. This also applies to VS Code commands like Format Document, or when you have Format On Save enabled. There are several reasons for this, and one is that there is no cljfmt config for it and leaving the closing comment un-tucked might give you troubles with CI pipelines that enforce some cljfmt config be followed. (Another reason is that it would be pretty hard to do on the whole document.)

    ","boost":5},{"location":"rich-comments/#special-formatting-disabled-for-trailing-rcf","title":"Special formatting disabled for trailing :rcf","text":"

    If the Rich comment ends with :rcf (or an ignored form), the special formatting doesn't happen. So if you have:

    (comment\n  (def foo\n:foo)\n  |\n  :rcf)\n

    And hit tab, you will get:

    (comment\n  (def foo\n    :foo)\n  |\n  :rcf)\n
    ","boost":5},{"location":"rich-comments/#thinking-space-is-kept","title":"Thinking space is kept","text":"

    The formatter will not remove newlines between the cursor and the closing bracket. So if you have entered a few lines to get \u201dthinking\u201d room:

    (comment\n  (def foo\n:foo)\n\n|\n\n)\n

    tab

    (comment\n  (def foo\n    :foo)\n\n  |\n\n  )\n
    ","boost":5},{"location":"rich-comments/#fold-when-done","title":"Fold when done","text":"

    To fold the trailing paren automatically, place the cursor immediately outside (before or after) the form:

    (comment\n  (def foo\n:foo))|\n

    tab

    (comment\n  (def foo\n    :foo))|\n
    ","boost":5},{"location":"rich-comments/#enabled-by-default","title":"Enabled by default","text":"

    You can disable this behavior with the setting: calva.fmt.keepCommentTrailParenOnOwnLine.

    ","boost":5},{"location":"rich-comments/#only-for-the-current-form","title":"Only for the Current Form","text":"

    Note

    This treatment only applies to formatting of the current form. With fold when done as an exception.

    ","boost":5},{"location":"shadow-cljs/","title":"shadow-cljs","text":"

    Calva supports most any JVM hosted ClojureScript environment (and some others, including SCI based, too), but shadow-cljs gets some special treatment to try make it extra convenient to use.

    With many shadow-cljs projects, Calva's connect project type shadow-cljs, is the right choice. Projects that use Leiningen or deps.edn can be used both with the Leiningen/deps.edn and shadow-cljs type, depending on configuration see below for more on this.

    ","boost":7},{"location":"shadow-cljs/#shadow-cljs-browser-quickstart","title":"shadow-cljs - browser quickstart","text":"

    Here's how you start a shadow-cljs ClojureScript REPL and connect Calva with the shadow-cljs - browser quickstart example project:

    Prep:

    1. Clone the project to your machine and open its root folder in VS Code.
    2. Open a terminal and run npm install

    Connect Calva:

    1. Run the command Calva: Start a Project REPL and Connect (a.k.a. Jack-in)
    2. Select project type shadow-cljs
    3. Select to start the build :app
    4. Select to connect to the build :app
    5. Wait for the build to complete
    6. Open http://localhost:8020/ in the browser
    7. Open browser.cljs file and load it in the REPL: Calva: Load/Evaluate Current File and Dependencies

    Now you can should be able to evaluate forms, e.g.:

    (See Code Evaluation)

    ","boost":7},{"location":"shadow-cljs/#shadow-cljs-in-full-stack-projects","title":"shadow-cljs in full stack projects","text":"

    shadow-cljs is a bit special in regards to Calva REPL connection. Mainly because you can start shadow-cljs and it's nREPL server in two ways:

    1. Using the shadow-cljs npm executable
    2. Via the Clojure REPL in your Leiningen or deps.edn project

    These options show up as project types when connecting or jacking in:

    1. Project type: shadow-cljs
    2. Project type: deps.edn + shadow-cljs or Leiningen + shadow-cljs

    The technical difference here is wether you let shadow-cljs start clojure/Leiningen (the first option) or if you let Calva do it (the second option). If you let Calva do it, Calva will then start the shadow-cljs watcher from the Clojure process. From a usage perspective the two approaches will result in different channeling of shadow-cljs output, e.g. test runner results. With the first option (the shadow-cljs project type), shadow-cljs output will be channeled to the Jack-in terminal. With the deps.edn/Leiningen option, that output will be channeled to the Output/REPL window.

    See shadow-cljs + Clojure with Calva: The basics for some more discussion on how the REPL connection works.

    shadow-cljs and clojure aliases

    The shadow-cljs project type will not prompt you for any aliases found in the deps.edn file. Usually you should provide such aliases in shadow-cljs.edn like :deps {:aliases [...]}. If, for whatever reason you can't provide the aliases that way, you can configure a Custom REPL Connect Sequence and provide the aliases as menuSelections -> cljAliases.

    Leiningen + shadow-cljs middleware issue

    Please note that for Leiningen, the command line dependency injection of the shadow-cljs nrepl middleware doesn't work. You need to add it to your project.clj:

    :repl-options {:nrepl-middleware [shadow.cljs.devtools.server.nrepl/middleware]}\n
    ","boost":7},{"location":"shadow-cljs/#see-also","title":"See also:","text":"","boost":7},{"location":"sponsors/","title":"Calva Sponsors","text":"

    Calva is open source and free to use. It is actively maintained during our free time, and it keeps improving. You can contribute in many different ways, one of which is sponsoring. You can sponsor Calva by directly sponsoring any of us.

    If you are working at a company which benefits from Calva's existence and continued development, please consider sponsoring at the Calva Gold Sponsor tier.

    Please see this statement from Cognitect about the importance of supporting open source developers.

    ","boost":7},{"location":"sponsors/#patrons","title":"Patrons","text":"The right kind of different","boost":7},{"location":"sponsors/#gold-sponsors","title":"Gold Sponsors","text":"Scale your growth on mobile MAKE. DO. SHIP.","boost":7},{"location":"sponsors/#silver-sponsors","title":"Silver Sponsors","text":"","boost":7},{"location":"sponsors/#clojurists-together","title":"Clojurists Together","text":"

    Significant additions to Calva have been made possible by funding from Clojurists Together. And this has often been transformational for the whole project. Calva would not be where it is today without Clojurists Together.

    ","boost":7},{"location":"sponsors/#our-sponsoring-profiles","title":"Our Sponsoring Profiles","text":"

    These are the sponsoring profiles for the active maintainers of Calva (a.k.a. The Calva Team).

    ","boost":7},{"location":"sponsors/#readme-visibility","title":"README visibility","text":"

    There is also a sponsors section in the README of the Calva project (which means it is also displayed in the VS Code Extension Marketlace).

    ","boost":7},{"location":"syntax-highlighting/","title":"Calva Highlight","text":"

    Calva takes care of syntax highlighting, and also provides some features not available through VS Code's highlighting mechanism. These extras include rainbow parens, sane bracket matching, and comment form dimming/highlighting.

    "},{"location":"syntax-highlighting/#syntax-highlighting","title":"Syntax Highlighting","text":"

    When using Calva, you are also using its TMLanguage grammar (the core mechanism VS Code uses for syntax highlighting).

    Our grammar tokenizes Clojure keywords as constant.keyword.clojure. Since it is pretty uncommon with keyword constants in the programming languages out there, your theme might not have a highlight defined for this scope. Try find a grammar that highlights keywords! If you are very fond of some theme lacking this, you can help it with a setting:

    \"editor.tokenColorCustomizations\": {\n    \"[Default Dark+]\": {\n        \"textMateRules\": [\n            {\n                \"scope\": [\n                    \"constant.keyword.clojure\"\n                ],\n                \"settings\": {\n                    \"foreground\": \"#6fbfff\"\n                }\n            }\n        ]\n    }\n},\n

    Instead of Default Dark+ you should use your theme's name/key. And choose a color you like, of course.

    "},{"location":"syntax-highlighting/#extra-highlighting","title":"Extra Highlighting","text":"

    You are in charge of how brackets and comments are highlighted via the calva.highlight.<setting> settings:

    Setting Meaning Example enableBracketColors Enable rainbow colors true rainbowIndentGuides Enable rainbow indent guides true highlightActiveIndent Highlight the active indent guide true bracketColors Which colors to use [\"#000\", \"#999\"] cycleBracketColors Whether same colors should be reused for deeply nested brackets true misplacedBracketStyle Style of misplaced bracket { \"border\": \"2px solid #c33\" } matchedBracketStyle Style of bracket pair highlight {\"backgroundColor\": \"#E0E0E0\"} ignoredFormStyle Style of #_... form {\"textDecoration\": \"none; opacity: 0.5\"} commentFormStyle Style of (comment ...) form {\"fontStyle\": \"italic\"}

    Calva disables the VS Code built-in indent guides

    The VS Code built-in settings editor.renderIndentGuides and editor.highlightActiveIndent do not have any effect, since the former is switched off by the Clojure Defaults, mentioned above. Use Calva Highlight's rainbowIndentGuides and highlightActiveIndent instead. They are different from the built in ones in that they are independent, meaning you can choose to have active indent highlighted while the guides generally are not rendered (this is the default, even).

    VS Code bracket coloring vs Calva's

    Calva's bracket coloring is more Clojure aware than VS Code's built-in coloring. And also will chime better with Calva's indent guides. If you like to have bracket coloring outside Clojure code, by all means enable it. Calva's bracket coloring will \u201dover paint\u201d in Clojure files, when enabled. These settings work nicely:

    \"calva.highlight.highlightActiveIndent\": true,\n\"editor.bracketPairColorization.enabled\": true,\n

    The calva.highlight.bracketColors setting can be used to harmonize the coloring between VS Code and Calva.

    "},{"location":"tao/","title":"The Tao of Calva","text":"

    Calva, the spirit, gains much of its taste and color from the Cider it is distilled from, and the oak it is matured in. I started to wonder what it is that shapes Calva, the VS Code Clojure Extension. I should know, being the master distiller, right?. Indeed. Poking some at the question, I do find that I have some answers.

    Please read the following to learn what Calva is, and, to some extent, is not, about. Read it to get an idea about which path Calva is following, where we are headed with the project, and how you can contribute to the journey.

    "},{"location":"tao/#why-calva","title":"Why Calva?","text":"

    Calva's raison d\u00b4\u00eatre is to provide Visual Studio Code users with an easy to use and productive environment for Clojure and ClojureScript development. See the Why Calva? page for some evidence that we are succeeding.

    While Calva draws a lot of inspiration from CIDER, Cursive, Fireplace, and other Clojure development environments, it does not try to compete with them. Reading r/Clojure and elsewhere, it is easy to get the impression that the most common question is \"Which editor should I use for Clojure development?\u201d. I think a much more common question is \u201dHow do I use my favorite editor for Clojure development?\u201d. For VS Code users, that is where Calva should be a good choice.

    I also have an ambition to leverage VS Code for easing the path to Clojure. Given that it is the favorite editor for so many developers, it is important to have a good development environment in place on this platform, and to make it as easy to use as we possibly can, while also being productive and something that you want to stick with, once you are hooked on Clojure.

    That said, and therefore: For people who want to start out with Clojure, and do ask about what development environment would make it the most enjoyable, I'd like for Calva to be a really good option, an option so good that Clojurians feel they can recommend it.

    "},{"location":"tao/#design-goals","title":"Design Goals","text":"

    Calva should be easy to start with and productive enough to stick with. It should support Clojure Best Practices, and be pleasant and enjoyable to use. It should also be easy to hack on, and to contribute to. The ClojureScript story keeps getting more important. Calva should contribute to making the development experience with ClojureScript delightful.

    "},{"location":"tao/#easy-to-start-with","title":"Easy to Start With","text":"

    There are reasons as to why VS Code is so popular. Among those, one stands out to me: It is the most approachable code editor out there. There is nothing you need to learn when you start using it. The editor makes it obvious that you can start typing, deleting, cutting, pasting and undoing, without having to figure anything out. Then you learn how to bring up the command palette and get a boost few other environments can provide with such immediacy.

    A language extension for VS Code can leverage this, by recognizing that what's old is old, and that what's new should be as easy as possible to pick up. Coming to a new language, people bring with them a lot of expectations from the languages they are used to. This is also true for the editor support. Syntax highlighting and formatting should just work, as should documentation lookup, linting and other IDE commodities.

    Clojure brings some new concepts to the table. Chief among these: The REPL. It does take some time to grasp it. Calva needs to remove any obstacles it can when it comes to helping the user to reach the REPL, in order to help getting it, and start loving it.

    To help the users to quickly focus on Clojure, we provide a package that is all-inclusive, with few knobs to turn, and with sane defaults for the knobs that still need to be there.

    "},{"location":"tao/#productive-enough-to-stick-with","title":"Productive Enough to Stick With","text":"

    I think VS Code brings inspiration also when it comes to following up its excellent Getting Started story. You do not have to dig very deep under its surface to find that there is a lot more power to be unleashed. VS Code makes it easy to pick up more features as you get ready for it, and each little piece makes you more productive. To me, only Vim beats VS Code in this game.

    Most often there should be no contradiction between Easy to Start With and Productive. Quite the contrary. This story is mainly about being feature complete with the most important tools. As beginners start to pick up the first few features, they should be rewarded with finding more productive tools when they go looking for them. The VS Code way is Calva's way.

    "},{"location":"tao/#pleasant-and-enjoyable","title":"Pleasant and Enjoyable","text":"

    Enjoyable starts with that Calva shouldn't be an experience full of pains. I think Calva is living up to this first bar of enjoyability. The next step is making it delightful!

    Calva has two main assets it can leverage for being delightful to use: Clojure and VS Code:

    Clojure is plain wonderful and also has this totally awesome REPL thing. Wherever we can, Calva should use the REPL to make the editor spark and bring joy to the developer.

    VS Code is a sweet development environment, offering its power in a consistent way across languages. Even if Clojure is very special, most of Calva's features are surfaced in the ways that VS Code encourages. It makes for less to learn for the user, and most often also makes it easier to implement functionality.

    "},{"location":"tao/#support-clojure-best-practices","title":"Support Clojure Best Practices","text":"

    Mainly, I think Stuart Halloway is right about the REPL being best used from inside the files you are editing rather than from the prompt. It doesn't mean that Calva's REPL window should be neglected, but efforts should be directed such that the file editor REPL is our first way to improve the experience. Expect the Calva REPL window to get much less \u201din your face\u201d, than it is today, as the editor REPL gets stronger.

    Halloway also gives me some peace of mind with his reasoning of keeping a spartan setup. Calva does not need to pack every feature imaginable. If we can get the right features in place, in the right way, the mission is accomplished.

    Clojure is data centric. Calva should make it easy to examine data and how our code affects it. Today, this is not good enough when it comes to data structures larger than a few elements.

    Clojure is a LISP. Thus Structural Editing is possible, and TBH, desirable. Calva should support this and encourage it. There is little we can do about Parinfer not playing well with VS Code, but there is Paredit, and Paredit rocks! Calva's Paredit plays in the top league of Paredits, for this reason.

    "},{"location":"tao/#made-from-the-produce-of-the-orchard","title":"Made from the Produce of the Orchard","text":"

    Calva is distilled from CIDER, which in turn is brewed from the products of The Orchard. This makes a lot of Calva's features thin wrappers around cider-nrepl and related middleware. It also should mean that we strive for adding features by thinking \u201dThe Orchard\u201d first. If it lacks what we need, we should assist in providing it there. We need to up this game a bit from where we are today, I think.

    "},{"location":"tao/#leveraging-clojure-lsp","title":"Leveraging clojure-lsp","text":"

    Today, Calva draws a lot of its static power from clojure-lsp. As does a lot of other Clojure tooling out there. The Calva and the clojure-lsp teams work very nicely together, which is something we cherish and should take care to maintain.

    "},{"location":"tao/#project-stewardship","title":"Project Stewardship","text":"

    Here Calva takes inspiration from many Clojure related projects, and perhaps most so from CIDER,shadow-cljs, and clojure-lsp. Bozhidar Batsov, Thomas Heller, and Eric Dallo all lead their projects with clarity and with gusto. You can feel how they really care about their products and their users. They are there. They listen. They respond. And they relentlessly keep improving their products.

    So we are there. We listen. We respond. And we keep trying to improve Calva.

    The Calva team cares deeply about the user experience. That is a major part of why we do this. When implementing a new feature, or changing a feature, Ux is always the first thing on our mind. Personally, to keep that direction I often start with the documentation of the feature. Reading the documentation before implementation reveals a lot about if the Ux design is within the ballpark or not.

    We have limited time on our hands, however, and we must cut some corners. We can't afford to spend very much time in Ux design. Rather we will use our Ux intuition, iterate the documentation quickly, and be fast to get things out. Then we are responsive in tweaking those things, based on user feedback. This also has impact on general quality at times. We only can do so much QA, and it happens that some releases of Calva cause disruptions in people's workflow because of things we haven't thought of, or not found during our testing. Again, we try to be attentive to feedback and quick to fix. Apologies in advance for any inconveniences caused!

    A super major part of our love for Ux is that Calva should be serving its users. That's why we treat feedback as a gift, listen intently, and use the feedback as a major ingredient in shaping Calva.

    Calva develops from user feedback in more direct ways as well. It is quite astonishing how many people have decided to improve on it by hacking it to do some small or big thing differently. That's great! We should make sure Calva is super easy to contribute to.

    There has been quite a lot of work put into improving the development process. Starting to hack on Calva is just a few steps, taking less than three minutes from cloning to running a dev version in the VS Code debugger. We encourage contributions, from the tiniest typo to whole new features. And we are ready to spend time helping people get their contributions integrated.

    However, Calva can't be what everyone wants it to be, that would make it useless. It needs direction and aim. And it is we, the Calva Team, who are the stewards. We need to be in charge of what Calva is about, and what it is not about.

    "},{"location":"tao/#the-road-ahead","title":"The Road Ahead","text":"

    Tying back to Stuart Halloway, I don't think he means that spartan needs to also mean poor. The products he helps to bring to the market tell another story. VS Code and Clojure brought together has the capacity to create something amazingly rich and luxurious. And I want Calva to tap into that potential.

    On the Calva journey we will allow ourselves to change our minds about how things work. Calva is not a library. Its an interface between Clojure and human beings. Human beings can adapt. And they will need to enjoy adapting in order to enjoy Calva. \ud83d\ude04

    By now it should be clear that you can expect Calva to keep evolving, keep being tended and maintained, and keep getting ever more enjoyable to use. Lately we have been improving Calva pretty rapidly. It would be great to keep it up like that, but I think it is good to expect a more humble and sustainable pace.

    Calva is still quite new. A bit like freshly distilled Calvados. It will need time in those oak barrels to develop its full bouquet of flavors. And time is what we will give it. Our time, our creativity, and our passion.

    "},{"location":"test-runner/","title":"Test Runner","text":"

    Calva provides commands that make running your Clojure tests easier.

    Note

    Since the test commands utilize cider-nrepl, they only work with Clojure, not ClojureScript. See this issue for more details.

    "},{"location":"test-runner/#test-commands","title":"Test Commands","text":"Command Shortcut Description Run All Tests ctrl+alt+c shift+t Runs all tests Run Failing Tests ctrl+alt+c ctrl+t Runs the tests that failed Run Tests for Current Namespace ctrl+alt+c t Runs the tests for the current namespace. If not a -test namespace, tests for the current namespace plus its corresponding <current-namespace>-test namespace will be run. Run Current Test ctrl+alt+c ctrl+alt+t Runs the test at the cursor. This includes a defn with a :test in its metadata, a defn defined in a with-test, and a deftest. Toggle between implementation and test - Switches the file between implementation and test, prompts to create a new file if not found."},{"location":"test-runner/#test-on-save","title":"Test on Save","text":"

    You can enable the Calva setting \"Test on Save\" to have tests for the current namespace run on file save.

    "},{"location":"test-runner/#vs-code-test-ui","title":"VS Code Test UI","text":"

    Calva has experimental support for showing test results in VS Code's Test UI. You can enable this support by setting calva.useTestExplorer to true. When you enable this setting, the Testing icon will appear in the Testing tab of VS Code's Activity Bar.

    With this feature enabled you will be able to browse and run tests directly from the Testing tab.

    Please join the #calva channel on the Clojurians Slack if you have any feedback on this new feature.

    "},{"location":"test-runner/#troubleshooting","title":"Troubleshooting","text":""},{"location":"test-runner/#tests-are-not-found","title":"Tests Are Not Found","text":"

    Calva will not load namespaces in the REPL that you haven't loaded. This is so that you can be in control of what is loaded in the REPL. However, it also means that commands like Run All tests actually mean Run All Tests That are Loaded in the REPL, since the test-runner only runs tests that it knows about, i.e. are loaded in the REPL. Some developers choose to make sure all test namespaces are loaded as part of starting their REPL. Others register a custom REPL command for loading test namepaces. (Yet others use test-runners such as Cognitect's test-runner, Kaocha, poly test, or some other that runner allows for tests being run automatically, separate from the REPL used for development.)

    If you have tests in a test directory separate from your source directory, and those tests are not being found by the test runner, make sure the test directory is included in your paths. This will not be the case by default with a tools.deps (deps.edn) project. If your project is a tools.deps project, you can create an alias in your deps.edn file with :extra-paths that includes \"test\" (or the name of your test directory).

    {:aliases {:dev {:extra-paths [\"test\"]}}}\n
    "},{"location":"test-runner/#changes-arent-taking-effect-when-running-tests","title":"Changes Aren't Taking Effect When Running Tests","text":"

    In order for changes in code to take effect, you need to load the file or evaluate the changed code before running a test command. Prior to version 2.0.301, Calva would load the file for you when running some test commands, but that behavior was removed in favor of leaving control to the user, and to avoid a potential issue.

    Having added the above to your deps.edn, when you jack-in, choose the :dev alias and the test directory will be added to your paths, which will allow tests located in the directory to be found by the test runner.

    "},{"location":"test-runner/#toggle-between-implementation-and-test-command-not-working-as-intended","title":"Toggle between implementation and test command not working as intended","text":"

    This feature mostly works with projects that has leiningen style folder structure and makes some assumption about your folder structure and test file names.

    If you are using any non leiningen style folder structure, you may have to add source paths inside .lsp/config.edn.

    "},{"location":"try-first/","title":"Something to Try First (After Connecting)","text":"

    You should start with loading the file you are working with. Do this with Load/Evaluate Current File and its Requires/Dependencies, ctrl+alt+c enter.

    To get a feeling for evaluating code in the editor and get immediate response from the REPL try this:

    (comment\n  (+ (* 2 2)\n      2)\n  (Math/abs -1)\n  (hello \"Calva REPL\")\n  (defn hello [s]\n    (str \"Hello \" s))\n  (range 10)\n  \"I \u2665\ufe0f Clojure\")\n

    Then:

    1. Place the cursor behind the form (* 2 2) and issue the command Calva: Evaluate Current Form, ctrl+enter.
      • You should see the result being displayed inline. Press esc to dismiss it.
    2. Now issue the command Evaluate Current Top Level Form (defun), alt+enter.
      • You should see the whole form (+ (* 2 2) 2) getting highlighted and the result of that expression being displayed inline.
    3. Evaluate each form inside the comment form using the Top Level command.
      • You should see each one of them evaluated.
      • Evaluating the (hello \"Calva REPL\") form before the (defn hello... form should result in an error/exception. A stacktrace is then printed in the output window
      • Try it again after having evaluated the defnform.

    Demo:

    "},{"location":"try-first/#how-does-this-work","title":"How does this work?","text":"

    Calva has this notion about the current form. Issue the Evaluate Current Form command, with the cursor placed in different locations to get a feeling for how the current form is determined.

    There is also a concept about the current top level form. Good for evaluating various defs defn, defthis, defthat. With your cursor placed anywhere inside such a form.

    The Top Level command also works inside (comment ...) forms, treating the comment as creating a new top level context. It is good for in-file code experimentation.

    "},{"location":"try-first/#see-also","title":"See also","text":""},{"location":"vim/","title":"Calva and the VIM Extension","text":"

    First thing first. The VIM Extension and Calva has a history of friction between them. Less so these days, but you might still encounter some rough edges. Please don't hesitate to reach out to the Calva team, as we might be able to fix things if only we are aware of them.

    "},{"location":"vim/#key-bindings","title":"Key bindings","text":"

    In general Calva's default key bindings are not very VI-ish.

    "},{"location":"vim/#expand-selection-on-mac","title":"Expand selection on Mac","text":"

    On Mac, Calva binds expand selection to ctrl+w. This conflicts with the VIM Extension's default mapping of window splitting shortcuts. You'll need to remap it either with Calva or with the VIM Extension.

    "},{"location":"vim/#the-esc-key","title":"The esc key","text":"

    While showing inline evaluation results, Calva binds the esc key to dismiss the display of inline results. If you want to be able to use the esc key to enter command mode while inline results are showing, you'll need to rebind Calva's command for dismissing the inline results.

    "},{"location":"vim/#remap-calvas-clearinlineresults","title":"Remap Calva's clearInlineResults","text":" 
    // Place your key bindings in this file to override the defaults\n[\n  {\n    \"key\": \"escape\",\n    \"command\": \"-calva.clearInlineResults\"\n  },\n  {\n    \"key\": \"shift+escape\",\n    \"command\": \"calva.clearInlineResults\",\n    \"when\": \"editorTextFocus && !editorHasMultipleSelections && !editorReadOnly && !hasOtherSuggestions && !suggestWidgetVisible && editorLangId == 'clojure'\"\n  }\n]\n

    If you run into issues, refer to the commands in the default Keyboard Shortcuts JSON file.

    "},{"location":"vim/#remap-vims-insert-mode","title":"Remap Vim's Insert Mode","text":"

    Remap vim's insert mode keybinding to go into command mode by adding the following to your user settings:

    \"vim.insertModeKeyBindings\": [\n    {\n        \"before\": [\"j\", \"k\"],\n        \"after\": [\"<esc>\"]\n    }\n]\n

    (Change before to whatever keybinding you are comfortable with!)

    "},{"location":"vim/#vim-fireplace-ish-keybindings","title":"Vim Fireplace-ish keybindings","text":"

    You can add these keybindings to your init.vim if you are using the VSCode Neovim extension. It is inspired by and tries to emulate the keybindings found in vim-fireplace which is the most popular vim plugin for Clojure.

    nmap cqp :call VSCodeNotify('calva.jackIn')<CR>\nnmap cqq :call VSCodeNotify('calva.disconnect')<CR>\nnmap cpr :call VSCodeNotify('calva.loadFile')<CR>\nnmap cpR :call VSCodeNotify('calva.loadNamespace')<CR>\nnmap cpp :call VSCodeNotify('calva.evaluateSelection')<CR>\nnmap cqc :call VSCodeNotify('calva.evalCurrentFormInREPLWindow')<CR>\n

    Unfortunately these key combinations will not work in the normal VIM extension as c is an operator key and cannot be remapped. This is a call for someone to share their VIM re-mappings.

    "},{"location":"when-clauses/","title":"Calva When Clause Contexts","text":"

    When clause contexts is a powerful customization mechanism in VS Code. The most common use for end users is with keyboard shortcut bindings. Extensions can provide their own. The following contexts are available with Calva:

    "},{"location":"why-calva/","title":"Why Calva?","text":"

    The main reason you would choose Calva for your Clojure and/or ClojureScript coding is that you want to use Visual Studio Code. Calva provides VS Code users with a comprehensive set of features to keep you productive and make it easy to follow Clojure coding best practices. This also means that if your choice of editor is not made yet, we think you should give VS Code and Calva a try.

    While Calva is a good choice for professional and experienced Clojure developers, great care has been taken in making Calva a really good choice for beginners of Clojure as well.

    We who make Calva are actively stewarding, maintaining, documenting and supporting it. We are also very active Clojure (and Calva) users, participating in the community. Clojure is dear to us, a lot because it keeps programming fun and rewarding.

    Calva has very happy users! Check out the Programming Languages section on the Visual Studio Code Marketplace, sorted by rating:

    Recently there was a thread over at ClojureVerse, asking about how Calva Compares to Emacs with CIDER. It is well worth reading. We would like to highlight the answer by Nick Cernis, which focuses on Calva. We'll even quote parts of it. \ud83d\ude0d

    "},{"location":"why-calva/#nick-cernis-on-clojureverse","title":"Nick Cernis on ClojureVerse","text":"

    My advice to anyone starting their Clojure journey who is unsure about what editor to use:

    I now use VS Code with Calva every day but went through a long journey trying almost every other editor and plugin combo first. I switched from Emacs to VS Code, which might make my perspective different to others here.

    \u2026

    I started with the jaded assumption that VS Code was probably bad because it's built by committee at Microsoft on a web-tech based Electron stack, only to find that it succeeds in embodying the spirit of a \u201chacker's editor\u201d more than even Emacs does in many ways:

    \u2026

    On the benefits of Calva:

    "},{"location":"why-calva/#100-five-star-marketplace-reviews","title":"100% Five-star Marketplace Reviews","text":"

    We are super proud of the Calva reviews on the Visual Studio Code Marketplace. Please read them all. \ud83d\ude04 Here's a selection that we think captures what we focus on in when developing Calva:

    \u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f Calva has become an essential part of my Clojure workflow.

    It's an incredible piece of work by the team behind it.

    Sean Corfield

    \u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f Calva hits the sweet spot of being both approachable for new users and powerful for seasoned ones.

    The creators/maintainers are fantastic individuals that care deeply about streamlining the user experience, and it shows.

    Good stuff, check it out.

    Clay Hopperdietzel

    \u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f I switched from IntelliJ / Cursive to VS Code and Calva and it's been amazing.

    ...

    That is the biggest thing I can say for Calva, it just works. I was never a fan of VS Code before, but VS Code + Calva for Clojure is now my favorite language / IDE experience.

    Plus, the #calva on the clojurians slack is brilliant, always someone there to help if you have issues (although any issue I've had has been squarely on me, and never Calva itself).

    I often feel we live in an age where so much software is badly written, without care, slow, buggy and just generally awful. Calva is the complete opposite. I think the maintainers want to, and have, made a wonderful piece of software for Clojure developers.

    Stuart Stein

    \u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f This is great, and makes VS Code a truly viable IDE/editor for clojure development.

    It already has great REPL support (including inline evaluation), an extensive Paredit implementation, and excellent linting (care of the bundled clj-kondo). Calva is being improved on at an impressive clip by maintainers who appear solidly committed to its ongoing development. It's well-documented, and manages to be both approachable and capable.

    A no-brainer if you're already a VS Code user, and well worth a look if you're not.

    Crispin Bennett

    \u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f\u2605\ufe0f\ufe0f\ufe0f\ufe0f\ufe0f I'm using Calva now for a few months and I'm loving it.

    I joined the Slack channel about 2 wks ago and I must say that I'm very impressed by how active and responsive this community is. Already 2 of my issues fixed and I really like Calva (and the extensions it uses!).

    These are professional people and they make me very happy!

    Uitbeijerse, E (Eric)

    "},{"location":"workspace-layouts/","title":"Workspace Layouts","text":"

    Project directory layouts can vary quite a lot. From the \u201dtemplate\u201d projects where the Clojure project files are at the root, to, well, let's just say that the project files are not always at the root. And sometimes there is more than one project (read here how to get clojure-lsp support with a Leiningen project in a subfolder).

    Calva only really supports working with one project at a time per VS Code window. Here's a short guide for some different setups:

    1. You have one project in the workspace, the project files are in there somewhere.
      • Use a regular VS Code \u201dfolder window\u201d or a Workspace proper, both will totally work.
    2. You have more than one project in the repository, but only really work with one at a tine.
      • Use a Workspace proper and add the different project directories as separate Workspace Folders.
      • You can only jack-in/connect to one project at a time.
    3. You have more than one project in the repository, and need to work with them in parallell.
      • Open each project you want to work with in a separate VS Code window.
    "},{"location":"workspace-layouts/#one-folder-two-windows","title":"One Folder - Two Windows?","text":"

    As is mentioned in the Calva Jack-In Guide, if you have a full stack project using a Clojure backend and a shadow-cljs frontend, you will need to open the same project in two separate VS Code windows, one for the backend and one for the frontend. This is how you can do that:

    1. Open a new VS Code window.
    2. Select File->Add Folder to Workspace.... Save the workspace as, say, Server.code-workspace.
    3. Open a new VS Code window.
    4. Select File->Add Folder to Workspace.... Save the workspace as, say, Client.code-workspace.

    Now, whenever you want to Jack-in to the backend and/or frontend, do it from the Server and/or Client workspace, respectively.

    "},{"location":"wsl/","title":"Calva \u2764\ufe0f WSL","text":"

    The use of Calva with WSL (Windows Subsystem for Linux) is fully supported through the Remote - WSL extension. Simply install the extension and open your project with one of the Remote-WSL commands. Calva will run directly in the WSL environment and no further configuration is required.

    "},{"location":"wsl/#steps-involved","title":"Steps Involved","text":"
    1. Enable WSL
    2. Install Ubuntu in WSL
    3. Install Java in WSL
    4. Install latest Clojure in WSL
    5. Install the Remote - WSL extension in VS Code
    6. Launch remote window
    7. Install Calva (gets installed into the WSL instance)
    8. Work away

    See also Remote Development.

    "}]} \ No newline at end of file diff --git a/shadow-cljs/index.html b/shadow-cljs/index.html index e4ae1f85f..8782bc953 100644 --- a/shadow-cljs/index.html +++ b/shadow-cljs/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/sitemap.xml b/sitemap.xml index e2c709ed1..832202d67 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2,302 +2,307 @@ https://calva.io/ - 2024-04-15 + 2024-04-17 daily https://calva.io/api/ - 2024-04-15 + 2024-04-17 daily https://calva.io/async-out/ - 2024-04-15 + 2024-04-17 daily https://calva.io/babashka/ - 2024-04-15 + 2024-04-17 daily https://calva.io/clj-java-decompiler/ - 2024-04-15 + 2024-04-17 daily https://calva.io/clojure-lsp/ - 2024-04-15 + 2024-04-17 daily https://calva.io/clojuredart/ - 2024-04-15 + 2024-04-17 daily https://calva.io/clojuredocs/ - 2024-04-15 + 2024-04-17 daily https://calva.io/commands-top10/ - 2024-04-15 + 2024-04-17 daily https://calva.io/connect-sequences/ - 2024-04-15 + 2024-04-17 daily https://calva.io/connect/ - 2024-04-15 + 2024-04-17 daily https://calva.io/contribute/ - 2024-04-15 + 2024-04-17 daily https://calva.io/custom-commands/ - 2024-04-15 + 2024-04-17 daily https://calva.io/customizing-jack-in-and-connect/ - 2024-04-15 + 2024-04-17 daily https://calva.io/customizing/ - 2024-04-15 + 2024-04-17 daily https://calva.io/debugger/ - 2024-04-15 + 2024-04-17 daily https://calva.io/emacs-keybindings/ - 2024-04-15 + 2024-04-17 daily https://calva.io/eval-tips/ - 2024-04-15 + 2024-04-17 daily https://calva.io/evaluation/ - 2024-04-15 + 2024-04-17 daily https://calva.io/fiddle-files/ - 2024-04-15 + 2024-04-17 daily https://calva.io/finding-commands/ - 2024-04-15 + 2024-04-17 daily https://calva.io/formatting/ - 2024-04-15 + 2024-04-17 daily https://calva.io/get-started-with-clojure/ - 2024-04-15 + 2024-04-17 daily https://calva.io/getting-started/ - 2024-04-15 + 2024-04-17 daily https://calva.io/hiccup/ - 2024-04-15 + 2024-04-17 + daily + + + https://calva.io/inspector/ + 2024-04-17 daily https://calva.io/jack-in-guide/ - 2024-04-15 + 2024-04-17 daily https://calva.io/joyride/ - 2024-04-15 + 2024-04-17 daily https://calva.io/krell/ - 2024-04-15 + 2024-04-17 daily https://calva.io/linting/ - 2024-04-15 + 2024-04-17 daily https://calva.io/live-share/ - 2024-04-15 + 2024-04-17 daily https://calva.io/luminus/ - 2024-04-15 + 2024-04-17 daily https://calva.io/merch/ - 2024-04-15 + 2024-04-17 daily https://calva.io/namespace-form-auto-creation/ - 2024-04-15 + 2024-04-17 daily https://calva.io/nbb/ - 2024-04-15 + 2024-04-17 daily https://calva.io/notebooks/ - 2024-04-15 + 2024-04-17 daily https://calva.io/nrepl_and_cider-nrepl/ - 2024-04-15 + 2024-04-17 daily https://calva.io/output/ - 2024-04-15 + 2024-04-17 daily https://calva.io/paredit/ - 2024-04-15 + 2024-04-17 daily https://calva.io/parinfer/ - 2024-04-15 + 2024-04-17 daily https://calva.io/polylith/ - 2024-04-15 + 2024-04-17 daily https://calva.io/pprint/ - 2024-04-15 + 2024-04-17 daily https://calva.io/quirks/ - 2024-04-15 + 2024-04-17 daily https://calva.io/re-frame-template/ - 2024-04-15 + 2024-04-17 daily https://calva.io/rebl/ - 2024-04-15 + 2024-04-17 daily https://calva.io/refactoring/ - 2024-04-15 + 2024-04-17 daily https://calva.io/remote-development/ - 2024-04-15 + 2024-04-17 daily https://calva.io/repl-window/ - 2024-04-15 + 2024-04-17 daily https://calva.io/reveal/ - 2024-04-15 + 2024-04-17 daily https://calva.io/rich-comments/ - 2024-04-15 + 2024-04-17 daily https://calva.io/shadow-cljs/ - 2024-04-15 + 2024-04-17 daily https://calva.io/sponsors/ - 2024-04-15 + 2024-04-17 daily https://calva.io/syntax-highlighting/ - 2024-04-15 + 2024-04-17 daily https://calva.io/tao/ - 2024-04-15 + 2024-04-17 daily https://calva.io/test-runner/ - 2024-04-15 + 2024-04-17 daily https://calva.io/try-first/ - 2024-04-15 + 2024-04-17 daily https://calva.io/vim/ - 2024-04-15 + 2024-04-17 daily https://calva.io/when-clauses/ - 2024-04-15 + 2024-04-17 daily https://calva.io/why-calva/ - 2024-04-15 + 2024-04-17 daily https://calva.io/workspace-layouts/ - 2024-04-15 + 2024-04-17 daily https://calva.io/wsl/ - 2024-04-15 + 2024-04-17 daily \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz index 359ce371ef69f492f0c5271cb74d4086b339ea81..55cd580498b95beff743da461f07ad6526b97820 100644 GIT binary patch literal 685 zcmV;e0#f}SiwFqrf*)oA|8r?{Wo=<_E_iKh0L_`pZrd;rMfdp%!~3zEAV42*oL#=4 zT?Z63l4$c4KBTB$-;t8ES$0)i0fIz=pbp5vojcU&@zvSg#3`HLANIG0<9^3phtBxn zVgK{T6Mfx3o^MVy+011pgMEJ3kEO)#O*7B)A)CTZ#e4{9XtExqk(>9<=6LwFKi}-+ zS|@mW+pd!h`n=APWg4yQqz)!Dr)KT`JWA!_LU+D9-rdvjo^HR$koUe%!}O^9zj8d_6P;$J?lc5U#f^VXFN76qLNHo3nM|*T!N#I5Q8H# zzr+xTy6P(#Pl8B*8~c|Oh^phZ4g*vw5^tt6U3qDZUyUA8xbdVc6%)~zsw(1;fuMTR zb(X0Yo0Fliwva+pvOXlIO2LwcfhBJjv0vQLY|2RQ-UkbDU9=BOAhOYDU6Jgx@i|IT z3`lDKk+g?uI;60=ge74ST@zai#AA&IQ!8sGraUSreX`XVUy(A6_rMx%}^)B^SIE~Kw=7F^0q?Rszr(!sP)SK TA@gmI%;o$Wdm!1r86*Gzc1=r# literal 678 zcmV;X0$KeZiwFpzpB-ib|8r?{Wo=<_E_iKh0L__AZrd;rh4(py;XN%UNP)I+oLx@P zt^<(9$$msOjN2%@nL(r+iy1%O|mWy z58IzVp48XvG2O zxo+_GYkdwrnd5brD%%+CC%tp2J9O9S&#QFhknHhpe|N9;_v-eGEP0>%w9Je;4sOxEJ;??LOr5jD!D|Q);sc9C63!E#M0+Ef*n1*DhKMLf~ zoJ9)ZIV}Z?=u*ggARg}`m@;@bk*cGH(gNRtiw#ND0~Ip@@kAY{W^JT2OTAILaZ;ub znth0Uk3^H0`jjq6i4_ZF|12Kn*@$!&wT^-KQsWGDC74C3tOFx*@dVX-<>VJHJ`V{g z%PAp+?WMT_B?U#qyojzVrjWgcx;ZM;dnlZfHk=BUmnsyb!YE4<`IG}erTew6NbeVI znxUvB(omV@%(z}FNc51zK`gpNPWtvU6je^KrUHeuMAolrbi?T71J-V_M*0Jqsj@09 zMkw>bWl<+rDw29mE&$QYBSnz{-73_r>^v@N9Uw6!F?nmF?DZne4Agnm|4{kXuS$IU M4aA - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/syntax-highlighting/index.html b/syntax-highlighting/index.html index 9b3a935d4..6ba3dfbbd 100644 --- a/syntax-highlighting/index.html +++ b/syntax-highlighting/index.html @@ -673,11 +673,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -694,11 +694,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -715,11 +715,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -736,11 +736,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -757,11 +757,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -778,11 +778,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -799,11 +799,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -820,11 +820,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -841,11 +841,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -924,6 +924,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/tao/index.html b/tao/index.html index 4a35f064c..7948d2bd7 100644 --- a/tao/index.html +++ b/tao/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/test-runner/index.html b/test-runner/index.html index 5d20b29c5..2830c61b0 100644 --- a/test-runner/index.html +++ b/test-runner/index.html @@ -16,7 +16,7 @@ - + @@ -615,11 +615,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -636,11 +636,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -657,11 +657,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -678,11 +678,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -699,11 +699,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -720,11 +720,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -741,11 +741,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -762,11 +762,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -783,11 +783,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -981,6 +981,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/try-first/index.html b/try-first/index.html index 316f36923..5538b0be0 100644 --- a/try-first/index.html +++ b/try-first/index.html @@ -673,11 +673,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -694,11 +694,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -715,11 +715,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -736,11 +736,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -757,11 +757,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -778,11 +778,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -799,11 +799,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -820,11 +820,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -841,11 +841,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -924,6 +924,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/vim/index.html b/vim/index.html index 3c8a60007..b6dc4db0d 100644 --- a/vim/index.html +++ b/vim/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/when-clauses/index.html b/when-clauses/index.html index 498d01a13..819fe3ba7 100644 --- a/when-clauses/index.html +++ b/when-clauses/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/why-calva/index.html b/why-calva/index.html index f8d19787f..ab8492343 100644 --- a/why-calva/index.html +++ b/why-calva/index.html @@ -671,11 +671,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -692,11 +692,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -713,11 +713,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -734,11 +734,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -755,11 +755,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -776,11 +776,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -797,11 +797,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -818,11 +818,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -839,11 +839,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -922,6 +922,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/workspace-layouts/index.html b/workspace-layouts/index.html index adef901f0..374195d25 100644 --- a/workspace-layouts/index.html +++ b/workspace-layouts/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +
  • diff --git a/wsl/index.html b/wsl/index.html index c72e39f7c..e2ce51721 100644 --- a/wsl/index.html +++ b/wsl/index.html @@ -613,11 +613,11 @@
  • - + - Rich Comments Support + The REPL Window @@ -634,11 +634,11 @@
  • - + - Fiddle Files Support + Evaluation results and outher output @@ -655,11 +655,11 @@
  • - + - Refactoring + Inspect Evaluation Results and more @@ -676,11 +676,11 @@
  • - + - Custom REPL Commands + Fiddle Files Support @@ -697,11 +697,11 @@
  • - + - Custom REPL Connect Sequences + Refactoring @@ -718,11 +718,11 @@
  • - + - Clojure Notebooks + Custom REPL Commands @@ -739,11 +739,11 @@
  • - + - ClojureDocs Integration + Custom REPL Connect Sequences @@ -760,11 +760,11 @@
  • - + - The REPL Window + Clojure Notebooks @@ -781,11 +781,11 @@
  • - + - Evaluation results and outher output + ClojureDocs Integration @@ -864,6 +864,27 @@ +
  • + + + + + Rich Comments Support + + + + +
    • + + + + + + + + + +