Function runDjangoCollectStatic

packages/python/src/django.ts:80–216

(
  venvPath: string,
  workPath: string,
  env: NodeJS.ProcessEnv,
  outputStaticDir: string,
  settingsModule: string,
  djangoSettings: Record<string, unknown>,
  djangoVersion: DjangoVersion | null
)

 *   everything and return null.
 */
export async function runDjangoCollectStatic(
  venvPath: string,
  workPath: string,
  env: NodeJS.ProcessEnv,
  outputStaticDir: string,
  settingsModule: string,
  djangoSettings: Record<string, unknown>,
  djangoVersion: DjangoVersion | null
): Promise<DjangoCollectStaticResult | null> {
  const pythonPath = getVenvPythonBin(venvPath);

  // Resolve storage backend
  // First check STORAGES (Django 4.2+) then the legacy STATICFILES_STORAGE setting.
  // STATICFILES_STORAGE was removed in Django 5.1.
  const storages = djangoSettings['STORAGES'] as
    | { staticfiles?: { BACKEND?: string } }
    | undefined;
  const useLegacySetting =
    !djangoVersion ||
    djangoVersion[0] < 5 ||
    (djangoVersion[0] === 5 && djangoVersion[1] < 1);
  const legacyBackend = useLegacySetting
    ? (djangoSettings['STATICFILES_STORAGE'] as string | undefined)
    : undefined;
  const storageBackend: string =
    storages?.staticfiles?.BACKEND ??
    legacyBackend ??
    'django.contrib.staticfiles.storage.StaticFilesStorage';

  const staticUrl =
    (djangoSettings['STATIC_URL'] as string | undefined) ?? '/static/';
  const staticRoot =
    djangoSettings['STATIC_ROOT'] != null
      ? String(djangoSettings['STATIC_ROOT'])
      : null;
  const whitenoiseUseFinders =
    djangoSettings['WHITENOISE_USE_FINDERS'] === true;

  // Get the static file directories.
  // Each installed app may have a 'static' subdirectory.
  // STATICFILES_DIRS is an additional list of directories.
  const installedApps =
    (djangoSettings['INSTALLED_APPS'] as string[] | undefined) ?? [];
  const staticfilesDirs =
    (djangoSettings['STATICFILES_DIRS'] as
      | (string | [string, string])[]
      | undefined) ?? [];
  const staticSourceDirs = [
    ...installedApps.map(app => join(workPath, ...app.split('.'), 'static')),
    // TODO: Deal with optional prefixes in STATICFILES_DIRS.
    ...staticfilesDirs.map(d => (Array.isArray(d) ? d[1] : d)),
  ].filter(d => fs.existsSync(d));

  // When django-storages is the storage backend
  // Run collectstatic with the user's real settings, it will upload to S3/GCS/etc.
  // No CDN bundling or manifest work needed.
  if (storageBackend.startsWith('storages.backends.')) {
    console.log(