inspect - provide information about output files from input files

Author: cscheid

src/inspect/inspect-types.ts

@@ -4,7 +4,7 @@
  * Copyright (C) 2020-2022 Posit Software, PBC
  */
 
-import { Format } from "../config/types.ts";
+import { Format, FormatIdentifier } from "../config/types.ts";
 import { Extension } from "../extension/types.ts";
 import {
   FileInclusion,
@@ -25,6 +25,7 @@ export interface InspectedFile {
   includeMap: FileInclusion[];
   codeCells: InspectedMdCell[];
   metadata: Record<string, unknown>;
+  outputFiles: Record<string, FormatIdentifier>;
 }
 
 export interface InspectedConfig {

src/inspect/inspect.ts

@@ -49,6 +49,7 @@ import {
 import { validateDocumentFromSource } from "../core/schema/validate-document.ts";
 import { error } from "../deno_ral/log.ts";
 import { ProjectContext } from "../project/types.ts";
+import { resolveOutputFileNames } from "../project/project-index.ts";
 
 export function isProjectConfig(
   config: InspectedConfig,
@@ -90,6 +91,7 @@ const inspectProjectConfig = async (context: ProjectContext) => {
     return undefined;
   }
   const fileInformation: Record<string, InspectedFile> = {};
+  await resolveOutputFileNames(context);
   for (const file of context.files.input) {
     await populateFileInformation(context, fileInformation, file);
   }
@@ -144,6 +146,7 @@ const populateFileInformation = async (
       [],
     codeCells: context.fileInformationCache.get(file)?.codeCells ?? [],
     metadata: context.fileInformationCache.get(file)?.metadata ?? {},
+    outputFiles: context.fileInformationCache.get(file)?.outputFiles ?? {},
   };
 };
 
@@ -213,9 +216,11 @@ const inspectDocumentConfig = async (path: string) => {
       );
     }
 
+    path = normalizePath(path);
     await context.resolveFullMarkdownForFile(engine, path);
     await projectResolveCodeCellsForFile(context, engine, path);
     await projectFileMetadata(context, path);
+    await resolveOutputFileNames(context);
     const fileInformation = context.fileInformationCache.get(path);
 
     // data to write
@@ -231,6 +236,7 @@ const inspectDocumentConfig = async (path: string) => {
           includeMap: fileInformation?.includeMap ?? [],
           codeCells: fileInformation?.codeCells ?? [],
           metadata: fileInformation?.metadata ?? {},
+          outputFiles: fileInformation?.outputFiles ?? {},
         },
       },
     };

src/project/project-context.ts

@@ -274,6 +274,7 @@ export async function projectContext(
         });
         const fileInformationCache = new Map();
         const result: ProjectContext = {
+          clone: () => result,
           resolveBrand: async (fileName?: string) =>
             projectResolveBrand(result, fileName),
           resolveFullMarkdownForFile: (
@@ -370,6 +371,7 @@ export async function projectContext(
         });
         const fileInformationCache = new Map();
         const result: ProjectContext = {
+          clone: () => result,
           resolveBrand: async (fileName?: string) =>
             projectResolveBrand(result, fileName),
           resolveFullMarkdownForFile: (
@@ -445,6 +447,7 @@ export async function projectContext(
           });
           const fileInformationCache = new Map();
           const context: ProjectContext = {
+            clone: () => context,
             resolveBrand: async (fileName?: string) =>
               projectResolveBrand(context, fileName),
             resolveFullMarkdownForFile: (

src/project/project-index.ts

@@ -27,7 +27,11 @@ import {
 import { kTitle } from "../config/constants.ts";
 import { fileExecutionEngine } from "../execute/engine.ts";
 
-import { projectConfigFile, projectOutputDir } from "./project-shared.ts";
+import {
+  ensureFileInformationCache,
+  projectConfigFile,
+  projectOutputDir,
+} from "./project-shared.ts";
 import { projectScratchPath } from "./project-scratch.ts";
 import { parsePandocTitle } from "../core/pandoc/pandoc-partition.ts";
 import { readYamlFromString } from "../core/yaml.ts";
@@ -297,20 +301,13 @@ export async function resolveInputTarget(
   }
 }
 
-export async function inputFileForOutputFile(
+// populates the outputNameIndex field in the project context
+export async function resolveOutputFileNames(
   project: ProjectContext,
-  output: string,
-): Promise<{ file: string; format: Format } | undefined> {
-  // compute output dir
+): Promise<void> {
+  if (project.outputNameIndex) return;
   const outputDir = projectOutputDir(project);
 
-  // full path to output (it's relative to output dir)
-  output = isAbsolute(output) ? output : join(outputDir, output);
-
-  if (project.outputNameIndex !== undefined) {
-    return project.outputNameIndex.get(output);
-  }
-
   project.outputNameIndex = new Map();
   for (const file of project.files.input) {
     const inputRelative = relative(project.dir, file);
@@ -319,6 +316,8 @@ export async function inputFileForOutputFile(
       relative(project.dir, file),
     );
     if (index) {
+      const cache = ensureFileInformationCache(project, file);
+      cache.outputFiles = cache.outputFiles || {};
       Object.keys(index.formats).forEach((key) => {
         const format = index.formats[key];
         const outputFile = formatOutputFile(format);
@@ -329,11 +328,25 @@ export async function inputFileForOutputFile(
             outputFile,
           );
           project.outputNameIndex!.set(formatOutputPath, { file, format });
+          cache.outputFiles![formatOutputPath] = format.identifier;
         }
       });
     }
   }
-  return project.outputNameIndex.get(output);
+}
+
+export async function inputFileForOutputFile(
+  project: ProjectContext,
+  output: string,
+): Promise<{ file: string; format: Format } | undefined> {
+  // compute output dir
+  const outputDir = projectOutputDir(project);
+
+  // full path to output (it's relative to output dir)
+  output = isAbsolute(output) ? output : join(outputDir, output);
+
+  await resolveOutputFileNames(project);
+  return project.outputNameIndex?.get(output);
 }
 
 export async function inputTargetIndexForOutputFile(

src/project/types.ts

@@ -5,7 +5,7 @@
  */
 
 import { RenderServices } from "../command/render/types.ts";
-import { Metadata, PandocFlags } from "../config/types.ts";
+import { FormatIdentifier, Metadata, PandocFlags } from "../config/types.ts";
 import { Format, FormatExtras } from "../config/types.ts";
 import { Brand, LightDarkBrand } from "../core/brand/brand.ts";
 import { MappedString } from "../core/mapped-text.ts";
@@ -22,6 +22,7 @@ import {
 import { ProjectEnvironment } from "./project-environment-types.ts";
 import { ProjectCache } from "../core/cache/cache-types.ts";
 import { TempContext } from "../core/temp-types.ts";
+import { Cloneable } from "../core/safe-clone-deep.ts";
 
 export {
   type NavigationItem as NavItem,
@@ -56,9 +57,11 @@ export type FileInformation = {
   target?: ExecutionTarget;
   metadata?: Metadata;
   brand?: LightDarkBrand;
+  outputFiles?: Record<string, FormatIdentifier>;
 };
 
 export interface ProjectContext {
+  clone: () => ProjectContext;
   dir: string;
   engines: string[];
   files: ProjectFiles;

src/project/types/single-file/single-file.ts

@@ -40,11 +40,12 @@ export async function singleFileProjectContext(
   const projectCacheBaseDir = temp.createDir();
 
   const result: ProjectContext = {
+    clone: () => result,
     resolveBrand: (fileName?: string) => projectResolveBrand(result, fileName),
     dir: normalizePath(dirname(source)),
     engines: [],
     files: {
-      input: [],
+      input: [normalizePath(source)],
     },
     notebookContext,
     environment: () => environmentMemoizer(result),