2a:null 2b:["$","title",null,{"children":"Notebook versions | Maic López Sáenz | Observable"}] 30:T49e,function dataTable(...cells) { const cellStyle = 'padding:.5em; vertical-align:top;'; let htmlRows = []; let headerCell = null; cells.forEach( (currentCell) => { if (headerCell === null) { // Make header cell const samp = htl.html`${currentCell}` headerCell = htl.html`${samp}`; } else { // Make data cell let dataString; if (typeof currentCell === 'string') { dataString = currentCell; } else if (currentCell === null) { dataString = '{null}'; } else { dataString = JSON.stringify(currentCell); } const pre = htl.html`${dataString}` pre.style = 'max-height:5.8em; overflow:auto; white-space:break-spaces;'; const dataCell = htl.html`${pre}`; const row = htl.html`${headerCell}${dataCell}`; htmlRows.push(row); headerCell = null; } }); // Derelict header if (headerCell !== null) { const row = htl.html`${headerCell}`; htmlRows.push(row); } return htl.html`${htmlRows}`; }31:[] 2e:{"id":"62b869eb41388ca8","slug":"notebook-versions","title":"Notebook versions","thumbnail":"3dc97b7d1312a8bd07060c539693b2bafc4fc75bac6ed4f8489775022e08cb83","access_level":"public","create_time":"$D2023-02-02T04:28:42.614Z","update_time":"$D2023-06-26T08:44:49.364Z","view_time":null,"first_public_time":"$D2023-02-02T04:28:42.614Z","fork":{"id":"55bed46f68a80641","slug":"notebook-data","title":"Version Pinning for Notebooks","owner":{"id":"898d35f8860c7f03","login":"mootari","name":"Fabian Iwand"}},"stars":0,"starred":false,"owner":{"type":"team","id":"f15bd58f0c95f3c8","login":"lopsae","name":"Maic López Sáenz","avatar_url":"https://avatars-next.observableusercontent.com/0893731e3547c49619042dd456ec0027d4e8c2f1359fc3c07859cb1fc2eb1ea4","tier":"starter_2024"},"version":1047,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"4770505bbf3a462a","login":"lopsae","name":"Maic López Sáenz","avatar_url":"https://avatars-next.observableusercontent.com/0893731e3547c49619042dd456ec0027d4e8c2f1359fc3c07859cb1fc2eb1ea4","tier":null}],"members":[{"type":"individual","id":"4770505bbf3a462a","login":"lopsae","name":"Maic López Sáenz","avatar_url":"https://avatars-next.observableusercontent.com/0893731e3547c49619042dd456ec0027d4e8c2f1359fc3c07859cb1fc2eb1ea4","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":true,"trashed":false,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"title":"Notebook versions","cells":[{"id":374,"value":"# Notebook versions\n\nObservable supports version pinning by appending the version number to the notebook name or path, including the version aliases [`paused` and `latest`](https://observablehq.com/@observablehq/pause-live-edits-in-public-notebooks) for live notebooks.\n\nThese functions allow to generate notebook names, paths, urls, and get metadata from the current and any notebook.\n\nThis can be useful to generate statements to direct users to use a specific version of a notebook.\n\nBased on [`@mootari/notebook-data`](https://observablehq.com/@mootari/notebook-data).","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":281,"value":"### Example:\n\nStable pinned name: `${await getCurrentPausedName()}`","pinned":true,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":859,"value":"---\n## Functions for current notebook\n\nFunctions to obtain information about the currently viewed notebook. When importing to other notebooks, the information of the importing notebook is retrieved.\n\nMetadata and the pinned name will be available once you have shared or published your notebook. Reload the page after publishing to see the updated version number.\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":4,"value":"function getCurrentPath() {\n return htl.html``.pathname;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":700,"value":"Retrieves the `path` from the current notebook's url. For published notebook this is `/@username/notebook-slug`, for unpublished notebooks this is `/d/document-id`.\n\n> ${dataTable('getCurrentPath()', getCurrentPath())}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":5,"value":"function getCurrentName() {\n return getCurrentPath().replace(/^\\/(d\\/)?/, '');\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":703,"value":"Retrieves the name of the current notebook. For published notebooks this is `@username/notebook-slug`, for unpublished notebooks this is `document-id`.\n> ${dataTable('getCurrentName()', getCurrentName())}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":136,"value":"function getCurrentUrl() {\n return formatNotebookUrl(getCurrentName());\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":706,"value":"Retrieves the URL for the current notebook.\n\n> ${dataTable('getCurrentUrl()', getCurrentUrl())}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":94,"value":"getCurrentMetadata = {\n let data = {};\n return async function getCurrentMetadata(version = null, refetch = false) {\n let key = version === null ? 'latest' : version;\n if(data[key] === undefined || refetch) {\n data[key] = await getMetadata(getCurrentName(), key);\n }\n return data[key];\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":697,"value":"> ${dataTable(\n 'getCurrentMetadata()', await getCurrentMetadata(),\n 'getCurrentMetadata(\"latest\")', await getCurrentMetadata(\"latest\"),\n 'getCurrentMetadata(\"paused\")', await getCurrentMetadata(\"paused\")\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":148,"value":"async function getCurrentPausedName() {\n const data = await getCurrentMetadata('paused');\n if(data && data.version) {\n return formatNotebookName(getCurrentName(), data.version);\n }\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":983,"value":"> ${dataTable(\n 'getCurrentPausedName()', await getCurrentPausedName()\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":992,"value":"async function getCurrentPausedVersion() {\n const data = await getCurrentMetadata('paused');\n if(data && data.version) {\n return data.version;\n }\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":995,"value":"> ${dataTable(\n 'getCurrentPausedVersion()', await getCurrentPausedVersion()\n)}","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":118,"value":"---\n## Functions for Name, Path, Url, and Source\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":358,"value":"function formatNotebookName(slug, version = null) {\n slug = slug.replace(/(@\\w+)?$/, '')\n return slug + (version ? '@' + version : '');\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":645,"value":"Returns a formatted name for a notebook following the format `@user/notebook-slug@version` or `notebook-hash@version`.\n\nThe `slug` parameter is expected to be either `@user/notebook-slug` or a `notebook-hash`. The `version` parameter is optional and can be a version number or a _version alias_ like `paused`.\n\nAny _versions_ contained in the given `slug` are removed.\n\n> ${dataTable(\n 'formatNotebookName(\"@user/slug\")', formatNotebookName(\"@user/slug\"),\n 'formatNotebookName(\"@user/slug\",123)', formatNotebookName(\"@user/slug\", 123),\n 'formatNotebookName(\"hash\",\"paused\")', formatNotebookName(\"hash\", \"paused\"),\n 'formatNotebookName(\"@user/slug@pin\")', formatNotebookName(\"@user/slug@pin\"),\n 'formatNotebookName(\"hash@pin\",\"123\")', formatNotebookName(\"hash@pin\",\"123\")\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":35,"value":"function formatNotebookPath(name, version = null) {\n const formattedName = formatNotebookName(name, version);\n if (name.startsWith('@')) {\n return '/' + formattedName;\n } else {\n return '/d/' + formattedName;\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":648,"value":"> ${dataTable(\n 'formatNotebookPath(\"@user/notepad\")', formatNotebookPath(\"@user/notepad\"),\n 'formatNotebookPath(\"@user/notepad\",123)', formatNotebookPath(\"@user/notepad\", 123),\n 'formatNotebookPath(\"document\")', formatNotebookPath(\"document\"),\n 'formatNotebookPath(\"document\",\"paused\")', formatNotebookPath(\"document\", \"paused\"),\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":27,"value":"function formatNotebookUrl(name, version = null) {\n let path = formatNotebookPath(name, version);\n return `https://${domain}${path}`;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":652,"value":"> ${dataTable(\n 'formatNotebookUrl(\"@user/notepad\",\"paused\")', formatNotebookUrl(\"@user/notepad\", \"paused\"),\n 'formatNotebookUrl(\"document\",123)', formatNotebookUrl(\"document\", 123),\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":13,"value":"function formatSourceUrl(name, version = null) {\n let path = formatNotebookPath(name, version);\n return `https://${apiDomain}${path}.js`;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":596,"value":"> ${dataTable(\n 'formatSourceUrl(\"@lopsae/paused-notebook\", 10)', formatSourceUrl(\"@lopsae/paused-notebook\", 10),\n 'formatSourceUrl(\"9252d30a8bbf6b43\", \"paused\")', formatSourceUrl(\"9252d30a8bbf6b43\", \"paused\")\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":58,"value":"async function getSource(name, version = null) {\n const path = formatSourceUrl(name, version);\n try {\n let cache = version ? 'default' : 'no-cache';\n const response = await fetch(path, {cache: cache});\n return await response.text();\n }\n catch(e) { return null; } \n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":602,"value":"> ${dataTable(\n 'getSource(\"@lopsae/paused-notebook\")', await getSource(\"@lopsae/paused-notebook\"),\n 'getSource(\"@lopsae/paused-notebook\", 10)', await getSource(\"@lopsae/paused-notebook\", 10),\n 'getSource(\"@lopsae/paused-notebook\", paused)', await getSource(\"@lopsae/paused-notebook\", \"paused\"),\n 'getSource(\"9252d30a8bbf6b43\")', await getSource(\"9252d30a8bbf6b43\"),\n 'getSource(\"nonexistent\")', await getSource(\"nonexistent\")\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":66,"value":"async function getMetadata(name, version = null) {\n let formattedName = formatNotebookName(name);\n const map = {\n 'URL': 'url',\n 'Title': 'title',\n 'Author': 'author',\n 'Version': 'version',\n 'Runtime version': 'runtimeVersion'\n };\n const source = await getSource(formattedName, version);\n if(!source) return null;\n \n const frontmatter = source.match(/^(?:\\/\\/ .+?\\n)+/);\n const id = source.match(/^\\s+?id:\\s+?\"([^@\"]+)/m);\n if(!frontmatter || !id) return null;\n \n return frontmatter[0].split(/\\n/).reduce((data, s) => {\n const m = s.match(/^\\/\\/ ([^:]+?):\\s+?(.+?)$/);\n if(m && map.hasOwnProperty(m[1])) data[map[m[1]]] = m[2];\n return data;\n }, {id: id[1]});\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":656,"value":"> ${dataTable(\n 'getMetadata(\"@lopsae/paused-notebook\")', await getMetadata(\"@lopsae/paused-notebook\"),\n 'getMetadata(\"@lopsae/paused-notebook\", \"latest\")', await getMetadata(\"@lopsae/paused-notebook\", \"latest\"),\n 'getMetadata(\"@lopsae/paused-notebook\", \"paused\")', await getMetadata(\"@lopsae/paused-notebook\", \"paused\"),\n 'getMetadata(\"9252d30a8bbf6b43\")', await getMetadata(\"9252d30a8bbf6b43\"),\n 'getMetadata(\"nonexistent\")', await getMetadata(\"nonexistent\")\n)}","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":954,"value":"---\n## Version Functions","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":723,"value":"async function getNotebookVersion(name, version = null) {\n let formattedName = formatNotebookName(name);\n const data = await getMetadata(formattedName, version);\n if (data && data.version) { \n return data.version;\n }\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":727,"value":"> ${dataTable(\n 'getNotebookVersion(\"@lopsae/paused-notebook\")', await getNotebookVersion(\"@lopsae/paused-notebook\"),\n 'getNotebookVersion(\"@lopsae/paused-notebook\",\"paused\")', await getNotebookVersion(\"@lopsae/paused-notebook\", \"paused\"),\n 'getNotebookVersion(\"@lopsae/paused-notebook@paused\")', await getNotebookVersion(\"@lopsae/paused-notebook@paused\"),\n 'getNotebookVersion(\"@lopsae/unpaused-notebook\")', await getNotebookVersion(\"@lopsae/unpaused-notebook\"),\n 'getNotebookVersion(\"@lopsae/unpaused-notebook\",\"paused\")', await getNotebookVersion(\"@lopsae/unpaused-notebook\", \"paused\"),\n 'getNotebookVersion(\"nonexistent\")', await getNotebookVersion(\"nonexistent\")\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":730,"value":"async function getPausedVersion(name) {\n return await getNotebookVersion(name, 'paused');\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":733,"value":"> ${dataTable(\n 'getPausedVersion(\"@lopsae/paused-notebook\")', await getPausedVersion(\"@lopsae/paused-notebook\"),\n 'getPausedVersion(\"@lopsae/unpaused-notebook\")', await getPausedVersion(\"@lopsae/unpaused-notebook\"),\n 'getPausedVersion(\"nonexistent\")', await getPausedVersion(\"nonexistent\")\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":767,"value":"async function getLatestVersion(name) {\n return await getNotebookVersion(name, 'latest');\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":800,"value":"> ${dataTable(\n 'getLatestVersion(\"@lopsae/paused-notebook\")', await getLatestVersion(\"@lopsae/paused-notebook\"),\n 'getLatestVersion(\"@lopsae/unpaused-notebook\")', await getLatestVersion(\"@lopsae/unpaused-notebook\"),\n 'getLatestVersion(\"nonexistent\")', await getLatestVersion(\"nonexistent\")\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":912,"value":"async function getPausedName(name) {\n let pausedVersion = await getPausedVersion(name);\n if (pausedVersion !== null) {\n return formatNotebookName(name, pausedVersion);\n }\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":915,"value":"> ${dataTable(\n 'getPausedName(\"@lopsae/unpaused-notebook\")', await getPausedName(\"@lopsae/unpaused-notebook\"),\n 'getPausedName(\"@lopsae/paused-notebook\")', await getPausedName(\"@lopsae/paused-notebook\"),\n 'getPausedName(\"@lopsae/paused-notebook@latest\")', await getPausedName(\"@lopsae/paused-notebook@latest\"),\n 'getPausedName(\"nonexistent\")', await getPausedName(\"nonexistent\")\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":153,"value":"async function getLatestName(name) {\n let latestVersion = await getLatestVersion(name);\n if (latestVersion !== null) {\n return formatNotebookName(name, latestVersion);\n }\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":720,"value":"> ${dataTable(\n 'getLatestName(\"@lopsae/unpaused-notebook\")', await getLatestName(\"@lopsae/unpaused-notebook\"),\n 'getLatestName(\"@lopsae/paused-notebook\")', await getLatestName(\"@lopsae/paused-notebook\"),\n 'getLatestName(\"@lopsae/paused-notebook@paused\")', await getLatestName(\"@lopsae/paused-notebook@paused\"),\n 'getLatestName(\"nonexistent\")', await getLatestName(\"nonexistent\")\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":127,"value":"async function getNotebookPausedPath(name) {\n const data = await getMetadata(name, 'paused');\n if(data && data.version) return formatNotebookUrl(name, data.version);\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":758,"value":"> ${dataTable(\n 'getNotebookPausedPath(\"@lopsae/paused-notebook\")', await getNotebookPausedPath(\"@lopsae/paused-notebook\"),\n 'getNotebookPausedPath(\"@lopsae/unpaused-notebook\")', await getNotebookPausedPath(\"@lopsae/unpaused-notebook\"),\n 'getNotebookPausedPath(\"nonexistent\")', await getNotebookPausedPath(\"nonexistent\")\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":735,"value":"async function getPausedUrl(name) {\n const pausedVersion = await getPausedVersion(name);\n if (pausedVersion !== null) {\n return formatNotebookUrl(name, pausedVersion);\n }\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":737,"value":"> ${dataTable(\n 'getPausedUrl(\"@lopsae/paused-notebook\")', await getPausedUrl(\"@lopsae/paused-notebook\"),\n 'getPausedUrl(\"@lopsae/unpaused-notebook\")', await getPausedUrl(\"@lopsae/unpaused-notebook\"),\n 'getPausedUrl(\"nonexistent\")', await getPausedUrl(\"nonexistent\")\n)}\n\n---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":926,"value":"async function getLatestUrl(name) {\n const latestVersion = await getLatestVersion(name);\n if (latestVersion !== null) {\n return formatNotebookUrl(name, latestVersion);\n }\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":935,"value":"> ${dataTable(\n 'getLatestUrl(\"@lopsae/paused-notebook\")', await getLatestUrl(\"@lopsae/paused-notebook\"),\n 'getLatestUrl(\"@lopsae/unpaused-notebook\")', await getLatestUrl(\"@lopsae/unpaused-notebook\"),\n 'getLatestUrl(\"nonexistent\")', await getLatestUrl(\"nonexistent\")\n)}","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":47,"value":"---\n### Configuration","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":29,"value":"domain = 'observablehq.com'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":39,"value":"apiDomain = 'api.observablehq.com'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":939,"value":"---\n### Utilities","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":522,"value":"$30","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":944,"value":"For displaying function calls along their return objects.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":419,"value":"dataTable(\n 'lorem_ipsum', 'dolor sit amet',\n 'longer_ipsum', 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.'\n)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":524,"value":"dataTable(\n \"one\", \"uno\",\n \"two\", \"dos\",\n \"null\", null,\n \"object\", {three:'tres', four:'cuatro'}\n)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":541,"value":"dataTable(\"one\", \"uno\", \"none!\")","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":396,"value":"---\n### Colophon","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":401,"value":"styles","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":398,"value":"import {styles} from '@lopsae/styles@159'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":1040,"value":" Stable version for `styles`: `${await getPausedVersion('@lopsae/styles')}`","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"}],"files":"$W31","stdlib":"1","titling":"auto"}} 2f:"$2e:body"