acquire

pull the web, papers, video, files, code and JSON APIs into the vault — once, or on a schedule

Every method here is one fossick call plus Vault.add. fossick knows how to get past bot walls, read arXiv and YouTube, and sniff a page’s JSON API; the vault’s job is only to file what comes back with the provenance that explains why it is there.

source

md_title

def md_title(
    md:str, fallback:str=''
)->str:

*First markdown heading in md, else fallback — scraped s are often junk.* <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L18" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="clip" class="level3"> <h3>clip</h3> <div class="sourceCode" id="cb2"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a>def clip( <a href="#cb2-2" aria-hidden="true" tabindex="-1"></a> s:str, n:int=120 <a href="#cb2-3" aria-hidden="true" tabindex="-1"></a>)->str:</code></pre></div> Collapse whitespace and clip a scraped title to something a breadcrumb can carry. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L63" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.web" class="level3"> <h3>Vault.web</h3> <div class="sourceCode" id="cb3"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a>def web( <a href="#cb3-2" aria-hidden="true" tabindex="-1"></a> query:str, # what to search for <a href="#cb3-3" aria-hidden="true" tabindex="-1"></a> n:int=5, # top results to read <a href="#cb3-4" aria-hidden="true" tabindex="-1"></a> google:bool=False, # real Google ranking via a stealth browser (slower) <a href="#cb3-5" aria-hidden="true" tabindex="-1"></a> chars:int=60000, # max markdown chars kept per source <a href="#cb3-6" aria-hidden="true" tabindex="-1"></a> verify:bool=False, **kw <a href="#cb3-7" aria-hidden="true" tabindex="-1"></a>)->AttrDict: # forwarded to fossick.research</code></pre></div> Search the web, read the top <code>n</code> results, and file all of them in the vault. This is the loop the vault exists for: the query that found a page is kept in its metadata, so months later <code>sources()</code> still says why a document is in your corpus. Results already present are skipped rather than duplicated, so re-running an overlapping search is cheap. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L54" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.crawl" class="level3"> <h3>Vault.crawl</h3> <div class="sourceCode" id="cb4"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a>def crawl( <a href="#cb4-2" aria-hidden="true" tabindex="-1"></a> start_url:str, max_pages:int=10, sel:str=None, verify:bool=False, **kw <a href="#cb4-3" aria-hidden="true" tabindex="-1"></a>)->L:</code></pre></div> Crawl a docs site or blog from a start URL and file every page in the vault. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L29" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.url" class="level3"> <h3>Vault.url</h3> <div class="sourceCode" id="cb5"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a>def url( <a href="#cb5-2" aria-hidden="true" tabindex="-1"></a> url:str, # page to read <a href="#cb5-3" aria-hidden="true" tabindex="-1"></a> title:str=None, # defaults to the page's first heading, else its path <a href="#cb5-4" aria-hidden="true" tabindex="-1"></a> sel:str=None, # CSS selector to narrow the page before conversion <a href="#cb5-5" aria-hidden="true" tabindex="-1"></a> kind:str='web', auto:bool=True, # escalate plain -> heavy -> stealthy -> logged-in Chrome past bot walls <a href="#cb5-6" aria-hidden="true" tabindex="-1"></a> meta:dict=None, force:bool=False, verify:bool=False, **kw <a href="#cb5-7" aria-hidden="true" tabindex="-1"></a>)->dict: # forwarded to fossick.fetch</code></pre></div> Fetch one URL, convert it to markdown and file it in the vault. <code>auto=True</code> is the default because a bot wall returns HTTP 200 with a challenge page, which would otherwise be indexed as if it were the article. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L138" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.code" class="level3"> <h3>Vault.code</h3> <div class="sourceCode" id="cb6"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a>def code( <a href="#cb6-2" aria-hidden="true" tabindex="-1"></a> dir:str, types:str='.py,.js,.ts,.jsx,.tsx,.java,.go,.cs,.ruby,.php,.swift,.kt,.kts,.rs,.scala,.lua', **kw <a href="#cb6-3" aria-hidden="true" tabindex="-1"></a>)->L:</code></pre></div> File a source tree into the vault as <code>kind='code'</code>, so code and prose answer one query. This is deliberately the shallow path: files as documents, headings from the text. For call graphs, PageRank over symbols and <code>where_to_add</code>, use <code>index_code</code> — kosha builds an AST-derived index that this cannot, and <code>federate</code> searches both. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L121" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.grab" class="level3"> <h3>Vault.grab</h3> <div class="sourceCode" id="cb7"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a>def grab( <a href="#cb7-2" aria-hidden="true" tabindex="-1"></a> target:str, # a URL, an arXiv id, a YouTube link, a PDF, a local file or a directory <a href="#cb7-3" aria-hidden="true" tabindex="-1"></a> title:str=None, sel:str=None, # CSS selector, for the web cases <a href="#cb7-4" aria-hidden="true" tabindex="-1"></a> **kw <a href="#cb7-5" aria-hidden="true" tabindex="-1"></a>):</code></pre></div> File anything, by looking at what it is — the one call a CLI or an agent needs. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L109" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.youtube" class="level3"> <h3>Vault.youtube</h3> <div class="sourceCode" id="cb8"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a>def youtube( <a href="#cb8-2" aria-hidden="true" tabindex="-1"></a> url:str, force:bool=False <a href="#cb8-3" aria-hidden="true" tabindex="-1"></a>)->dict:</code></pre></div> Read a YouTube video’s transcript and metadata into the vault. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L96" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.pdf" class="level3"> <h3>Vault.pdf</h3> <div class="sourceCode" id="cb9"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a>def pdf( <a href="#cb9-2" aria-hidden="true" tabindex="-1"></a> path_or_url:str, title:str=None, force:bool=False, verify:bool=False, **kw <a href="#cb9-3" aria-hidden="true" tabindex="-1"></a>)->dict:</code></pre></div> Read a PDF (local path or URL) into the vault, one tree node per heading. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L86" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.arxiv" class="level3"> <h3>Vault.arxiv</h3> <div class="sourceCode" id="cb10"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a>def arxiv( <a href="#cb10-2" aria-hidden="true" tabindex="-1"></a> id_or_url:str, save_dir:str=None, force:bool=False, verify:bool=False, **kw <a href="#cb10-3" aria-hidden="true" tabindex="-1"></a>)->dict:</code></pre></div> Read an arXiv paper (metadata + full text) into the vault as <code>kind="arxiv"</code>. </section> <section id="harvest-read-a-pages-api-not-its-html" class="level3"> <h3>Harvest: read a page’s API, not its HTML</h3> Listing, product and dashboard pages render from an internal JSON API. Reading that API is faster, paginates cleanly and survives redesigns, where scraping the DOM does none of those. One document per harvest, one <code>##</code> section per record — so <code>build_tree</code> gives every record its own node and breadcrumb, and a catalogue becomes individually retrievable rows sitting next to your notes. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L163" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="records_md" class="level3"> <h3>records_md</h3> <div class="sourceCode" id="cb11"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb11-1" aria-hidden="true" tabindex="-1"></a>def records_md( <a href="#cb11-2" aria-hidden="true" tabindex="-1"></a> recs, title_keys:tuple=('name', 'title', 'displayName', 'productName', 'label', 'sku', 'id') <a href="#cb11-3" aria-hidden="true" tabindex="-1"></a>)->str:</code></pre></div> Records as markdown, one <code>##</code> section per record, so each becomes its own retrievable node. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L146" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="records" class="level3"> <h3>records</h3> <div class="sourceCode" id="cb12"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb12-1" aria-hidden="true" tabindex="-1"></a>def records( <a href="#cb12-2" aria-hidden="true" tabindex="-1"></a> data, min_len:int=2 <a href="#cb12-3" aria-hidden="true" tabindex="-1"></a>)->list:</code></pre></div> The longest list of dicts inside an arbitrary JSON response. APIs bury their payload at different depths (<code>results</code>, <code>data.products.items</code>, a bare array), so this walks for the longest list of dicts rather than guessing a key name. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L222" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.add_records" class="level3"> <h3>Vault.add_records</h3> <div class="sourceCode" id="cb13"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb13-1" aria-hidden="true" tabindex="-1"></a>def add_records( <a href="#cb13-2" aria-hidden="true" tabindex="-1"></a> recs:list, title:str, source:str=None, kind:str='data', force:bool=False, meta:dict=None <a href="#cb13-3" aria-hidden="true" tabindex="-1"></a>)->dict:</code></pre></div> File a list of dicts you already have (any API, any export) as one document, one section each. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L188" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.harvest" class="level3"> <h3>Vault.harvest</h3> <div class="sourceCode" id="cb14"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb14-1" aria-hidden="true" tabindex="-1"></a>def harvest( <a href="#cb14-2" aria-hidden="true" tabindex="-1"></a> url:str, # the page whose API you want <a href="#cb14-3" aria-hidden="true" tabindex="-1"></a> pattern:str='*', # which captured request URLs to keep <a href="#cb14-4" aria-hidden="true" tabindex="-1"></a> title:str=None, # document title; defaults to the page host + path <a href="#cb14-5" aria-hidden="true" tabindex="-1"></a> capture:int=None, # replay a specific endpoint from the last apis() call <a href="#cb14-6" aria-hidden="true" tabindex="-1"></a> pages:int=1, # pages to pull; >1 paginates the endpoint <a href="#cb14-7" aria-hidden="true" tabindex="-1"></a> page_field:str='page', # query/body key incremented per page <a href="#cb14-8" aria-hidden="true" tabindex="-1"></a> session:bool=False, # capture through the logged-in Chrome <a href="#cb14-9" aria-hidden="true" tabindex="-1"></a> force:bool=False, **kw <a href="#cb14-10" aria-hidden="true" tabindex="-1"></a>)->dict:</code></pre></div> Sniff a page’s JSON API, pull the records, and file them in the vault as <code>kind='data'</code>. Re-harvesting the same source replaces rather than duplicates when <code>force=True</code>; otherwise it is a no-op, which is what makes this safe to put behind a <code>watch</code>. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L172" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.apis" class="level3"> <h3>Vault.apis</h3> <div class="sourceCode" id="cb15"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb15-1" aria-hidden="true" tabindex="-1"></a>def apis( <a href="#cb15-2" aria-hidden="true" tabindex="-1"></a> url:str, # page to watch <a href="#cb15-3" aria-hidden="true" tabindex="-1"></a> pattern:str='*', # glob/regex filtering captured request URLs <a href="#cb15-4" aria-hidden="true" tabindex="-1"></a> session:bool=False, # capture through the logged-in debug Chrome <a href="#cb15-5" aria-hidden="true" tabindex="-1"></a> preview:int=240, # chars of each response shown <a href="#cb15-6" aria-hidden="true" tabindex="-1"></a> **kw <a href="#cb15-7" aria-hidden="true" tabindex="-1"></a>)->L: # forwarded to fossick.find_xhr</code></pre></div> Discover the JSON endpoints a page calls, so you can read its data instead of its HTML. </section> <section id="watches-keeping-it-current" class="level3"> <h3>Watches: keeping it current</h3> A watch is what turns the vault from an archive into something that stays current. <code>action</code> names an acquisition method, so anything you can file once you can file on a schedule; <code>remind</code> writes a note instead of fetching, which is the recurring-reminder case with no network involved. <code>poll()</code> is the tick — cron, a scheduler, or a frontend button. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L296" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.poll" class="level3"> <h3>Vault.poll</h3> <div class="sourceCode" id="cb16"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb16-1" aria-hidden="true" tabindex="-1"></a>def poll( <a href="#cb16-2" aria-hidden="true" tabindex="-1"></a> at:float=None, limit:int=None, connect:bool=True <a href="#cb16-3" aria-hidden="true" tabindex="-1"></a>)->dict:</code></pre></div> Run every watch that is due. This is the tick a scheduler, a cron or a frontend calls. Rebuilds the entity graph once at the end rather than per watch, because <code>connect()</code> reads the whole store and a poll that fired five watches would otherwise pay for it five times. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L278" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.run_watch" class="level3"> <h3>Vault.run_watch</h3> <div class="sourceCode" id="cb17"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb17-1" aria-hidden="true" tabindex="-1"></a>def run_watch( <a href="#cb17-2" aria-hidden="true" tabindex="-1"></a> w:dict <a href="#cb17-3" aria-hidden="true" tabindex="-1"></a>)->dict:</code></pre></div> Fire one watch and record the outcome. A failure is recorded on the row and returned, never raised: one dead URL must not stop a polling loop from servicing every other watch. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L273" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.pause" class="level3"> <h3>Vault.pause</h3> <div class="sourceCode" id="cb18"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb18-1" aria-hidden="true" tabindex="-1"></a>def pause( <a href="#cb18-2" aria-hidden="true" tabindex="-1"></a> watch_id:str, enabled:bool=False <a href="#cb18-3" aria-hidden="true" tabindex="-1"></a>):</code></pre></div> Disable (or re-enable) a watch without losing it. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L268" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.unwatch" class="level3"> <h3>Vault.unwatch</h3> <div class="sourceCode" id="cb19"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb19-1" aria-hidden="true" tabindex="-1"></a>def unwatch( <a href="#cb19-2" aria-hidden="true" tabindex="-1"></a> watch_id:str <a href="#cb19-3" aria-hidden="true" tabindex="-1"></a>):</code></pre></div> Delete a watch. The documents it already filed stay in the vault. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L261" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.watches" class="level3"> <h3>Vault.watches</h3> <div class="sourceCode" id="cb20"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb20-1" aria-hidden="true" tabindex="-1"></a>def watches( <a href="#cb20-2" aria-hidden="true" tabindex="-1"></a> due_only:bool=False, at:float=None <a href="#cb20-3" aria-hidden="true" tabindex="-1"></a>)->L:</code></pre></div> Every registered watch, soonest first; <code>due_only</code> keeps the ones whose next run has arrived. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L245" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="vault.watch" class="level3"> <h3>Vault.watch</h3> <div class="sourceCode" id="cb21"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb21-1" aria-hidden="true" tabindex="-1"></a>def watch( <a href="#cb21-2" aria-hidden="true" tabindex="-1"></a> target:str, # URL, query, arXiv id, or the text of a reminder <a href="#cb21-3" aria-hidden="true" tabindex="-1"></a> action:str='url', # one of ACTIONS — what to do when it fires <a href="#cb21-4" aria-hidden="true" tabindex="-1"></a> every:str='1d', # interval: '30m', '6h', '1d', '1w', or seconds <a href="#cb21-5" aria-hidden="true" tabindex="-1"></a> note:str=None, # why you are watching <a href="#cb21-6" aria-hidden="true" tabindex="-1"></a> start:float=None, # first run time (epoch); defaults to now <a href="#cb21-7" aria-hidden="true" tabindex="-1"></a> **params <a href="#cb21-8" aria-hidden="true" tabindex="-1"></a>)->dict: # forwarded to the action (n=, pattern=, pages=, sel=, ...)</code></pre></div> Register a recurring job: re-read a page, re-run a search, re-harvest an API, or remind you. <hr /> <a href="https://github.com/vedicreader/vishalakshi/blob/main/vishalakshi/acquire.py#L231" target="_blank" style="float:right; font-size:smaller">source</a> </section> <section id="secs" class="level3"> <h3>secs</h3> <div class="sourceCode" id="cb22"><pre class="sourceCode python"><code class="sourceCode python"><a href="#cb22-1" aria-hidden="true" tabindex="-1"></a>def secs( <a href="#cb22-2" aria-hidden="true" tabindex="-1"></a> every <a href="#cb22-3" aria-hidden="true" tabindex="-1"></a>)->float:</code></pre></div> Seconds from <code>'30m'</code>, <code>'6h'</code>, <code>'2 days'</code>, <code>'1w'</code>, or a number of seconds. </section> <section id="try-it" class="level2"> <h2>Try it</h2> <div id="ccce65e4" class="cell"> <div class="sourceCode" id="cb23"><pre class="sourceCode python cell-code"><code class="sourceCode python"><a href="#cb23-1" aria-hidden="true" tabindex="-1"></a>v = Vault(':memory:') <a href="#cb23-2" aria-hidden="true" tabindex="-1"></a>v.add_records([dict(sku='A1', name='Free range eggs', price=4.5), <a href="#cb23-3" aria-hidden="true" tabindex="-1"></a> dict(sku='B2', name='Oat milk', price=2.1)], 'dairy') <a href="#cb23-4" aria-hidden="true" tabindex="-1"></a>v.find('eggs')[0]['breadcrumb']</code></pre></div> <div class="cell-output cell-output-stderr"> <pre><code>/Users/71293/code/personal/orgs/vishalakshi/.venv/lib/python3.13/site-packages/tqdm/auto.py:21: TqdmWarning: IProgress not found. Please update jupyter and ipywidgets. See https://ipywidgets.readthedocs.io/en/stable/user_install.html from .autonotebook import tqdm as notebook_tqdm</code></pre> </div> <div class="cell-output cell-output-display"> <pre><code>'dairy › Free range eggs'</code></pre> </div> </div> <div id="a52dbdf2" class="cell"> <div class="sourceCode" id="cb26"><pre class="sourceCode python cell-code"><code class="sourceCode python"><a href="#cb26-1" aria-hidden="true" tabindex="-1"></a>test_eq(len(records({'data': {'items': [{'a': 1}, {'a': 2}, {'a': 3}]}})), 3) <a href="#cb26-2" aria-hidden="true" tabindex="-1"></a>test_eq(secs('6h'), 21600); test_eq(secs('1w'), 604800); test_eq(secs(90), 90) <a href="#cb26-3" aria-hidden="true" tabindex="-1"></a>w = v.watch('late chunking', action='web', every='1d', n=3) <a href="#cb26-4" aria-hidden="true" tabindex="-1"></a>test_eq(w['params'], dict(n=3)) <a href="#cb26-5" aria-hidden="true" tabindex="-1"></a>test_eq(len(v.watches(due_only=True)), 1) <a href="#cb26-6" aria-hidden="true" tabindex="-1"></a>v.unwatch(w['id']) <a href="#cb26-7" aria-hidden="true" tabindex="-1"></a>test_eq(len(v.watches()), 0)</code></pre></div> <div class="cell-output cell-output-stderr"> <pre><code>/var/folders/kg/9vdw4mdd1fs58svgh4k1qhr09x7dqh/T/ipykernel_76490/529824922.py:7: Pandas4Warning: 'w' is deprecated and will be removed in a future version. Please use 'W' instead of 'w'. return float(every) if isinstance(every, (int, float)) else pd.Timedelta(every).total_seconds() /var/folders/kg/9vdw4mdd1fs58svgh4k1qhr09x7dqh/T/ipykernel_76490/529824922.py:7: Pandas4Warning: 'd' is deprecated and will be removed in a future version. Please use 'D' instead of 'd'. return float(every) if isinstance(every, (int, float)) else pd.Timedelta(every).total_seconds()</code></pre> </div> </div> <div id="quarto-navigation-envelope" class="hidden"> vishalakshi vishalakshi ask core vishalakshi core acquire ask code cli mcp acquire </div> <div id="quarto-meta-markdown" class="hidden"> acquire – vishalakshi acquire – vishalakshi acquire – vishalakshi vishalakshi pull the web, papers, video, files, code and JSON APIs into the vault — once, or on a schedule pull the web, papers, video, files, code and JSON APIs into the vault — once, or on a schedule one vault for everything you read: web, papers, video, files and code, searchable together and answerable by a local or hosted model </div> </section> </main>  <script id = "quarto-html-after-body" type="application/javascript"> window.document.addEventListener("DOMContentLoaded", function (event) { const icon = ""; const anchorJS = new window.AnchorJS(); anchorJS.options = { placement: 'right', icon: icon }; anchorJS.add('.anchored'); const isCodeAnnotation = (el) => { for (const clz of el.classList) { if (clz.startsWith('code-annotation-')) { return true; } } return false; } const onCopySuccess = function(e) { // button target const button = e.trigger; // don't keep focus button.blur(); // flash "checked" button.classList.add('code-copy-button-checked'); var currentTitle = button.getAttribute("title"); button.setAttribute("title", "Copied!"); let tooltip; if (window.bootstrap) { button.setAttribute("data-bs-toggle", "tooltip"); button.setAttribute("data-bs-placement", "left"); button.setAttribute("data-bs-title", "Copied!"); tooltip = new bootstrap.Tooltip(button, { trigger: "manual", customClass: "code-copy-button-tooltip", offset: [0, -8]}); tooltip.show(); } setTimeout(function() { if (tooltip) { tooltip.hide(); button.removeAttribute("data-bs-title"); button.removeAttribute("data-bs-toggle"); button.removeAttribute("data-bs-placement"); } button.setAttribute("title", currentTitle); button.classList.remove('code-copy-button-checked'); }, 1000); // clear code selection e.clearSelection(); } const getTextToCopy = function(trigger) { const outerScaffold = trigger.parentElement.cloneNode(true); const codeEl = outerScaffold.querySelector('code'); for (const childEl of codeEl.children) { if (isCodeAnnotation(childEl)) { childEl.remove(); } } return codeEl.innerText; } const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', { text: getTextToCopy }); clipboard.on('success', onCopySuccess); if (window.document.getElementById('quarto-embedded-source-code-modal')) { const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', { text: getTextToCopy, container: window.document.getElementById('quarto-embedded-source-code-modal') }); clipboardModal.on('success', onCopySuccess); } var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//); var mailtoRegex = new RegExp(/^mailto:/); var filterRegex = new RegExp("https:\/\/vedicreader\.github\.io\/vishalakshi"); var isInternal = (href) => { return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href); } // Inspect non-navigation links and adorn them if external var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)'); for (var i=0; i<links.length; i++) { const link = links[i]; if (!isInternal(link.href)) { // undo the damage that might have been done by quarto-nav.js in the case of // links that we want to consider external if (link.dataset.originalHref !== undefined) { link.href = link.dataset.originalHref; } } } function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) { const config = { allowHTML: true, maxWidth: 500, delay: 100, arrow: false, appendTo: function(el) { return el.parentElement; }, interactive: true, interactiveBorder: 10, theme: 'quarto', placement: 'bottom-start', }; if (contentFn) { config.content = contentFn; } if (onTriggerFn) { config.onTrigger = onTriggerFn; } if (onUntriggerFn) { config.onUntrigger = onUntriggerFn; } window.tippy(el, config); } const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]'); for (var i=0; i<noterefs.length; i++) { const ref = noterefs[i]; tippyHover(ref, function() { // use id or data attribute instead here let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href'); try { href = new URL(href).hash; } catch {} const id = href.replace(/^#\/?/, ""); const note = window.document.getElementById(id); if (note) { return note.innerHTML; } else { return ""; } }); } const xrefs = window.document.querySelectorAll('a.quarto-xref'); const processXRef = (id, note) => { // Strip column container classes const stripColumnClz = (el) => { el.classList.remove("page-full", "page-columns"); if (el.children) { for (const child of el.children) { stripColumnClz(child); } } } stripColumnClz(note) if (id === null || id.startsWith('sec-')) { // Special case sections, only their first couple elements const container = document.createElement("div"); if (note.children && note.children.length > 2) { container.appendChild(note.children[0].cloneNode(true)); for (let i = 1; i < note.children.length; i++) { const child = note.children[i]; if (child.tagName === "P" && child.innerText === "") { continue; } else { container.appendChild(child.cloneNode(true)); break; } } if (window.Quarto?.typesetMath) { window.Quarto.typesetMath(container); } return container.innerHTML } else { if (window.Quarto?.typesetMath) { window.Quarto.typesetMath(note); } return note.innerHTML; } } else { // Remove any anchor links if they are present const anchorLink = note.querySelector('a.anchorjs-link'); if (anchorLink) { anchorLink.remove(); } if (window.Quarto?.typesetMath) { window.Quarto.typesetMath(note); } if (note.classList.contains("callout")) { return note.outerHTML; } else { return note.innerHTML; } } } for (var i=0; i<xrefs.length; i++) { const xref = xrefs[i]; tippyHover(xref, undefined, function(instance) { instance.disable(); let url = xref.getAttribute('href'); let hash = undefined; if (url.startsWith('#')) { hash = url; } else { try { hash = new URL(url).hash; } catch {} } if (hash) { const id = hash.replace(/^#\/?/, ""); const note = window.document.getElementById(id); if (note !== null) { try { const html = processXRef(id, note.cloneNode(true)); instance.setContent(html); } finally { instance.enable(); instance.show(); } } else { // See if we can fetch this fetch(url.split('#')[0]) .then(res => res.text()) .then(html => { const parser = new DOMParser(); const htmlDoc = parser.parseFromString(html, "text/html"); const note = htmlDoc.getElementById(id); if (note !== null) { const html = processXRef(id, note); instance.setContent(html); } }).finally(() => { instance.enable(); instance.show(); }); } } else { // See if we can fetch a full url (with no hash to target) // This is a special case and we should probably do some content thinning / targeting fetch(url) .then(res => res.text()) .then(html => { const parser = new DOMParser(); const htmlDoc = parser.parseFromString(html, "text/html"); const note = htmlDoc.querySelector('main.content'); if (note !== null) { // This should only happen for chapter cross references // (since there is no id in the URL) // remove the first header if (note.children.length > 0 && note.children[0].tagName === "HEADER") { note.children[0].remove(); } const html = processXRef(null, note); instance.setContent(html); } }).finally(() => { instance.enable(); instance.show(); }); } }, function(instance) { }); } let selectedAnnoteEl; const selectorForAnnotation = ( cell, annotation) => { let cellAttr = 'data-code-cell="' + cell + '"'; let lineAttr = 'data-code-annotation="' + annotation + '"'; const selector = 'span[' + cellAttr + '][' + lineAttr + ']'; return selector; } const selectCodeLines = (annoteEl) => { const doc = window.document; const targetCell = annoteEl.getAttribute("data-target-cell"); const targetAnnotation = annoteEl.getAttribute("data-target-annotation"); const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation)); const lines = annoteSpan.getAttribute("data-code-lines").split(","); const lineIds = lines.map((line) => { return targetCell + "-" + line; }) let top = null; let height = null; let parent = null; if (lineIds.length > 0) { //compute the position of the single el (top and bottom and make a div) const el = window.document.getElementById(lineIds[0]); top = el.offsetTop; height = el.offsetHeight; parent = el.parentElement.parentElement; if (lineIds.length > 1) { const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]); const bottom = lastEl.offsetTop + lastEl.offsetHeight; height = bottom - top; } if (top !== null && height !== null && parent !== null) { // cook up a div (if necessary) and position it let div = window.document.getElementById("code-annotation-line-highlight"); if (div === null) { div = window.document.createElement("div"); div.setAttribute("id", "code-annotation-line-highlight"); div.style.position = 'absolute'; parent.appendChild(div); } div.style.top = top - 2 + "px"; div.style.height = height + 4 + "px"; div.style.left = 0; let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter"); if (gutterDiv === null) { gutterDiv = window.document.createElement("div"); gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter"); gutterDiv.style.position = 'absolute'; const codeCell = window.document.getElementById(targetCell); const gutter = codeCell.querySelector('.code-annotation-gutter'); gutter.appendChild(gutterDiv); } gutterDiv.style.top = top - 2 + "px"; gutterDiv.style.height = height + 4 + "px"; } selectedAnnoteEl = annoteEl; } }; const unselectCodeLines = () => { const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"]; elementsIds.forEach((elId) => { const div = window.document.getElementById(elId); if (div) { div.remove(); } }); selectedAnnoteEl = undefined; }; // Handle positioning of the toggle window.addEventListener( "resize", throttle(() => { elRect = undefined; if (selectedAnnoteEl) { selectCodeLines(selectedAnnoteEl); } }, 10) ); function throttle(fn, ms) { let throttle = false; let timer; return (...args) => { if(!throttle) { // first call gets through fn.apply(this, args); throttle = true; } else { // all the others get throttled if(timer) clearTimeout(timer); // cancel #2 timer = setTimeout(() => { fn.apply(this, args); timer = throttle = false; }, ms); } }; } // Attach click handler to the DT const annoteDls = window.document.querySelectorAll('dt[data-target-cell]'); for (const annoteDlNode of annoteDls) { annoteDlNode.addEventListener('click', (event) => { const clickedEl = event.target; if (clickedEl !== selectedAnnoteEl) { unselectCodeLines(); const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active'); if (activeEl) { activeEl.classList.remove('code-annotation-active'); } selectCodeLines(clickedEl); clickedEl.classList.add('code-annotation-active'); } else { // Unselect the line unselectCodeLines(); clickedEl.classList.remove('code-annotation-active'); } }); } const findCites = (el) => { const parentEl = el.parentElement; if (parentEl) { const cites = parentEl.dataset.cites; if (cites) { return { el, cites: cites.split(' ') }; } else { return findCites(el.parentElement) } } else { return undefined; } }; var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]'); for (var i=0; i<bibliorefs.length; i++) { const ref = bibliorefs[i]; const citeInfo = findCites(ref); if (citeInfo) { tippyHover(citeInfo.el, function() { var popup = window.document.createElement('div'); citeInfo.cites.forEach(function(cite) { var citeDiv = window.document.createElement('div'); citeDiv.classList.add('hanging-indent'); citeDiv.classList.add('csl-entry'); var biblioDiv = window.document.getElementById('ref-' + cite); if (biblioDiv) { citeDiv.innerHTML = biblioDiv.innerHTML; } popup.appendChild(citeDiv); }); return popup.innerHTML; }); } } }); </script> </div>  </body> </html>