2c:null 2d:["$","title",null,{"children":"Import Utilities | Maic López Sáenz | Observable"}] 32:T6cf,async function importCheck(notebook, version = null) { let hasVersionParam = version !== null if (hasVersionParam) { // Convert to string, in case a number is provided version = '' + version } // First character is skipped in case of '@' for usernames let separatorIndex = notebook.indexOf('@', 1) let hasVersionInNotebook = separatorIndex >= 0 if (hasVersionInNotebook) { version = notebook.substring(separatorIndex+1) notebook = notebook.substring(0, separatorIndex) } let errorNote = null if (!hasVersionParam && !hasVersionInNotebook) { errorNote = 'No version provided!' } else if (hasVersionParam && hasVersionInNotebook) { errorNote = 'Ambiguous version provided!' } if (errorNote !== null) { return htl.html` import-check: 🛑 ${notebook} ${errorNote}` } let stableVersion = await getPausedVersion(notebook) if (stableVersion === null) { // Check for regular version, in case of notebooks without paused version stableVersion = await getNotebookVersion(notebook) } let latestVersion = null if (version === 'latest') { latestVersion = await getLatestVersion(notebook) } let isUpToDate = stableVersion == version if (isUpToDate) { return htl.html`import-check: ✅ ${notebook}@${version}` } if (latestVersion !== null) { return htl.html` import-check: 🔶 ${notebook}@${version} Stable: ${stableVersion} Latest: ${latestVersion}` } return htl.html` import-check: 🔶 ${notebook}@${version} Stable: ${stableVersion}` }33:[] 30:{"id":"2888a9162c1f5dd6","slug":"import-utilities","title":"Import Utilities","thumbnail":"221cef2898f19262dc9bae90e4fe87eb5695039d2d63a639b18d0c9bd3ae0bf9","access_level":"public","create_time":"$D2021-05-03T20:25:39.652Z","update_time":"$D2023-08-10T20:57:14.279Z","view_time":null,"first_public_time":"$D2021-05-03T20:41:28.347Z","has_unpublished_edits":null,"fork":false,"stars":2,"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":552,"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,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"titling":"auto","title":"Import Utilities","cells":[{"id":0,"value":"# Import Utilities\n\nUtilities to check the stable version of notebooks against the imported version, and to display `import` statements for the current notebook.\n\nFor this utilities the [_paused_ version](https://observablehq.com/@observablehq/pause-live-edits-in-public-notebooks) of a notebook is considered the stable version. When a notebook has no _paused_ version, then the _latest_ or _published_ version is considered stable.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":117,"value":"### Import\n${await makeImportStatement(['importCheck', 'makeImportStatement', 'getCurrentStableVersion', 'getCurrentStableName'], true)}\n\nStable pinned name: `${await getCurrentStableName()}`\n
\nVersion (pin): `${version} (${await getCurrentStableVersion()})`","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":101,"value":"version = '3.1.1'\n// 3.1.1 (552) - Documentation updates, add support for `latest` version\n// 3.1.0 (519) - Update to use `notebook-versions` to support paused and latest, some functions renamed to `paused`, `importUtils` removed\n// 2.1.0 (414) - `importCheck` can receive the pin within `notebook` parameter\n// 2.0.0 (380) - Implement `importStatement`, expose properties of importUtils at root\n// 1.1.0 (235) - Use samp instead of pre for the produced html element in importCheck\n// 1.0.2 - Updated to use cell modes, no functional changes\n// 1.0.1 - First labeled version, added importUtils","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":255,"value":"---\n### `makeImportStatement(cellNames, appendCopyButton = false)`\n\nOutputs an `html` cell for the currently published notebook and the given `cellNames`.\n\nWhen `appendCopyButton` is `true`, a _Copy to clipboard_ button is displayed bellow the `import` statement.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":263,"value":"async function makeImportStatement(cellNames, appendCopyButton = false) {\n let pinnedName = await getCurrentPausedName()\n let cellsString = cellNames.join(', ')\n let importString = `import {${cellsString}} from '${pinnedName}'`\n \n let codeBlock = md`\n\\`\\`\\`js\n${importString}\n\\`\\`\\`\n`\n\n if (appendCopyButton) {\n let copyButton = Inputs.button('Copy to clipboard 📋', {reduce: () => \n navigator.clipboard.writeText(importString)\n })\n codeBlock.append(copyButton)\n }\n \n return codeBlock\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":65,"value":"---\n### `importCheck(notebook, version = null)`\n\nOutputs an `html` cell indicating if the given `version` is the current stable (paused) version for the given `notebook`.\n\nThe version can be provided through the `version` parameter, or within `notebook` in the usual `'@user/notebook@version'` format.\n\nFor notebooks without a `paused` version, the last published version is considered the stable version. ","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":13,"value":"$32","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":75,"value":"### Examples","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":194,"value":"> With a `version` that matches the latest, a green check ✅ is displayed","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":403,"value":"importCheck('@lopsae/paused-notebook', '4')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":404,"value":"importCheck('@lopsae/unpaused-notebook@15')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":182,"value":"> With a `version` different that the latest, a warning 🔶 is displayed:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":23,"value":"importCheck('@lopsae/paused-notebook', '1')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":409,"value":"importCheck('@lopsae/unpaused-notebook@2')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":546,"value":"> When `latest` is used as `version`, a warning 🔸 is displayed and both versions are shown:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":539,"value":"importCheck('@lopsae/paused-notebook', 'latest')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":474,"value":"> For notebooks that do not have a `paused` version, the last published version is considered:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":470,"value":"importCheck('@lopsae/rac-prototype', 3)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":387,"value":"### Errors","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":178,"value":"> Without a `version` parameter and no version within `notebook`:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":17,"value":"importCheck('@lopsae/paused-notebook')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":394,"value":"> Providing both a `version` parameter and a version within `notebook`:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":398,"value":"importCheck('@lopsae/unpaused-notebook@3', '4')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":348,"value":"---\n### `getCurrentStableVersion()`\nReturns the current stable version of the calling notebook. The _paused_ version when available is considered the stable version, otherwise returns the _latest_ or _published_ version.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":358,"value":"getCurrentStableVersion = getCurrentPausedVersion;","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":532,"value":"Current stable version: `${await getCurrentStableVersion()}`","pinned":true,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":352,"value":"---\n### `getCurrentStableName()`\nReturns the current stable name and version of the calling notebook. The _paused_ version when available is considered the stable version, otherwise the _latest_ or _published_ version is used.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":432,"value":"getCurrentStableName = getCurrentPausedName;","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":535,"value":"Current stable name: `${await getCurrentStableName()}`","pinned":true,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":88,"value":"---\n### Colophon","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":231,"value":"styles","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":221,"value":"import {styles} from '@lopsae/styles@159'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":224,"value":"importCheck('@lopsae/styles', 159)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":417,"value":"import {\n getCurrentPausedName, getCurrentPausedVersion,\n getPausedVersion, getLatestVersion,\n getNotebookVersion, getCurrentMetadata\n}\nfrom '@lopsae/notebook-versions@1047'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":502,"value":"importCheck('@lopsae/notebook-versions', 1047)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W33","stdlib":"1"}} 31:"$30:body"