Function detectDjangoPythonEntrypoint

packages/python/src/entrypoint.ts:446–487

(workPath: string)

 * DJANGO_SETTINGS_MODULE, then fall back to AST-based detection if needed.
 */
export async function detectDjangoPythonEntrypoint(workPath: string): Promise<{
  detected: DetectedPythonEntrypoint | null;
  findDiagnostics: FindResult;
}> {
  const emptyResult = {
    detected: null,
    findDiagnostics: {
      entrypoint: null,
      existingWithoutEntrypoint: [],
    } as FindResult,
  };
  try {
    // Get root directories (workPath root + immediate subdirs)
    const subdirs = await getSubdirectories(workPath);
    const rootDirs = ['', ...subdirs];

    // Look for a Django manage.py in workPath and immediate subdirectories.
    for (const rootDir of rootDirs) {
      const currPath = join(workPath, rootDir);
      const isDjango = await checkDjangoManage(currPath);
      if (isDjango) {
        // Defer to the Django framework hook for entrypoint resolution.
        return {
          detected: { baseDir: rootDir },
          findDiagnostics: { entrypoint: null, existingWithoutEntrypoint: [] },
        };
      }
    }

    // Fall back to AST-based detection,
    // Look in all immediate subdirectories, not just those specified in PYTHON_ENTRYPOINT_DIRS.
    const candidates = getCandidateEntrypointsInDirs(rootDirs);
    const result = await findValidEntrypoint(workPath, candidates);
    return {
      detected: result.entrypoint ? { entrypoint: result.entrypoint } : null,
      findDiagnostics: result,
    };
  } catch {
    debug('Failed to discover Django Python entrypoint');
    return emptyResult;
  }
}

/**
 * Detect a Python entrypoint path for a given framework relative to workPath, or return null if not found.