A loose federation of distributed, typed datasets
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

at main 1128 lines 48 kB view raw
1<!DOCTYPE html> 2<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head> 3 4<meta charset="utf-8"> 5<meta name="generator" content="quarto-1.7.34"> 6 7<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes"> 8 9 10<title>lenspublisher – atdata</title> 11<style> 12code{white-space: pre-wrap;} 13span.smallcaps{font-variant: small-caps;} 14div.columns{display: flex; gap: min(4vw, 1.5em);} 15div.column{flex: auto; overflow-x: auto;} 16div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;} 17ul.task-list{list-style: none;} 18ul.task-list li input[type="checkbox"] { 19 width: 0.8em; 20 margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */ 21 vertical-align: middle; 22} 23/* CSS for syntax highlighting */ 24html { -webkit-text-size-adjust: 100%; } 25pre > code.sourceCode { white-space: pre; position: relative; } 26pre > code.sourceCode > span { display: inline-block; line-height: 1.25; } 27pre > code.sourceCode > span:empty { height: 1.2em; } 28.sourceCode { overflow: visible; } 29code.sourceCode > span { color: inherit; text-decoration: inherit; } 30div.sourceCode { margin: 1em 0; } 31pre.sourceCode { margin: 0; } 32@media screen { 33div.sourceCode { overflow: auto; } 34} 35@media print { 36pre > code.sourceCode { white-space: pre-wrap; } 37pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; } 38} 39pre.numberSource code 40 { counter-reset: source-line 0; } 41pre.numberSource code > span 42 { position: relative; left: -4em; counter-increment: source-line; } 43pre.numberSource code > span > a:first-child::before 44 { content: counter(source-line); 45 position: relative; left: -1em; text-align: right; vertical-align: baseline; 46 border: none; display: inline-block; 47 -webkit-touch-callout: none; -webkit-user-select: none; 48 -khtml-user-select: none; -moz-user-select: none; 49 -ms-user-select: none; user-select: none; 50 padding: 0 4px; width: 4em; 51 } 52pre.numberSource { margin-left: 3em; padding-left: 4px; } 53div.sourceCode 54 { } 55@media screen { 56pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; } 57} 58</style> 59 60 61<script src="../site_libs/quarto-nav/quarto-nav.js"></script> 62<script src="../site_libs/quarto-nav/headroom.min.js"></script> 63<script src="../site_libs/clipboard/clipboard.min.js"></script> 64<script src="../site_libs/quarto-search/autocomplete.umd.js"></script> 65<script src="../site_libs/quarto-search/fuse.min.js"></script> 66<script src="../site_libs/quarto-search/quarto-search.js"></script> 67<meta name="quarto:offset" content="../"> 68<script src="../site_libs/quarto-html/quarto.js" type="module"></script> 69<script src="../site_libs/quarto-html/tabsets/tabsets.js" type="module"></script> 70<script src="../site_libs/quarto-html/popper.min.js"></script> 71<script src="../site_libs/quarto-html/tippy.umd.min.js"></script> 72<script src="../site_libs/quarto-html/anchor.min.js"></script> 73<link href="../site_libs/quarto-html/tippy.css" rel="stylesheet"> 74<link href="../site_libs/quarto-html/quarto-syntax-highlighting-9582434199d49cc9e91654cdeeb4866b.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles"> 75<link href="../site_libs/quarto-html/quarto-syntax-highlighting-dark-8dcd8563ea6803ab7cbb3d71ca5772e1.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles"> 76<link href="../site_libs/quarto-html/quarto-syntax-highlighting-9582434199d49cc9e91654cdeeb4866b.css" rel="stylesheet" class="quarto-color-scheme-extra" id="quarto-text-highlighting-styles"> 77<script src="../site_libs/bootstrap/bootstrap.min.js"></script> 78<link href="../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet"> 79<link href="../site_libs/bootstrap/bootstrap-62bce24ca844314e7bb1a34dbdfe05cc.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light"> 80<link href="../site_libs/bootstrap/bootstrap-dark-7964ffd8887b0991fe8d71c6c8bc75d6.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark"> 81<link href="../site_libs/bootstrap/bootstrap-62bce24ca844314e7bb1a34dbdfe05cc.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme-extra" id="quarto-bootstrap" data-mode="light"> 82<script id="quarto-search-options" type="application/json">{ 83 "location": "navbar", 84 "copy-button": false, 85 "collapse-after": 3, 86 "panel-placement": "end", 87 "type": "overlay", 88 "limit": 50, 89 "keyboard-shortcut": [ 90 "f", 91 "/", 92 "s" 93 ], 94 "show-item-context": false, 95 "language": { 96 "search-no-results-text": "No results", 97 "search-matching-documents-text": "matching documents", 98 "search-copy-link-title": "Copy link to search", 99 "search-hide-matches-text": "Hide additional matches", 100 "search-more-match-text": "more match in this document", 101 "search-more-matches-text": "more matches in this document", 102 "search-clear-button-title": "Clear", 103 "search-text-placeholder": "", 104 "search-detached-cancel-button-title": "Cancel", 105 "search-submit-button-title": "Submit", 106 "search-label": "Search" 107 } 108}</script> 109 110 111<link rel="stylesheet" href="../assets/styles.css"> 112</head> 113 114<body class="nav-fixed quarto-light"><script id="quarto-html-before-body" type="application/javascript"> 115 const toggleBodyColorMode = (bsSheetEl) => { 116 const mode = bsSheetEl.getAttribute("data-mode"); 117 const bodyEl = window.document.querySelector("body"); 118 if (mode === "dark") { 119 bodyEl.classList.add("quarto-dark"); 120 bodyEl.classList.remove("quarto-light"); 121 } else { 122 bodyEl.classList.add("quarto-light"); 123 bodyEl.classList.remove("quarto-dark"); 124 } 125 } 126 const toggleBodyColorPrimary = () => { 127 const bsSheetEl = window.document.querySelector("link#quarto-bootstrap:not([rel=disabled-stylesheet])"); 128 if (bsSheetEl) { 129 toggleBodyColorMode(bsSheetEl); 130 } 131 } 132 const setColorSchemeToggle = (alternate) => { 133 const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle'); 134 for (let i=0; i < toggles.length; i++) { 135 const toggle = toggles[i]; 136 if (toggle) { 137 if (alternate) { 138 toggle.classList.add("alternate"); 139 } else { 140 toggle.classList.remove("alternate"); 141 } 142 } 143 } 144 }; 145 const toggleColorMode = (alternate) => { 146 // Switch the stylesheets 147 const primaryStylesheets = window.document.querySelectorAll('link.quarto-color-scheme:not(.quarto-color-alternate)'); 148 const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate'); 149 manageTransitions('#quarto-margin-sidebar .nav-link', false); 150 if (alternate) { 151 // note: dark is layered on light, we don't disable primary! 152 enableStylesheet(alternateStylesheets); 153 for (const sheetNode of alternateStylesheets) { 154 if (sheetNode.id === "quarto-bootstrap") { 155 toggleBodyColorMode(sheetNode); 156 } 157 } 158 } else { 159 disableStylesheet(alternateStylesheets); 160 enableStylesheet(primaryStylesheets) 161 toggleBodyColorPrimary(); 162 } 163 manageTransitions('#quarto-margin-sidebar .nav-link', true); 164 // Switch the toggles 165 setColorSchemeToggle(alternate) 166 // Hack to workaround the fact that safari doesn't 167 // properly recolor the scrollbar when toggling (#1455) 168 if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) { 169 manageTransitions("body", false); 170 window.scrollTo(0, 1); 171 setTimeout(() => { 172 window.scrollTo(0, 0); 173 manageTransitions("body", true); 174 }, 40); 175 } 176 } 177 const disableStylesheet = (stylesheets) => { 178 for (let i=0; i < stylesheets.length; i++) { 179 const stylesheet = stylesheets[i]; 180 stylesheet.rel = 'disabled-stylesheet'; 181 } 182 } 183 const enableStylesheet = (stylesheets) => { 184 for (let i=0; i < stylesheets.length; i++) { 185 const stylesheet = stylesheets[i]; 186 if(stylesheet.rel !== 'stylesheet') { // for Chrome, which will still FOUC without this check 187 stylesheet.rel = 'stylesheet'; 188 } 189 } 190 } 191 const manageTransitions = (selector, allowTransitions) => { 192 const els = window.document.querySelectorAll(selector); 193 for (let i=0; i < els.length; i++) { 194 const el = els[i]; 195 if (allowTransitions) { 196 el.classList.remove('notransition'); 197 } else { 198 el.classList.add('notransition'); 199 } 200 } 201 } 202 const isFileUrl = () => { 203 return window.location.protocol === 'file:'; 204 } 205 const hasAlternateSentinel = () => { 206 let styleSentinel = getColorSchemeSentinel(); 207 if (styleSentinel !== null) { 208 return styleSentinel === "alternate"; 209 } else { 210 return false; 211 } 212 } 213 const setStyleSentinel = (alternate) => { 214 const value = alternate ? "alternate" : "default"; 215 if (!isFileUrl()) { 216 window.localStorage.setItem("quarto-color-scheme", value); 217 } else { 218 localAlternateSentinel = value; 219 } 220 } 221 const getColorSchemeSentinel = () => { 222 if (!isFileUrl()) { 223 const storageValue = window.localStorage.getItem("quarto-color-scheme"); 224 return storageValue != null ? storageValue : localAlternateSentinel; 225 } else { 226 return localAlternateSentinel; 227 } 228 } 229 const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => { 230 const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light'; 231 const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark'; 232 let newTheme = ''; 233 if(authorPrefersDark) { 234 newTheme = isAlternate ? baseTheme : alternateTheme; 235 } else { 236 newTheme = isAlternate ? alternateTheme : baseTheme; 237 } 238 const changeGiscusTheme = () => { 239 // From: https://github.com/giscus/giscus/issues/336 240 const sendMessage = (message) => { 241 const iframe = document.querySelector('iframe.giscus-frame'); 242 if (!iframe) return; 243 iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app'); 244 } 245 sendMessage({ 246 setConfig: { 247 theme: newTheme 248 } 249 }); 250 } 251 const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null; 252 if (isGiscussLoaded) { 253 changeGiscusTheme(); 254 } 255 }; 256 const authorPrefersDark = false; 257 const darkModeDefault = authorPrefersDark; 258 document.querySelector('link#quarto-text-highlighting-styles.quarto-color-scheme-extra').rel = 'disabled-stylesheet'; 259 document.querySelector('link#quarto-bootstrap.quarto-color-scheme-extra').rel = 'disabled-stylesheet'; 260 let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default'; 261 // Dark / light mode switch 262 window.quartoToggleColorScheme = () => { 263 // Read the current dark / light value 264 let toAlternate = !hasAlternateSentinel(); 265 toggleColorMode(toAlternate); 266 setStyleSentinel(toAlternate); 267 toggleGiscusIfUsed(toAlternate, darkModeDefault); 268 window.dispatchEvent(new Event('resize')); 269 }; 270 // Switch to dark mode if need be 271 if (hasAlternateSentinel()) { 272 toggleColorMode(true); 273 } else { 274 toggleColorMode(false); 275 } 276 </script> 277 278<div id="quarto-search-results"></div> 279 <header id="quarto-header" class="headroom fixed-top"> 280 <nav class="navbar navbar-expand-lg " data-bs-theme="dark"> 281 <div class="navbar-container container-fluid"> 282 <div class="navbar-brand-container mx-auto"> 283 <a class="navbar-brand" href="../index.html"> 284 <span class="navbar-title">atdata</span> 285 </a> 286 </div> 287 <div id="quarto-search" class="" title="Search"></div> 288 <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" role="menu" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }"> 289 <span class="navbar-toggler-icon"></span> 290</button> 291 <div class="collapse navbar-collapse" id="navbarCollapse"> 292 <ul class="navbar-nav navbar-nav-scroll me-auto"> 293 <li class="nav-item"> 294 <a class="nav-link" href="../index.html"> 295<span class="menu-text">Guide</span></a> 296 </li> 297 <li class="nav-item dropdown "> 298 <a class="nav-link dropdown-toggle" href="#" id="nav-menu-tutorials" role="link" data-bs-toggle="dropdown" aria-expanded="false"> 299 <span class="menu-text">Tutorials</span> 300 </a> 301 <ul class="dropdown-menu" aria-labelledby="nav-menu-tutorials"> 302 <li> 303 <a class="dropdown-item" href="../tutorials/quickstart.html"> 304 <span class="dropdown-text">Quick Start</span></a> 305 </li> 306 <li> 307 <a class="dropdown-item" href="../tutorials/local-workflow.html"> 308 <span class="dropdown-text">Local Workflow</span></a> 309 </li> 310 <li> 311 <a class="dropdown-item" href="../tutorials/atmosphere.html"> 312 <span class="dropdown-text">Atmosphere Publishing</span></a> 313 </li> 314 <li> 315 <a class="dropdown-item" href="../tutorials/promotion.html"> 316 <span class="dropdown-text">Promotion Workflow</span></a> 317 </li> 318 </ul> 319 </li> 320 <li class="nav-item dropdown "> 321 <a class="nav-link dropdown-toggle" href="#" id="nav-menu-reference" role="link" data-bs-toggle="dropdown" aria-expanded="false"> 322 <span class="menu-text">Reference</span> 323 </a> 324 <ul class="dropdown-menu" aria-labelledby="nav-menu-reference"> 325 <li> 326 <a class="dropdown-item" href="../reference/architecture.html"> 327 <span class="dropdown-text">Architecture Overview</span></a> 328 </li> 329 <li> 330 <a class="dropdown-item" href="../reference/packable-samples.html"> 331 <span class="dropdown-text">Packable Samples</span></a> 332 </li> 333 <li> 334 <a class="dropdown-item" href="../reference/datasets.html"> 335 <span class="dropdown-text">Datasets</span></a> 336 </li> 337 <li> 338 <a class="dropdown-item" href="../reference/lenses.html"> 339 <span class="dropdown-text">Lenses</span></a> 340 </li> 341 <li> 342 <a class="dropdown-item" href="../reference/local-storage.html"> 343 <span class="dropdown-text">Local Storage</span></a> 344 </li> 345 <li> 346 <a class="dropdown-item" href="../reference/atmosphere.html"> 347 <span class="dropdown-text">Atmosphere</span></a> 348 </li> 349 <li> 350 <a class="dropdown-item" href="../reference/promotion.html"> 351 <span class="dropdown-text">Promotion</span></a> 352 </li> 353 <li> 354 <a class="dropdown-item" href="../reference/load-dataset.html"> 355 <span class="dropdown-text">load_dataset API</span></a> 356 </li> 357 <li> 358 <a class="dropdown-item" href="../reference/protocols.html"> 359 <span class="dropdown-text">Protocols</span></a> 360 </li> 361 <li> 362 <a class="dropdown-item" href="../reference/uri-spec.html"> 363 <span class="dropdown-text">URI Specification</span></a> 364 </li> 365 <li> 366 <a class="dropdown-item" href="../reference/troubleshooting.html"> 367 <span class="dropdown-text">Troubleshooting &amp; FAQ</span></a> 368 </li> 369 <li> 370 <a class="dropdown-item" href="../reference/deployment.html"> 371 <span class="dropdown-text">Deployment Guide</span></a> 372 </li> 373 </ul> 374 </li> 375 <li class="nav-item"> 376 <a class="nav-link" href="../api/index.html"> 377<span class="menu-text">API</span></a> 378 </li> 379</ul> 380 <ul class="navbar-nav navbar-nav-scroll ms-auto"> 381 <li class="nav-item compact"> 382 <a class="nav-link" href="https://github.com/your-org/atdata"> <i class="bi bi-github" role="img"> 383</i> 384<span class="menu-text"></span></a> 385 </li> 386</ul> 387 </div> <!-- /navcollapse --> 388 <div class="quarto-navbar-tools"> 389 <a href="" class="quarto-color-scheme-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleColorScheme(); return false;" title="Toggle dark mode"><i class="bi"></i></a> 390</div> 391 </div> <!-- /container-fluid --> 392 </nav> 393</header> 394<!-- content --> 395<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article page-navbar"> 396<!-- sidebar --> 397<!-- margin-sidebar --> 398 <div id="quarto-margin-sidebar" class="sidebar margin-sidebar"> 399 <nav id="TOC" role="doc-toc" class="toc-active"> 400 <h2 id="toc-title">On this page</h2> 401 402 <ul> 403 <li><a href="#atdata.atmosphere.LensPublisher" id="toc-atdata.atmosphere.LensPublisher" class="nav-link active" data-scroll-target="#atdata.atmosphere.LensPublisher">LensPublisher</a> 404 <ul class="collapse"> 405 <li><a href="#examples" id="toc-examples" class="nav-link" data-scroll-target="#examples">Examples</a></li> 406 <li><a href="#security-note" id="toc-security-note" class="nav-link" data-scroll-target="#security-note">Security Note</a></li> 407 <li><a href="#methods" id="toc-methods" class="nav-link" data-scroll-target="#methods">Methods</a> 408 <ul class="collapse"> 409 <li><a href="#atdata.atmosphere.LensPublisher.publish" id="toc-atdata.atmosphere.LensPublisher.publish" class="nav-link" data-scroll-target="#atdata.atmosphere.LensPublisher.publish">publish</a></li> 410 <li><a href="#atdata.atmosphere.LensPublisher.publish_from_lens" id="toc-atdata.atmosphere.LensPublisher.publish_from_lens" class="nav-link" data-scroll-target="#atdata.atmosphere.LensPublisher.publish_from_lens">publish_from_lens</a></li> 411 </ul></li> 412 </ul></li> 413 </ul> 414<div class="toc-actions"><ul><li><a href="https://github.com/your-org/atdata/edit/main/api/LensPublisher.qmd" class="toc-action"><i class="bi bi-github"></i>Edit this page</a></li><li><a href="https://github.com/your-org/atdata/issues/new" class="toc-action"><i class="bi empty"></i>Report an issue</a></li></ul></div></nav> 415 </div> 416<!-- main --> 417<main class="content" id="quarto-document-content"><header id="title-block-header" class="quarto-title-block"></header> 418 419 420 421 422 423<section id="atdata.atmosphere.LensPublisher" class="level1"> 424<h1>LensPublisher</h1> 425<div class="sourceCode" id="cb1"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a>atmosphere.LensPublisher(client)</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> 426<p>Publishes Lens transformation records to ATProto.</p> 427<p>This class creates lens records that reference source and target schemas and point to the transformation code in a git repository.</p> 428<section id="examples" class="level2 doc-section doc-section-examples"> 429<h2 class="doc-section doc-section-examples anchored" data-anchor-id="examples">Examples</h2> 430<div class="sourceCode" id="cb2"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> <span class="op">@</span>atdata.lens</span> 431<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a>... <span class="kw">def</span> my_lens(source: SourceType) <span class="op">-&gt;</span> TargetType:</span> 432<span id="cb2-3"><a href="#cb2-3" aria-hidden="true" tabindex="-1"></a>... <span class="cf">return</span> TargetType(field<span class="op">=</span>source.other_field)</span> 433<span id="cb2-4"><a href="#cb2-4" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span></span> 434<span id="cb2-5"><a href="#cb2-5" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> client <span class="op">=</span> AtmosphereClient()</span> 435<span id="cb2-6"><a href="#cb2-6" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> client.login(<span class="st">"handle"</span>, <span class="st">"password"</span>)</span> 436<span id="cb2-7"><a href="#cb2-7" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span></span> 437<span id="cb2-8"><a href="#cb2-8" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> publisher <span class="op">=</span> LensPublisher(client)</span> 438<span id="cb2-9"><a href="#cb2-9" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> uri <span class="op">=</span> publisher.publish(</span> 439<span id="cb2-10"><a href="#cb2-10" aria-hidden="true" tabindex="-1"></a>... name<span class="op">=</span><span class="st">"my_lens"</span>,</span> 440<span id="cb2-11"><a href="#cb2-11" aria-hidden="true" tabindex="-1"></a>... source_schema_uri<span class="op">=</span><span class="st">"at://did:plc:abc/ac.foundation.dataset.sampleSchema/source"</span>,</span> 441<span id="cb2-12"><a href="#cb2-12" aria-hidden="true" tabindex="-1"></a>... target_schema_uri<span class="op">=</span><span class="st">"at://did:plc:abc/ac.foundation.dataset.sampleSchema/target"</span>,</span> 442<span id="cb2-13"><a href="#cb2-13" aria-hidden="true" tabindex="-1"></a>... code_repository<span class="op">=</span><span class="st">"https://github.com/user/repo"</span>,</span> 443<span id="cb2-14"><a href="#cb2-14" aria-hidden="true" tabindex="-1"></a>... code_commit<span class="op">=</span><span class="st">"abc123def456"</span>,</span> 444<span id="cb2-15"><a href="#cb2-15" aria-hidden="true" tabindex="-1"></a>... getter_path<span class="op">=</span><span class="st">"mymodule.lenses:my_lens"</span>,</span> 445<span id="cb2-16"><a href="#cb2-16" aria-hidden="true" tabindex="-1"></a>... putter_path<span class="op">=</span><span class="st">"mymodule.lenses:my_lens_putter"</span>,</span> 446<span id="cb2-17"><a href="#cb2-17" aria-hidden="true" tabindex="-1"></a>... )</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> 447</section> 448<section id="security-note" class="level2 doc-section doc-section-security-note"> 449<h2 class="doc-section doc-section-security-note anchored" data-anchor-id="security-note">Security Note</h2> 450<p>Lens code is stored as references to git repositories rather than inline code. This prevents arbitrary code execution from ATProto records. Users must manually install and trust lens implementations.</p> 451</section> 452<section id="methods" class="level2"> 453<h2 class="anchored" data-anchor-id="methods">Methods</h2> 454<table class="caption-top table"> 455<thead> 456<tr class="header"> 457<th>Name</th> 458<th>Description</th> 459</tr> 460</thead> 461<tbody> 462<tr class="odd"> 463<td><a href="#atdata.atmosphere.LensPublisher.publish">publish</a></td> 464<td>Publish a lens transformation record to ATProto.</td> 465</tr> 466<tr class="even"> 467<td><a href="#atdata.atmosphere.LensPublisher.publish_from_lens">publish_from_lens</a></td> 468<td>Publish a lens record from an existing Lens object.</td> 469</tr> 470</tbody> 471</table> 472<section id="atdata.atmosphere.LensPublisher.publish" class="level3"> 473<h3 class="anchored" data-anchor-id="atdata.atmosphere.LensPublisher.publish">publish</h3> 474<div class="sourceCode" id="cb3"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a>atmosphere.LensPublisher.publish(</span> 475<span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a> name,</span> 476<span id="cb3-3"><a href="#cb3-3" aria-hidden="true" tabindex="-1"></a> source_schema_uri,</span> 477<span id="cb3-4"><a href="#cb3-4" aria-hidden="true" tabindex="-1"></a> target_schema_uri,</span> 478<span id="cb3-5"><a href="#cb3-5" aria-hidden="true" tabindex="-1"></a> description<span class="op">=</span><span class="va">None</span>,</span> 479<span id="cb3-6"><a href="#cb3-6" aria-hidden="true" tabindex="-1"></a> code_repository<span class="op">=</span><span class="va">None</span>,</span> 480<span id="cb3-7"><a href="#cb3-7" aria-hidden="true" tabindex="-1"></a> code_commit<span class="op">=</span><span class="va">None</span>,</span> 481<span id="cb3-8"><a href="#cb3-8" aria-hidden="true" tabindex="-1"></a> getter_path<span class="op">=</span><span class="va">None</span>,</span> 482<span id="cb3-9"><a href="#cb3-9" aria-hidden="true" tabindex="-1"></a> putter_path<span class="op">=</span><span class="va">None</span>,</span> 483<span id="cb3-10"><a href="#cb3-10" aria-hidden="true" tabindex="-1"></a> rkey<span class="op">=</span><span class="va">None</span>,</span> 484<span id="cb3-11"><a href="#cb3-11" aria-hidden="true" tabindex="-1"></a>)</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> 485<p>Publish a lens transformation record to ATProto.</p> 486<section id="parameters" class="level4 doc-section doc-section-parameters"> 487<h4 class="doc-section doc-section-parameters anchored" data-anchor-id="parameters">Parameters</h4> 488<table class="caption-top table"> 489<thead> 490<tr class="header"> 491<th>Name</th> 492<th>Type</th> 493<th>Description</th> 494<th>Default</th> 495</tr> 496</thead> 497<tbody> 498<tr class="odd"> 499<td>name</td> 500<td><a href="`str`">str</a></td> 501<td>Human-readable lens name.</td> 502<td><em>required</em></td> 503</tr> 504<tr class="even"> 505<td>source_schema_uri</td> 506<td><a href="`str`">str</a></td> 507<td>AT URI of the source schema.</td> 508<td><em>required</em></td> 509</tr> 510<tr class="odd"> 511<td>target_schema_uri</td> 512<td><a href="`str`">str</a></td> 513<td>AT URI of the target schema.</td> 514<td><em>required</em></td> 515</tr> 516<tr class="even"> 517<td>description</td> 518<td><a href="`typing.Optional`">Optional</a>[<a href="`str`">str</a>]</td> 519<td>What this transformation does.</td> 520<td><code>None</code></td> 521</tr> 522<tr class="odd"> 523<td>code_repository</td> 524<td><a href="`typing.Optional`">Optional</a>[<a href="`str`">str</a>]</td> 525<td>Git repository URL containing the lens code.</td> 526<td><code>None</code></td> 527</tr> 528<tr class="even"> 529<td>code_commit</td> 530<td><a href="`typing.Optional`">Optional</a>[<a href="`str`">str</a>]</td> 531<td>Git commit hash for reproducibility.</td> 532<td><code>None</code></td> 533</tr> 534<tr class="odd"> 535<td>getter_path</td> 536<td><a href="`typing.Optional`">Optional</a>[<a href="`str`">str</a>]</td> 537<td>Module path to the getter function (e.g., ‘mymodule.lenses:my_getter’).</td> 538<td><code>None</code></td> 539</tr> 540<tr class="even"> 541<td>putter_path</td> 542<td><a href="`typing.Optional`">Optional</a>[<a href="`str`">str</a>]</td> 543<td>Module path to the putter function (e.g., ‘mymodule.lenses:my_putter’).</td> 544<td><code>None</code></td> 545</tr> 546<tr class="odd"> 547<td>rkey</td> 548<td><a href="`typing.Optional`">Optional</a>[<a href="`str`">str</a>]</td> 549<td>Optional explicit record key.</td> 550<td><code>None</code></td> 551</tr> 552</tbody> 553</table> 554</section> 555<section id="returns" class="level4 doc-section doc-section-returns"> 556<h4 class="doc-section doc-section-returns anchored" data-anchor-id="returns">Returns</h4> 557<table class="caption-top table"> 558<thead> 559<tr class="header"> 560<th>Name</th> 561<th>Type</th> 562<th>Description</th> 563</tr> 564</thead> 565<tbody> 566<tr class="odd"> 567<td></td> 568<td><a href="`atdata.atmosphere._types.AtUri`">AtUri</a></td> 569<td>The AT URI of the created lens record.</td> 570</tr> 571</tbody> 572</table> 573</section> 574<section id="raises" class="level4 doc-section doc-section-raises"> 575<h4 class="doc-section doc-section-raises anchored" data-anchor-id="raises">Raises</h4> 576<table class="caption-top table"> 577<thead> 578<tr class="header"> 579<th>Name</th> 580<th>Type</th> 581<th>Description</th> 582</tr> 583</thead> 584<tbody> 585<tr class="odd"> 586<td></td> 587<td><a href="`ValueError`">ValueError</a></td> 588<td>If code references are incomplete.</td> 589</tr> 590</tbody> 591</table> 592</section> 593</section> 594<section id="atdata.atmosphere.LensPublisher.publish_from_lens" class="level3"> 595<h3 class="anchored" data-anchor-id="atdata.atmosphere.LensPublisher.publish_from_lens">publish_from_lens</h3> 596<div class="sourceCode" id="cb4"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a>atmosphere.LensPublisher.publish_from_lens(</span> 597<span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a> lens_obj,</span> 598<span id="cb4-3"><a href="#cb4-3" aria-hidden="true" tabindex="-1"></a> <span class="op">*</span>,</span> 599<span id="cb4-4"><a href="#cb4-4" aria-hidden="true" tabindex="-1"></a> name,</span> 600<span id="cb4-5"><a href="#cb4-5" aria-hidden="true" tabindex="-1"></a> source_schema_uri,</span> 601<span id="cb4-6"><a href="#cb4-6" aria-hidden="true" tabindex="-1"></a> target_schema_uri,</span> 602<span id="cb4-7"><a href="#cb4-7" aria-hidden="true" tabindex="-1"></a> code_repository,</span> 603<span id="cb4-8"><a href="#cb4-8" aria-hidden="true" tabindex="-1"></a> code_commit,</span> 604<span id="cb4-9"><a href="#cb4-9" aria-hidden="true" tabindex="-1"></a> description<span class="op">=</span><span class="va">None</span>,</span> 605<span id="cb4-10"><a href="#cb4-10" aria-hidden="true" tabindex="-1"></a> rkey<span class="op">=</span><span class="va">None</span>,</span> 606<span id="cb4-11"><a href="#cb4-11" aria-hidden="true" tabindex="-1"></a>)</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> 607<p>Publish a lens record from an existing Lens object.</p> 608<p>This method extracts the getter and putter function names from the Lens object and publishes a record referencing them.</p> 609<section id="parameters-1" class="level4 doc-section doc-section-parameters"> 610<h4 class="doc-section doc-section-parameters anchored" data-anchor-id="parameters-1">Parameters</h4> 611<table class="caption-top table"> 612<thead> 613<tr class="header"> 614<th>Name</th> 615<th>Type</th> 616<th>Description</th> 617<th>Default</th> 618</tr> 619</thead> 620<tbody> 621<tr class="odd"> 622<td>lens_obj</td> 623<td><a href="`atdata.lens.Lens`">Lens</a></td> 624<td>The Lens object to publish.</td> 625<td><em>required</em></td> 626</tr> 627<tr class="even"> 628<td>name</td> 629<td><a href="`str`">str</a></td> 630<td>Human-readable lens name.</td> 631<td><em>required</em></td> 632</tr> 633<tr class="odd"> 634<td>source_schema_uri</td> 635<td><a href="`str`">str</a></td> 636<td>AT URI of the source schema.</td> 637<td><em>required</em></td> 638</tr> 639<tr class="even"> 640<td>target_schema_uri</td> 641<td><a href="`str`">str</a></td> 642<td>AT URI of the target schema.</td> 643<td><em>required</em></td> 644</tr> 645<tr class="odd"> 646<td>code_repository</td> 647<td><a href="`str`">str</a></td> 648<td>Git repository URL.</td> 649<td><em>required</em></td> 650</tr> 651<tr class="even"> 652<td>code_commit</td> 653<td><a href="`str`">str</a></td> 654<td>Git commit hash.</td> 655<td><em>required</em></td> 656</tr> 657<tr class="odd"> 658<td>description</td> 659<td><a href="`typing.Optional`">Optional</a>[<a href="`str`">str</a>]</td> 660<td>What this transformation does.</td> 661<td><code>None</code></td> 662</tr> 663<tr class="even"> 664<td>rkey</td> 665<td><a href="`typing.Optional`">Optional</a>[<a href="`str`">str</a>]</td> 666<td>Optional explicit record key.</td> 667<td><code>None</code></td> 668</tr> 669</tbody> 670</table> 671</section> 672<section id="returns-1" class="level4 doc-section doc-section-returns"> 673<h4 class="doc-section doc-section-returns anchored" data-anchor-id="returns-1">Returns</h4> 674<table class="caption-top table"> 675<thead> 676<tr class="header"> 677<th>Name</th> 678<th>Type</th> 679<th>Description</th> 680</tr> 681</thead> 682<tbody> 683<tr class="odd"> 684<td></td> 685<td><a href="`atdata.atmosphere._types.AtUri`">AtUri</a></td> 686<td>The AT URI of the created lens record.</td> 687</tr> 688</tbody> 689</table> 690 691 692</section> 693</section> 694</section> 695</section> 696 697</main> <!-- /main --> 698<script id="quarto-html-after-body" type="application/javascript"> 699 window.document.addEventListener("DOMContentLoaded", function (event) { 700 // Ensure there is a toggle, if there isn't float one in the top right 701 if (window.document.querySelector('.quarto-color-scheme-toggle') === null) { 702 const a = window.document.createElement('a'); 703 a.classList.add('top-right'); 704 a.classList.add('quarto-color-scheme-toggle'); 705 a.href = ""; 706 a.onclick = function() { try { window.quartoToggleColorScheme(); } catch {} return false; }; 707 const i = window.document.createElement("i"); 708 i.classList.add('bi'); 709 a.appendChild(i); 710 window.document.body.appendChild(a); 711 } 712 setColorSchemeToggle(hasAlternateSentinel()) 713 const icon = ""; 714 const anchorJS = new window.AnchorJS(); 715 anchorJS.options = { 716 placement: 'right', 717 icon: icon 718 }; 719 anchorJS.add('.anchored'); 720 const isCodeAnnotation = (el) => { 721 for (const clz of el.classList) { 722 if (clz.startsWith('code-annotation-')) { 723 return true; 724 } 725 } 726 return false; 727 } 728 const onCopySuccess = function(e) { 729 // button target 730 const button = e.trigger; 731 // don't keep focus 732 button.blur(); 733 // flash "checked" 734 button.classList.add('code-copy-button-checked'); 735 var currentTitle = button.getAttribute("title"); 736 button.setAttribute("title", "Copied!"); 737 let tooltip; 738 if (window.bootstrap) { 739 button.setAttribute("data-bs-toggle", "tooltip"); 740 button.setAttribute("data-bs-placement", "left"); 741 button.setAttribute("data-bs-title", "Copied!"); 742 tooltip = new bootstrap.Tooltip(button, 743 { trigger: "manual", 744 customClass: "code-copy-button-tooltip", 745 offset: [0, -8]}); 746 tooltip.show(); 747 } 748 setTimeout(function() { 749 if (tooltip) { 750 tooltip.hide(); 751 button.removeAttribute("data-bs-title"); 752 button.removeAttribute("data-bs-toggle"); 753 button.removeAttribute("data-bs-placement"); 754 } 755 button.setAttribute("title", currentTitle); 756 button.classList.remove('code-copy-button-checked'); 757 }, 1000); 758 // clear code selection 759 e.clearSelection(); 760 } 761 const getTextToCopy = function(trigger) { 762 const codeEl = trigger.previousElementSibling.cloneNode(true); 763 for (const childEl of codeEl.children) { 764 if (isCodeAnnotation(childEl)) { 765 childEl.remove(); 766 } 767 } 768 return codeEl.innerText; 769 } 770 const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', { 771 text: getTextToCopy 772 }); 773 clipboard.on('success', onCopySuccess); 774 if (window.document.getElementById('quarto-embedded-source-code-modal')) { 775 const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', { 776 text: getTextToCopy, 777 container: window.document.getElementById('quarto-embedded-source-code-modal') 778 }); 779 clipboardModal.on('success', onCopySuccess); 780 } 781 var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//); 782 var mailtoRegex = new RegExp(/^mailto:/); 783 var filterRegex = new RegExp("https:\/\/github\.com\/your-org\/atdata"); 784 var isInternal = (href) => { 785 return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href); 786 } 787 // Inspect non-navigation links and adorn them if external 788 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)'); 789 for (var i=0; i<links.length; i++) { 790 const link = links[i]; 791 if (!isInternal(link.href)) { 792 // undo the damage that might have been done by quarto-nav.js in the case of 793 // links that we want to consider external 794 if (link.dataset.originalHref !== undefined) { 795 link.href = link.dataset.originalHref; 796 } 797 } 798 } 799 function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) { 800 const config = { 801 allowHTML: true, 802 maxWidth: 500, 803 delay: 100, 804 arrow: false, 805 appendTo: function(el) { 806 return el.parentElement; 807 }, 808 interactive: true, 809 interactiveBorder: 10, 810 theme: 'quarto', 811 placement: 'bottom-start', 812 }; 813 if (contentFn) { 814 config.content = contentFn; 815 } 816 if (onTriggerFn) { 817 config.onTrigger = onTriggerFn; 818 } 819 if (onUntriggerFn) { 820 config.onUntrigger = onUntriggerFn; 821 } 822 window.tippy(el, config); 823 } 824 const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]'); 825 for (var i=0; i<noterefs.length; i++) { 826 const ref = noterefs[i]; 827 tippyHover(ref, function() { 828 // use id or data attribute instead here 829 let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href'); 830 try { href = new URL(href).hash; } catch {} 831 const id = href.replace(/^#\/?/, ""); 832 const note = window.document.getElementById(id); 833 if (note) { 834 return note.innerHTML; 835 } else { 836 return ""; 837 } 838 }); 839 } 840 const xrefs = window.document.querySelectorAll('a.quarto-xref'); 841 const processXRef = (id, note) => { 842 // Strip column container classes 843 const stripColumnClz = (el) => { 844 el.classList.remove("page-full", "page-columns"); 845 if (el.children) { 846 for (const child of el.children) { 847 stripColumnClz(child); 848 } 849 } 850 } 851 stripColumnClz(note) 852 if (id === null || id.startsWith('sec-')) { 853 // Special case sections, only their first couple elements 854 const container = document.createElement("div"); 855 if (note.children && note.children.length > 2) { 856 container.appendChild(note.children[0].cloneNode(true)); 857 for (let i = 1; i < note.children.length; i++) { 858 const child = note.children[i]; 859 if (child.tagName === "P" && child.innerText === "") { 860 continue; 861 } else { 862 container.appendChild(child.cloneNode(true)); 863 break; 864 } 865 } 866 if (window.Quarto?.typesetMath) { 867 window.Quarto.typesetMath(container); 868 } 869 return container.innerHTML 870 } else { 871 if (window.Quarto?.typesetMath) { 872 window.Quarto.typesetMath(note); 873 } 874 return note.innerHTML; 875 } 876 } else { 877 // Remove any anchor links if they are present 878 const anchorLink = note.querySelector('a.anchorjs-link'); 879 if (anchorLink) { 880 anchorLink.remove(); 881 } 882 if (window.Quarto?.typesetMath) { 883 window.Quarto.typesetMath(note); 884 } 885 if (note.classList.contains("callout")) { 886 return note.outerHTML; 887 } else { 888 return note.innerHTML; 889 } 890 } 891 } 892 for (var i=0; i<xrefs.length; i++) { 893 const xref = xrefs[i]; 894 tippyHover(xref, undefined, function(instance) { 895 instance.disable(); 896 let url = xref.getAttribute('href'); 897 let hash = undefined; 898 if (url.startsWith('#')) { 899 hash = url; 900 } else { 901 try { hash = new URL(url).hash; } catch {} 902 } 903 if (hash) { 904 const id = hash.replace(/^#\/?/, ""); 905 const note = window.document.getElementById(id); 906 if (note !== null) { 907 try { 908 const html = processXRef(id, note.cloneNode(true)); 909 instance.setContent(html); 910 } finally { 911 instance.enable(); 912 instance.show(); 913 } 914 } else { 915 // See if we can fetch this 916 fetch(url.split('#')[0]) 917 .then(res => res.text()) 918 .then(html => { 919 const parser = new DOMParser(); 920 const htmlDoc = parser.parseFromString(html, "text/html"); 921 const note = htmlDoc.getElementById(id); 922 if (note !== null) { 923 const html = processXRef(id, note); 924 instance.setContent(html); 925 } 926 }).finally(() => { 927 instance.enable(); 928 instance.show(); 929 }); 930 } 931 } else { 932 // See if we can fetch a full url (with no hash to target) 933 // This is a special case and we should probably do some content thinning / targeting 934 fetch(url) 935 .then(res => res.text()) 936 .then(html => { 937 const parser = new DOMParser(); 938 const htmlDoc = parser.parseFromString(html, "text/html"); 939 const note = htmlDoc.querySelector('main.content'); 940 if (note !== null) { 941 // This should only happen for chapter cross references 942 // (since there is no id in the URL) 943 // remove the first header 944 if (note.children.length > 0 && note.children[0].tagName === "HEADER") { 945 note.children[0].remove(); 946 } 947 const html = processXRef(null, note); 948 instance.setContent(html); 949 } 950 }).finally(() => { 951 instance.enable(); 952 instance.show(); 953 }); 954 } 955 }, function(instance) { 956 }); 957 } 958 let selectedAnnoteEl; 959 const selectorForAnnotation = ( cell, annotation) => { 960 let cellAttr = 'data-code-cell="' + cell + '"'; 961 let lineAttr = 'data-code-annotation="' + annotation + '"'; 962 const selector = 'span[' + cellAttr + '][' + lineAttr + ']'; 963 return selector; 964 } 965 const selectCodeLines = (annoteEl) => { 966 const doc = window.document; 967 const targetCell = annoteEl.getAttribute("data-target-cell"); 968 const targetAnnotation = annoteEl.getAttribute("data-target-annotation"); 969 const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation)); 970 const lines = annoteSpan.getAttribute("data-code-lines").split(","); 971 const lineIds = lines.map((line) => { 972 return targetCell + "-" + line; 973 }) 974 let top = null; 975 let height = null; 976 let parent = null; 977 if (lineIds.length > 0) { 978 //compute the position of the single el (top and bottom and make a div) 979 const el = window.document.getElementById(lineIds[0]); 980 top = el.offsetTop; 981 height = el.offsetHeight; 982 parent = el.parentElement.parentElement; 983 if (lineIds.length > 1) { 984 const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]); 985 const bottom = lastEl.offsetTop + lastEl.offsetHeight; 986 height = bottom - top; 987 } 988 if (top !== null && height !== null && parent !== null) { 989 // cook up a div (if necessary) and position it 990 let div = window.document.getElementById("code-annotation-line-highlight"); 991 if (div === null) { 992 div = window.document.createElement("div"); 993 div.setAttribute("id", "code-annotation-line-highlight"); 994 div.style.position = 'absolute'; 995 parent.appendChild(div); 996 } 997 div.style.top = top - 2 + "px"; 998 div.style.height = height + 4 + "px"; 999 div.style.left = 0; 1000 let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter"); 1001 if (gutterDiv === null) { 1002 gutterDiv = window.document.createElement("div"); 1003 gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter"); 1004 gutterDiv.style.position = 'absolute'; 1005 const codeCell = window.document.getElementById(targetCell); 1006 const gutter = codeCell.querySelector('.code-annotation-gutter'); 1007 gutter.appendChild(gutterDiv); 1008 } 1009 gutterDiv.style.top = top - 2 + "px"; 1010 gutterDiv.style.height = height + 4 + "px"; 1011 } 1012 selectedAnnoteEl = annoteEl; 1013 } 1014 }; 1015 const unselectCodeLines = () => { 1016 const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"]; 1017 elementsIds.forEach((elId) => { 1018 const div = window.document.getElementById(elId); 1019 if (div) { 1020 div.remove(); 1021 } 1022 }); 1023 selectedAnnoteEl = undefined; 1024 }; 1025 // Handle positioning of the toggle 1026 window.addEventListener( 1027 "resize", 1028 throttle(() => { 1029 elRect = undefined; 1030 if (selectedAnnoteEl) { 1031 selectCodeLines(selectedAnnoteEl); 1032 } 1033 }, 10) 1034 ); 1035 function throttle(fn, ms) { 1036 let throttle = false; 1037 let timer; 1038 return (...args) => { 1039 if(!throttle) { // first call gets through 1040 fn.apply(this, args); 1041 throttle = true; 1042 } else { // all the others get throttled 1043 if(timer) clearTimeout(timer); // cancel #2 1044 timer = setTimeout(() => { 1045 fn.apply(this, args); 1046 timer = throttle = false; 1047 }, ms); 1048 } 1049 }; 1050 } 1051 // Attach click handler to the DT 1052 const annoteDls = window.document.querySelectorAll('dt[data-target-cell]'); 1053 for (const annoteDlNode of annoteDls) { 1054 annoteDlNode.addEventListener('click', (event) => { 1055 const clickedEl = event.target; 1056 if (clickedEl !== selectedAnnoteEl) { 1057 unselectCodeLines(); 1058 const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active'); 1059 if (activeEl) { 1060 activeEl.classList.remove('code-annotation-active'); 1061 } 1062 selectCodeLines(clickedEl); 1063 clickedEl.classList.add('code-annotation-active'); 1064 } else { 1065 // Unselect the line 1066 unselectCodeLines(); 1067 clickedEl.classList.remove('code-annotation-active'); 1068 } 1069 }); 1070 } 1071 const findCites = (el) => { 1072 const parentEl = el.parentElement; 1073 if (parentEl) { 1074 const cites = parentEl.dataset.cites; 1075 if (cites) { 1076 return { 1077 el, 1078 cites: cites.split(' ') 1079 }; 1080 } else { 1081 return findCites(el.parentElement) 1082 } 1083 } else { 1084 return undefined; 1085 } 1086 }; 1087 var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]'); 1088 for (var i=0; i<bibliorefs.length; i++) { 1089 const ref = bibliorefs[i]; 1090 const citeInfo = findCites(ref); 1091 if (citeInfo) { 1092 tippyHover(citeInfo.el, function() { 1093 var popup = window.document.createElement('div'); 1094 citeInfo.cites.forEach(function(cite) { 1095 var citeDiv = window.document.createElement('div'); 1096 citeDiv.classList.add('hanging-indent'); 1097 citeDiv.classList.add('csl-entry'); 1098 var biblioDiv = window.document.getElementById('ref-' + cite); 1099 if (biblioDiv) { 1100 citeDiv.innerHTML = biblioDiv.innerHTML; 1101 } 1102 popup.appendChild(citeDiv); 1103 }); 1104 return popup.innerHTML; 1105 }); 1106 } 1107 } 1108 }); 1109 </script> 1110</div> <!-- /content --> 1111<footer class="footer"> 1112 <div class="nav-footer"> 1113 <div class="nav-footer-left"> 1114<p>Built with <a href="https://quarto.org/">Quarto</a></p> 1115</div> 1116 <div class="nav-footer-center"> 1117 &nbsp; 1118 <div class="toc-actions d-sm-block d-md-none"><ul><li><a href="https://github.com/your-org/atdata/edit/main/api/LensPublisher.qmd" class="toc-action"><i class="bi bi-github"></i>Edit this page</a></li><li><a href="https://github.com/your-org/atdata/issues/new" class="toc-action"><i class="bi empty"></i>Report an issue</a></li></ul></div></div> 1119 <div class="nav-footer-right"> 1120<p>MIT License</p> 1121</div> 1122 </div> 1123</footer> 1124 1125 1126 1127 1128</body></html>