Function convertDeepnoteToFormat

packages/convert/src/cli.ts:354–421

(
  absolutePath: string,
  outputFormat: 'jupyter' | 'percent' | 'quarto' | 'marimo',
  customOutputPath: string | undefined,
  cwd: string
)

}

async function convertDeepnoteToFormat(
  absolutePath: string,
  outputFormat: 'jupyter' | 'percent' | 'quarto' | 'marimo',
  customOutputPath: string | undefined,
  cwd: string
): Promise<string> {
  const formatNames = {
    jupyter: 'Jupyter Notebooks',
    percent: 'percent format files',
    quarto: 'Quarto documents',
    marimo: 'Marimo notebooks',
  }

  const spinner = ora(`Converting Deepnote project to ${formatNames[outputFormat]}...`).start()

  try {
    const ext = extname(absolutePath)
    const filenameWithoutExtension = basename(absolutePath, ext)
    const outputDirName = filenameWithoutExtension
    const outputDir = customOutputPath ? resolve(cwd, customOutputPath) : resolve(cwd, outputDirName)

    // Read the source file and try to merge with snapshot
    const sourceContent = await fs.readFile(absolutePath, 'utf-8')
    let deepnoteFile = deserializeDeepnoteFile(sourceContent)

    // Try to load and merge snapshot
    const nbId = resolveSnapshotNotebookId(deepnoteFile)
    const snapshot = await loadLatestSnapshot(absolutePath, deepnoteFile.project.id, nbId ? { notebookId: nbId } : {})
    if (snapshot) {
      deepnoteFile = mergeSnapshotIntoSource(deepnoteFile, snapshot, { skipMismatched: true })
    }

    // Write merged content to a unique temporary directory for the converters
    const tempDir = await fs.mkdtemp(resolve(dirname(absolutePath), '.deepnote-merge-'))
    const tempFilename = `${filenameWithoutExtension}.merged.deepnote`
    const tempPath = resolve(tempDir, tempFilename)

    try {
      const mergedYaml = serializeDeepnoteFile(deepnoteFile)
      await fs.writeFile(tempPath, mergedYaml, 'utf-8')

      switch (outputFormat) {
        case 'jupyter':
          await convertDeepnoteFileToJupyterFiles(tempPath, { outputDir })
          break
        case 'percent':
          await convertDeepnoteFileToPercentFiles(tempPath, { outputDir })
          break
        case 'quarto':
          await convertDeepnoteFileToQuartoFiles(tempPath, { outputDir })
          break
        case 'marimo':
          await convertDeepnoteFileToMarimoFiles(tempPath, { outputDir })
          break
      }
    } finally {
      // Clean up temp directory
      await fs.rm(tempDir, { recursive: true, force: true }).catch(() => {})