Function convertDirectory

packages/convert/src/cli.ts:230–266

* Converts every notebook in a directory to its own single-notebook `.deepnote` file — * one file per source notebook (the recommended layout). * * All notebooks are converted together as ONE project, so every output file shares the same * `project.id`, name, settings, and integrations; each is

(options: ConvertDirectoryOptions)

 * directory name). The output directory defaults to the input directory; the directory is returned.
 */
async function convertDirectory(options: ConvertDirectoryOptions): Promise<string> {
  const { dirPath, files, format, customOutputPath, cwd, customProjectName, singleFile } = options

  const outputDir = customOutputPath ? resolve(cwd, customOutputPath) : dirPath
  await fs.mkdir(outputDir, { recursive: true })

  const projectName = customProjectName ?? basename(dirPath)
  const plural = files.length === 1 ? '' : 's'
  const spinner = ora(
    `Converting ${files.length} ${DIRECTORY_FORMAT_NAMES[format]}${plural} to Deepnote files...`
  ).start()

  const projectId = randomUUID()

  try {
    const createdFiles: string[] = []
    for (const file of files) {
      const inputFilePath = resolve(dirPath, file)
      const outputName = basename(file, extname(file))
      const outputPath = resolve(outputDir, `${outputName}.deepnote`)
      // Same projectId across every file ⇒ all outputs belong to one project.
      const deepnoteFile = await readAndConvertOne(format, inputFilePath, { projectName, projectId })
      // writeDeepnoteFile handles snapshot splitting in memory.
      await writeDeepnoteFile({ file: deepnoteFile, outputPath, projectName, singleFile })
      createdFiles.push(outputPath)
    }

    spinner.succeed(
      `${createdFiles.length} Deepnote file${createdFiles.length === 1 ? '' : 's'} saved to ${chalk.bold(outputDir)}`
    )

    return outputDir
  } catch (error) {
    spinner.fail('Conversion failed')
    throw error
  }
}

interface ConvertSingleFileOptions {
  absolutePath: string