Function getPyprojectEntrypointWithDiagnostics

packages/python/src/entrypoint.ts:289–317

* Like getPyprojectScriptsEntrypoint but returns diagnostic metadata * (the raw script value and checked paths) so callers can produce * targeted error messages when resolution fails.

(
  workPath: string
)

 * targeted error messages when resolution fails.
 */
async function getPyprojectEntrypointWithDiagnostics(
  workPath: string
): Promise<PyprojectEntrypointResult> {
  const pyprojectData = await readConfigFile<{
    project?: { scripts?: Record<string, unknown> };
  }>(join(workPath, 'pyproject.toml'));
  if (!pyprojectData) return { entrypoint: null };

  const scripts = pyprojectData.project?.scripts as
    | Record<string, unknown>
    | undefined;
  const appScript = scripts?.app;
  if (typeof appScript !== 'string') return { entrypoint: null };

  // Expect values like "package.module:app". Extract the module portion.
  const match = appScript.match(/([A-Za-z_][\w.]*)\s*:\s*([A-Za-z_][\w]*)/);
  if (!match) return { entrypoint: null, appScript };
  const modulePath = match[1];
  const variableName = match[2];
  const relPath = modulePath.replace(/\./g, '/');

  const candidates = [`${relPath}.py`, `${relPath}/__init__.py`];
  for (const candidate of candidates) {
    if (await fileExists(join(workPath, candidate))) {
      return { entrypoint: { entrypoint: candidate, variableName } };
    }
  }
  return { entrypoint: null, appScript, checkedPaths: candidates };
}

async function findValidEntrypoint(
  workPath: string,