Welcome to the Live docs! Keep this little window open while you work on the notebook, and you will get documentation of everything you type!
You can also type a query above.
Still stuck? Here are some tips.
",loading:!1}),c=e=>l(le((t=>e(t))));i.useEffect((()=>{s.loading||(null==t||/[^\s]/.test(t))&&s.searched_query!==t&&d(t)}),[t,s.loading,s.searched_query]),i.useLayoutEffect((()=>{e&&r.current&&(r.current.focus({preventScroll:!0}),r.current.select())}),[e,r.current]);let d=e=>{c((t=>{t.loading=!0,t.searched_query=e})),Promise.race([no.default.Promises.delay(2e3,!1),a.send("docs",{query:e.replace(/^\?/,"")},{notebook_id:o.notebook_id}).then((t=>"⌛"!==t.message.status&&("👍"===t.message.status?(c((n=>{n.shown_query=e,n.body=t.message.doc})),!0):void 0)))]).then((()=>{c((e=>{e.loading=!1}))}))},u=i.useMemo((()=>i.html`<${tl} body=${ro(s.body)} />`),[s.body]),p=!1===s.loading&&""!==s.searched_query&&s.searched_query!==s.shown_query;return i.html` +
+ n(e.target.value)}
+ value=${t}
+ type="search"
+ >
+
+
+ ${s.shown_query}
+ ${u}
+
+
+
`),zo=({offer_binder:e,start_binder:t,notebookfile:n,notebook:o})=>{const[a,r,s,l]=Uo({light_dismiss:!0}),[c,d]=i.useState(!1),u=i.useRef("");u.current=n??"",window.open_edit_or_run_popup=r,i.useEffect((()=>(window.start_binder=e?t:null,()=>{window.start_binder=null})),[t,e]);const p=u.current.startsWith("data:"),m=qo(o);return i.html`
+
+
+
`},qo=e=>{const t=(e=>{var t;return(((null===(t=e.nbpkg)||void 0===t?void 0:t.install_time_ns)??NaN)+ce.default.sum(Object.values(e.cell_results).map((e=>e.runtime??0))))/1e9})(e);if(isNaN(t))return null;const n=ce.default.round(15+1.5*t,-1);return Ho(n)},Ho=e=>{const t=e/60,n=Math.ceil(e),o=Math.round(t);return e<60?`${n} second${n>1?"s":""}`:`${o} minute${o>1?"s":""}`};var Wo;Wo=new URL(r("ko7kR").resolve("asIno"),import.meta.url).toString();const Ko=new URL(Wo);var Go;Go=new URL(r("ko7kR").resolve("1c0Rm"),import.meta.url).toString();const Vo=new URL(Go);var Zo;Zo=new URL(r("ko7kR").resolve("fUvXZ"),import.meta.url).toString();const Qo=new URL(Zo),Xo=e=>{window.dispatchEvent(new CustomEvent("open pluto popup",{detail:e}))},Yo=({notebook:e,disable_input:t})=>{const[n,o]=i.useState(null),a=i.useRef(null);a.current=n;const r=i.useRef(null),s=i.useRef(""),l=e=>{const t=e.detail.source_element;if(r.current=t,null==t)s.current="top: 20%; left: 50%; transform: translate(-50%, -50%); position: fixed;";else{const e=t.getBoundingClientRect(),n=document.body.getBoundingClientRect();s.current=`top: ${.5*(e.top+e.bottom)-n.top}px; left: min(max(0px,100vw - 251px - 30px), ${e.right-n.left}px);`}o(e.detail)},c=()=>{o(null)};i.useEffect((()=>{const e=e=>{null!=a.current&&null!=e.target&&null==e.target.closest("pluto-popup")&&(null!=r.current&&r.current.contains(e.target)||c())},t=e=>{"Escape"===e.key&&c()};return window.addEventListener("open pluto popup",l),window.addEventListener("close pluto popup",c),window.addEventListener("pointerdown",e),document.addEventListener("keydown",t),()=>{window.removeEventListener("open pluto popup",l),window.removeEventListener("close pluto popup",c),window.removeEventListener("pointerdown",e),document.removeEventListener("keydown",t)}}),[]);const d=null==n?void 0:n.type;return i.html`${null==n?void 0:n.body}
`:null}
+
+ Installation can take ${Ho(E)}${". "}
${"Afterwards, it loads in "} + ${Ho($)}. +
`:null}
+ ${"Afterwards, it loads in "} + ${Ho($)}. +
+ {_?alert("Pkg is currently busy with other packages... come back later!"):confirm("Would you like to check for updates and install them? A backup of the notebook file will be created.")&&(console.warn("Pkg.updating!"),u.send("pkg_update",{},{notebook_id:e.notebook_id})),t.preventDefault()}}
+ >
+ {f(!h),e.preventDefault()}}
+ >
+ 
+
+ <${po} value=${v??"Loading..."} />
+
+
+
+ `},ia=({status:e,notebook:t,backend_launch_logs:n,my_clock_is_ahead_by:o})=>i.html`
+ {c(!l)}}
+ >
+
+ ${(e=>{const t=ca[e];return null!=t?t:pa(e)?`Step ${e}`:e})(s.name)}${v}
+ ${u?ta(da(g-m)):p?ta(da(_)):null}
+
+ ${b}
+ ${l&&"pkg"===s.name?i.html`<${po} value=${null==o||null===(r=o.terminal_outputs)||void 0===r?void 0:r.nbpkg_sync} />`:l&&"backend_launch"===s.name?i.html`<${po} value=${a} />`:void 0}
+
+ : @htl, @htl_str
+
+ `),side:1}).range(e.to)}}}))})).filter((e=>null!=e));return St.Decoration.set(r,!0)}const Wa=St.Facet.define({combine:e=>e[0],compare:ce.default.isEqual}),Ka=({pluto_actions:e,notebook_id_ref:t})=>St.ViewPlugin.fromClass(class{update_decos(n){const o=Ha(n,{pluto_actions:e,notebook_id:t.current,nbpkg:n.state.facet(Wa)});this.decorations=o}constructor(e){this.update_decos(e)}update(e){(e.docChanged||e.viewportChanged||e.state.facet(Wa)!==e.startState.facet(Wa))&&this.update_decos(e.view)}},{decorations:e=>e.decorations,eventHandlers:{pointerdown:(e,t)=>{e.target}}});ce=r("9Ta4i"),St=r("hiQgq"),i=r("cNaMA");const Ga=St.StateEffect.define({}),Va=St.StateField.define({create:()=>({defaultCharacterWidth:null,measuredSpaceWidth:null,measuredTabWidth:null}),update(e,t){for(let e of t.effects)if(e.is(Ga))return e.value;return e}});let Za=St.EditorView.updateListener.of((e=>{let t=e.view.defaultCharacterWidth,{defaultCharacterWidth:n,measuredSpaceWidth:o}=e.view.state.field(Va,!1);if(n!==t){let n,o;e.view.dispatch({effects:[Ga.of({defaultCharacterWidth:t,measuredSpaceWidth:n,measuredTabWidth:o})]})}})),Qa=St.StateField.define({create:()=>St.Decoration.none,update(e,t){let n=t.startState.field(Va,!1),o=n.measuredSpaceWidth??n.defaultCharacterWidth,{measuredSpaceWidth:a,defaultCharacterWidth:r}=t.state.field(Va,!1),s=a??r;if(null==s)return St.Decoration.none;if(!t.docChanged&&e!==St.Decoration.none&&o===s)return e;let l=[];for(let e of ce.default.range(0,t.state.doc.lines)){let n=t.state.doc.line(e+1);if(0===n.length)continue;let o=0;for(let e of n.text){if("\t"!==e)break;o++}const a=Math.min(o,12),r=4*a*s,c=St.Decoration.line({attributes:{style:`--indented: ${r}px;`,class:"awesome-wrapping-plugin-the-line"}});if(l.push(c.range(n.from,n.from)),0!==a&&l.push(St.Decoration.mark({class:"awesome-wrapping-plugin-the-tabs"}).range(n.from,n.from+a)),o>a)for(let e of ce.default.range(a,o))l.push(St.Decoration.replace({widget:new za(i.html`⇥ `),block:!1}).range(n.from+e,n.from+e+1))}return St.Decoration.set(l)},provide:e=>St.EditorView.decorations.from(e)}),Xa=St.Decoration.mark({class:"indentation-so-dont-break"}),Ya=(St.StateField.define({create:()=>St.Decoration.none,update(e,t){let n=[];for(const e of t.newDoc)for(const t of e.matchAll(/[^ \t]+([ \t]|$)+/g))null!=t.index&&0!==t.index&&n.push(Xa.range(0+t.index,0+t.index+t[0].length));return St.Decoration.set(n,!0)},provide:e=>St.EditorView.decorations.from(e)}),[Va,Za,Qa]);let Ja=(St=r("hiQgq")).autocomplete.autocompletion()[0],er=St.EditorView.domEventHandlers({keydown:(e,t)=>{var n;let o=t.state.selection.main;if(!o.empty)return!1;if(!e.repeat)return!1;if("Backspace"===e.key&&0===t.state.doc.length)return!0;if("Delete"===e.key&&0===t.state.doc.length)return!0;let a=(null===(n=t.state.field(Ja,!1))||void 0===n?void 0:n.open)??!1;return"ArrowUp"!==e.key||a?"ArrowDown"!==e.key||a?"ArrowLeft"===e.key&&e.repeat?!!t.moveByChar(o,!1).eq(o):"ArrowRight"===e.key?!!t.moveByChar(o,!0).eq(o):void 0:!!t.moveVertically(t.state.selection.main,!0).eq(o):!!t.moveVertically(t.state.selection.main,!1).eq(o)}}),tr=({focus_on_neighbor:e})=>(({focus_on_neighbor:e})=>St.keymap.of([{key:"PageUp",run:()=>(e({cell_delta:-1,line:0,character:0}),!0)},{key:"PageDown",run:()=>(e({cell_delta:1,line:0,character:0}),!0)},{key:"ArrowLeft",run:t=>{let n=t.state.selection.main;return!!n.empty&&!!t.moveByChar(n,!1).eq(n)&&(e({cell_delta:-1,line:1/0,character:1/0}),!0)}},{key:"ArrowUp",run:t=>{let n=t.state.selection.main;return!!n.empty&&!!t.moveVertically(n,!1).eq(n)&&(e({cell_delta:-1,line:1/0,character:1/0}),!0)}},{key:"ArrowRight",run:t=>{let n=t.state.selection.main;return!!n.empty&&!!t.moveByChar(n,!0).eq(n)&&(e({cell_delta:1,line:0,character:0}),!0)}},{key:"ArrowDown",run:t=>{let n=t.state.selection.main;return!!n.empty&&!!t.moveVertically(n,!0).eq(n)&&(e({cell_delta:1,line:0,character:0}),!0)}}]))({focus_on_neighbor:e});St=r("hiQgq");let nr=({pluto_actions:e,cell_id:t})=>St.EditorView.domEventHandlers({paste:(n,o)=>{if(!o.hasFocus)return console.log("CodeMirror, why are you registring this paste? You aren't focused!"),!0;n.stopPropagation();const a=n.clipboardData.getData("text/plain"),r=_e(a);return null!=r&&(0===o.state.selection.main.from&&o.state.selection.main.to===o.state.doc.length?(e.add_deserialized_cells(a,t,r),e.confirm_delete_multiple("This Should Never Be Visible",[t]),!0):(o.state.selection.main.to===o.state.doc.length||0===o.state.selection.main.from)&&(e.add_deserialized_cells(a,t,r),!0))}});St=r("hiQgq"),St=r("hiQgq"),St=r("hiQgq");function or(e){var t,n,o;let a=e.parent.firstChild,r=e.parent.lastChild;if(!("end"===r.name))return null;let i=null===(t=e.parent.getChild("CatchClause"))||void 0===t?void 0:t.firstChild,s=null===(n=e.parent.getChild("TryElseClause"))||void 0===n?void 0:n.firstChild,l=null===(o=e.parent.getChild("FinallyClause"))||void 0===o?void 0:o.firstChild;return[{from:a.from,to:a.to},i&&{from:i.from,to:i.to},s&&{from:s.from,to:s.to},l&&{from:l.from,to:l.to},{from:r.from,to:r.to}].filter((e=>null!=e))}const ar=(St=r("hiQgq")).EditorView.baseTheme({".cm-matchingBracket":{backgroundColor:"#328c8252"},".cm-nonmatchingBracket":{backgroundColor:"#bb555544"}}),rr=St.Facet.define({combine:e=>St.combineConfig(e,{afterCursor:!0,brackets:"()[]{}",maxScanDistance:1e4})}),ir=St.Decoration.mark({class:"cm-matchingBracket"}),sr=(St.Decoration.mark({class:"cm-nonmatchingBracket"}),[St.StateField.define({create:()=>St.Decoration.none,update(e,t){if(!t.docChanged&&!t.selection)return e;let n=[],o=t.state.facet(rr);for(let e of t.state.selection.ranges){if(!e.empty)continue;let a=cr(t.state,e.head,-1,o)||e.head>0&&cr(t.state,e.head-1,1,o)||o.afterCursor&&(cr(t.state,e.head,1,o)||e.headSyntax error
-
+ ${t.map((({message:t,from:n,to:o,line:a})=>i.html`
- window.dispatchEvent(new CustomEvent("cell_highlight_range",{detail:{cell_id:e,from:n,to:o}}))} + onmouseleave=${()=>window.dispatchEvent(new CustomEvent("cell_highlight_range",{detail:{cell_id:e,from:null,to:null}}))} + > + ${t}@ + <${jr} frame=${{file:"#==#"+e,line:a}} cell_id=${e} /> + `))} +
${e}
`))},s=[{pattern:/syntax: extra token after end of expression/,display:e=>{const t=i.html`{e.preventDefault(),a.wrap_remote_cell(n,"begin")}} + >Wrap all code in a begin ... end block.`;if(e.includes("\n\nBoundaries: ")){const o=JSON.parse(e.split("\n\nBoundaries: ")[1]).map((e=>e-1)),r=i.html`+ {e.preventDefault(),a.split_remote_cell(n,o,!0)}} + >Split this cell into ${o.length} cells, or +
`;return i.html`Multiple expressions in one cell.
+How would you like to fix it?
+-
+
- ${r} +
- ${t} +
Multiple expressions in one cell.
+${t}
`}},{pattern:/LoadError: cannot assign a value to variable workspace#\d+\..+ from module workspace#\d+/,display:()=>i.html`Tried to reevaluate an include call, this is not supported. You might need to restart this notebook from the main menu.
+ For a workaround, use the alternative version of include described here:
+ GH issue 115
+
In the future, include will be deprecated, and this will be the default.
${e}
`))},{pattern:/Cyclic references among (.*)\./,display:e=>e.split("\n").map((e=>{const t=e.match(/Cyclic references among (.*)\./);if(t){let e=t[1].split(/, | and /).map((e=>i.html`${e}`));return i.html`Cyclic references among${" "}${Ur(e)}.
`}return i.html`${e}
`}))},{pattern:/Multiple definitions for (.*)\./,display:e=>e.split("\n").map((e=>{const t=e.match(/Multiple definitions for (.*)\./);if(t){let e=t[1].split(/, | and /).map((e=>i.html`{const o=document.querySelector(`pluto-cell:not([id='${n}']) span[id='${encodeURI(e)}']`);t.preventDefault(),null==o||o.scrollIntoView()}}>${e}`));return i.html`Multiple definitions for${" "}${Ur(e)}.
`}return i.html`${e}
`}))},{pattern:/^syntax: (.*)$/,display:r.display,show_stacktrace:()=>!1},{pattern:/^UndefVarError: (.*) not defined\.?$/,display:e=>{const t=a.get_notebook(),o=qr(t,n),r=e.match(/UndefVarError: (.*) not defined/);let s=(null==r?void 0:r[1])??"";const l=Object.values((null==t?void 0:t.cell_dependencies)??{}).some((e=>Object.keys(e.downstream_cells_map).includes(s)));if(0===Object.keys(o).length||!l)return i.html`${e}
`;const c=Object.keys(o).map((e=>i.html`{t.preventDefault();const n=document.querySelector(`pluto-cell[id='${o[e]}']`);null==n||n.scrollIntoView()}}>${e}`));return i.html`Another cell defining ${Ur(c)} contains errors.
`},show_stacktrace:()=>{const e=qr(a.get_notebook(),n);return 0===Object.keys(e).length}},r],l=s.find((({pattern:t})=>t.test(e)))??r;return i.html`-
+ ${t.map((e=>i.html`
- + <${Br} frame=${e} /> + @ + <${jr} frame=${e} cell_id=${n} /> + ${e.inlined?i.html`[inlined]`:null} + `))} +
${t}`;case"application/vnd.pluto.tree+object":return i.html`<${Vr} cell_id=${n} body=${t} persist_js_state=${o} />`;default:return Gs({mime:e,body:t,cell_id:n,persist_js_state:o,sanitize_html:a,last_run_timestamp:null})}},Wr=({on_click_more:e})=>{const[t,n]=i.useState(!1);return i.html`⌀ (This table has no columns)
+
+
+ ⌀
+ (This table has no rows)
+
+
`:null}
+ `,Hs=()=>i.html`
+ Safe preview
+
+
+
+
+ ${"Code not executed in "}Safe preview
+
<${Ks} mime=${e} body=${t} />
`;case"text/html":return t.startsWith("`:i.html`<${tl}
+ cell_id=${n}
+ body=${t}
+ persist_js_state=${o}
+ last_run_timestamp=${a}
+ sanitize_html=${r}
+ />`;case"application/vnd.pluto.tree+object":return i.html`
+ <${Vr} cell_id=${n} body=${t} persist_js_state=${o} sanitize_html=${r} />
+
`;case"application/vnd.pluto.table+object":return i.html`<${Xr} cell_id=${n} body=${t} persist_js_state=${o} sanitize_html=${r} />`;case"application/vnd.pluto.parseerror+object":return i.html`<${Fr} cell_id=${n} ...${t} />
`;case"application/vnd.pluto.stacktrace+object":return i.html`<${zr} cell_id=${n} ...${t} />
`;case"application/vnd.pluto.divelement+object":return(({cell_id:e,style:t,classname:n,children:o,persist_js_state:a=!1})=>i.html`${o.map((t=>i.html`<${Hr} cell_id=${e} mime=${t[1]} body=${t[0]} persist_js_state=${a} />`))}
`)({cell_id:n,...t,persist_js_state:o,sanitize_html:r});case"text/plain":return t?i.html`
+
`:i.html``;case null:case void 0:case"":return i.html``;default:return i.html`${t}🛑`}};ai.default(Gs,"pluto-display",["mime","body","cell_id","persist_js_state","last_run_timestamp","sanitize_html"]);let Vs=({body:e})=>{let t=i.useRef();return i.useLayoutEffect((()=>{let n=URL.createObjectURL(new Blob([e],{type:"text/html"}));return t.current.src=n,Js((async()=>{await new Promise((e=>t.current.addEventListener("load",(()=>e(null)))));let e=t.current.contentWindow.document,n=document.querySelector("#iframe-resizer-content-window-script"),o=e.createElement("script");o.src=n.src,o.crossOrigin="anonymous",e.head.appendChild(o),new Promise((e=>o.addEventListener("load",(()=>e(null))))),window.iFrameResize({checkOrigin:!1},t.current)})),()=>URL.revokeObjectURL(n)}),[e]),i.html``},Zs=async({environment:e,code:t})=>{const n=`"use strict"; return (async () => {${t}})()`;let{this:o,...a}=e,r=Object.keys(a),i=Object.values(a);return await Function(...r,n).bind(o)(...i)},Qs=0,Xs=async(e,t)=>{let n=document.createElement("script");for(let t of e.attributes)n.attributes.setNamedItem(t.cloneNode(!0));const o=`____FUNCTION_TO_RUN_INSIDE_SCRIPT_${Qs}`;n.textContent=`{\n window.${o}.result = window.${o}.function_to_run(window.${o}.currentScript)\n }`,window[o]={function_to_run:t,currentScript:n,result:null};const a=e.parentNode;if(null==a)throw"Failed to execute script it has no parent in DOM.";a.replaceChild(n,e);let r=await window[o].result;return window[o]={function_to_run:t,result:null},{node:n,result:r}};const Ys=e=>e instanceof Element&&e.nodeType===Node.ELEMENT_NODE;let Js=e=>e(),el=e=>{try{const t=e.getAttribute("shadowroot"),n=e.parentElement.attachShadow({mode:t});n.appendChild(e.content),e.remove();return Array.from(n.querySelectorAll("script, template[shadowroot]")).flatMap((e=>"SCRIPT"===e.nodeName?[e]:"TEMPLATE"===e.nodeName?el(e):void 0))}catch(t){return console.error("Couldn't attach declarative shadow dom to",e,"because of",t),[]}},tl=({body:e,className:t="",persist_js_state:n=!1,last_run_timestamp:o,sanitize_html:a=!0})=>{let r=i.useContext(ye),s=i.useContext(we),l=i.useContext(ke),c=i.useRef(new Map),d=i.useRef((()=>{})),u=i.useRef(null);return i.useLayoutEffect((()=>{u.current&&s&&ti(u.current.querySelectorAll("bond"),s)}),[e,n,r,s,a]),i.useLayoutEffect((()=>{const t=u.current;if(null==t)return;let o=new Promise((e=>{d.current=()=>{e(null)}}));document.createElement("p-dumpster").append(...t.childNodes);let p=a?$t.sanitize(e,{FORBID_TAGS:["style"]}):e;if(t.innerHTML=p,p!==e){const n=new DOMParser,o=n.parseFromString(e,"text/html");if(n.parseFromString(p,"text/html").documentElement.innerHTML!==o.documentElement.innerHTML){console.info("HTML sanitized",{body:e,html_content_to_set:p});let n=document.createElement("div");n.innerHTML='
\nScripts and styles not rendered in Safe preview\n
',t.prepend(n)}}if(a)return;const m=[...Array.from(t.querySelectorAll("template[shadowroot]")).flatMap((e=>el(e))),...Array.from(t.querySelectorAll("script"))];return Js((async()=>{try{var e;if(null==l||l.add(t),c.current=await(async({root_node:e,script_nodes:t,previous_results_map:n,invalidation:o,pluto_actions:a})=>{let r=new Map;for(let e of t)if(null!=e.src&&""!==e.src);else{let t=e.id,o=t?n.get(t):null;Ys(o)&&(null===(s=e.parentElement)||void 0===s||s.insertBefore(o,e))}for(let l of t){if(Qs+=1,null!=l.src&&""!==l.src){let e=Array.from(document.head.querySelectorAll("script")).find((e=>e.src===l.src));null==e&&(e=document.createElement("script"),e.referrerPolicy=l.referrerPolicy,e.crossOrigin=l.crossOrigin,e.integrity=l.integrity,e.noModule=l.noModule,e.nonce=l.nonce,e.type=l.type,e.src=l.src,e.pluto_is_loading_me=!0);let t=e;null!=t.pluto_is_loading_me&&(await new Promise((e=>{t.addEventListener("load",e),t.addEventListener("error",e),document.head.appendChild(t)})),t.pluto_is_loading_me=void 0)}else try{let t=l.innerText,c=l.id,d=c?n.get(c):null;if("module"===l.type&&console.warn("We don't (yet) fully support