appdir.cc

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2023 Blender Authors
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */

 
#include <cstdio>
#include <cstdlib>
#include <cstring>
 
#include "BLI_fileops.h"
#include "BLI_fileops_types.h"
#include "BLI_listbase.h"
#include "BLI_path_utils.hh"
#include "BLI_string.h"
#include "BLI_string_utils.hh"
#include "BLI_tempfile.h"
#include "BLI_utildefines.h"
#include "BLI_vector.hh"
 
#include "BKE_appdir.hh" /* own include */
#include "BKE_blender_version.h"
 
#include "BLT_translation.hh"
 
#include "GHOST_Path-api.hh"
 
#include "CLG_log.h"
 
#ifdef WIN32
#  include "BLI_string_utf8.h"
#  include "utf_winfunc.hh"
#  include "utfconv.hh"
#  include <io.h>
#  ifdef _WIN32_IE
#    undef _WIN32_IE
#  endif
#  define _WIN32_IE 0x0501
#  include "BLI_winstuff.h"
#  include <shlobj.h>
#  include <windows.h>
#else /* non windows */
#  ifdef WITH_BINRELOC
#    include "binreloc.h"
#  endif
/* #mkdtemp on OSX (and probably all *BSD?), not worth making specific check for this OS. */
#  include <unistd.h>
#endif /* !WIN32 */
 
static const char _str_null[] = "(null)";
#define STR_OR_FALLBACK(a) ((a) ? (a) : _str_null)
 
/* -------------------------------------------------------------------- */
 
/* local */
static CLG_LogRef LOG = {"bke.appdir"};
 
static struct {
  char program_filepath[FILE_MAX];
  char program_dirname[FILE_MAX];
  char temp_dirname_base[FILE_MAX];
  char temp_dirname_session[FILE_MAX];
  bool temp_dirname_session_can_be_deleted;
} g_app{};

 
/* -------------------------------------------------------------------- */
 
#ifndef NDEBUG
static bool is_appdir_init = false;
#  define ASSERT_IS_INIT() BLI_assert(is_appdir_init)
#else
#  define ASSERT_IS_INIT() ((void)0)
#endif /* NDEBUG */
 
void BKE_appdir_init()
{
#ifndef NDEBUG
  BLI_assert(is_appdir_init == false);
  is_appdir_init = true;
#endif
}
 
void BKE_appdir_exit()
{
  /* System paths can be created on-demand by calls to this API. So they need to be properly
   * disposed of here. Note that there may be several calls to this in `exit` process
   * (e.g. `wm_init/wm_exit` will currently both call GHOST API directly,
   * & `BKE_appdir_init/_exit`). */
  GHOST_DisposeSystemPaths();
#ifndef NDEBUG
  BLI_assert(is_appdir_init == true);
  is_appdir_init = false;
#endif
}

 
/* -------------------------------------------------------------------- */

static char *blender_version_decimal(const int version)
{
  static char version_str[5];
  BLI_assert(version < 1000);
  SNPRINTF(version_str, "%d.%d", version / 100, version % 100);
  return version_str;
}

 
/* -------------------------------------------------------------------- */
 
const char *BKE_appdir_folder_default()
{
#ifndef WIN32
  return BLI_dir_home();
#else  /* Windows */
  static char documentfolder[FILE_MAXDIR];
 
  if (BKE_appdir_folder_documents(documentfolder)) {
    return documentfolder;
  }
 
  return nullptr;
#endif /* WIN32 */
}
 
const char *BKE_appdir_folder_root()
{
#ifndef WIN32
  return "/";
#else
  static char root[4];
  BLI_windows_get_default_root_dir(root);
  return root;
#endif
}
 
const char *BKE_appdir_folder_default_or_root()
{
  const char *path = BKE_appdir_folder_default();
  if (path == nullptr) {
    path = BKE_appdir_folder_root();
  }
  return path;
}
 
bool BKE_appdir_folder_documents(char *dir)
{
  dir[0] = '\0';
 
  const char *documents_path = GHOST_getUserSpecialDir(GHOST_kUserSpecialDirDocuments);
 
  /* Usual case: Ghost gave us the documents path. We're done here. */
  if (documents_path && BLI_is_dir(documents_path)) {
    BLI_strncpy(dir, documents_path, FILE_MAXDIR);
    return true;
  }
 
  /* Ghost couldn't give us a documents path, let's try if we can find it ourselves. */
 
  const char *home_path = BLI_dir_home();
  if (!home_path || !BLI_is_dir(home_path)) {
    return false;
  }
 
  char try_documents_path[FILE_MAXDIR];
  /* Own attempt at getting a valid Documents path. */
  BLI_path_join(try_documents_path, sizeof(try_documents_path), home_path, N_("Documents"));
  if (!BLI_is_dir(try_documents_path)) {
    return false;
  }
 
  BLI_strncpy(dir, try_documents_path, FILE_MAXDIR);
  return true;
}
 
bool BKE_appdir_folder_caches(char *path, const size_t path_maxncpy)
{
  path[0] = '\0';
 
  const char *caches_root_path = GHOST_getUserSpecialDir(GHOST_kUserSpecialDirCaches);
  if (caches_root_path == nullptr || !BLI_is_dir(caches_root_path)) {
    caches_root_path = BKE_tempdir_base();
  }
  if (caches_root_path == nullptr || !BLI_is_dir(caches_root_path)) {
    return false;
  }
 
#ifdef WIN32
  BLI_path_join(
      path, path_maxncpy, caches_root_path, "Blender Foundation", "Blender", "Cache", SEP_STR);
#elif defined(__APPLE__)
  BLI_path_join(path, path_maxncpy, caches_root_path, "Blender", SEP_STR);
#else /* __linux__ */
  BLI_path_join(path, path_maxncpy, caches_root_path, "blender", SEP_STR);
#endif
 
  return true;
}
 
bool BKE_appdir_font_folder_default(char *dir, size_t dir_maxncpy)
{
  char test_dir[FILE_MAXDIR];
  test_dir[0] = '\0';
 
#ifdef WIN32
  wchar_t wpath[MAX_PATH];
  if (SHGetSpecialFolderPathW(0, wpath, CSIDL_FONTS, 0)) {
    BLI_strncpy_wchar_as_utf8(test_dir, wpath, sizeof(test_dir));
  }
#elif defined(__APPLE__)
  if (const char *home_dir = BLI_dir_home()) {
    BLI_path_join(test_dir, sizeof(test_dir), home_dir, "Library/Fonts");
  }
#else
  STRNCPY(test_dir, "/usr/share/fonts");
#endif
 
  if (test_dir[0] && BLI_exists(test_dir)) {
    BLI_strncpy(dir, test_dir, dir_maxncpy);
    return true;
  }
  return false;
}

 
/* -------------------------------------------------------------------- */

static bool test_path(char *targetpath,
                      size_t targetpath_maxncpy,
                      const bool check_is_dir,
                      const char *path_base,
                      const char *folder_name,
                      const char *subfolder_name)
{
  ASSERT_IS_INIT();
 
  /* Only the last argument should be nullptr. */
  BLI_assert(!(folder_name == nullptr && (subfolder_name != nullptr)));
  const char *path_array[] = {path_base, folder_name, subfolder_name};
  const int path_array_num = (folder_name ? (subfolder_name ? 3 : 2) : 1);
  BLI_path_join_array(targetpath, targetpath_maxncpy, path_array, path_array_num);
  if (check_is_dir == false) {
    CLOG_INFO(&LOG, 3, "using without test: '%s'", targetpath);
    return true;
  }
 
  if (BLI_is_dir(targetpath)) {
    CLOG_INFO(&LOG, 3, "found '%s'", targetpath);
    return true;
  }
 
  CLOG_INFO(&LOG, 3, "missing '%s'", targetpath);
 
  /* Path not found, don't accidentally use it,
   * otherwise call this function with `check_is_dir` set to false. */
  targetpath[0] = '\0';
  return false;
}

static bool test_env_path(char *path, const char *envvar, const bool check_is_dir)
{
  ASSERT_IS_INIT();
 
  const char *env_path = envvar ? BLI_getenv(envvar) : nullptr;
  if (!env_path) {
    return false;
  }
 
  BLI_strncpy(path, env_path, FILE_MAX);
 
  if (check_is_dir == false) {
    CLOG_INFO(&LOG, 3, "using env '%s' without test: '%s'", envvar, env_path);
    return true;
  }
 
  if (BLI_is_dir(env_path)) {
    CLOG_INFO(&LOG, 3, "env '%s' found: %s", envvar, env_path);
    return true;
  }
 
  CLOG_INFO(&LOG, 3, "env '%s' missing: %s", envvar, env_path);
 
  /* Path not found, don't accidentally use it,
   * otherwise call this function with `check_is_dir` set to false. */
  path[0] = '\0';
  return false;
}

static bool get_path_local_ex(char *targetpath,
                              size_t targetpath_maxncpy,
                              const char *folder_name,
                              const char *subfolder_name,
                              const int version,
                              const bool check_is_dir)
{
  char relfolder[FILE_MAX];
 
  CLOG_INFO(&LOG,
            3,
            "folder='%s', subfolder='%s'",
            STR_OR_FALLBACK(folder_name),
            STR_OR_FALLBACK(subfolder_name));
 
  if (folder_name) { /* `subfolder_name` may be nullptr. */
    const char *path_array[] = {folder_name, subfolder_name};
    const int path_array_num = subfolder_name ? 2 : 1;
    BLI_path_join_array(relfolder, sizeof(relfolder), path_array, path_array_num);
  }
  else {
    relfolder[0] = '\0';
  }
 
  /* Try `{g_app.program_dirname}/3.xx/{folder_name}` the default directory
   * for a portable distribution. See `WITH_INSTALL_PORTABLE` build-option. */
  const char *path_base = g_app.program_dirname;
#if defined(__APPLE__) && !defined(WITH_PYTHON_MODULE)
  /* Due new code-sign situation in OSX > 10.9.5
   * we must move the blender_version dir with contents to Resources.
   * Add 4 + 9 for the temporary `/../` path & `Resources`. */
  char osx_resourses[FILE_MAX + 4 + 9];
  BLI_path_join(osx_resourses, sizeof(osx_resourses), g_app.program_dirname, "..", "Resources");
  /* Remove the '/../' added above. */
  BLI_path_normalize_native(osx_resourses);
  path_base = osx_resourses;
#endif
  return test_path(targetpath,
                   targetpath_maxncpy,
                   check_is_dir,
                   path_base,
                   (version) ? blender_version_decimal(version) : relfolder,
                   (version) ? relfolder : nullptr);
}
static bool get_path_local(char *targetpath,
                           size_t targetpath_maxncpy,
                           const char *folder_name,
                           const char *subfolder_name)
{
  const int version = BLENDER_VERSION;
  const bool check_is_dir = true;
  return get_path_local_ex(
      targetpath, targetpath_maxncpy, folder_name, subfolder_name, version, check_is_dir);
}

static bool get_path_environment_ex(char *targetpath,
                                    size_t targetpath_maxncpy,
                                    const char *subfolder_name,
                                    const char *envvar,
                                    const bool check_is_dir)
{
  char user_path[FILE_MAX];
 
  if (test_env_path(user_path, envvar, check_is_dir)) {
    /* Note that `subfolder_name` may be nullptr, in this case we use `user_path` as-is. */
    return test_path(
        targetpath, targetpath_maxncpy, check_is_dir, user_path, subfolder_name, nullptr);
  }
  return false;
}
static bool get_path_environment(char *targetpath,
                                 size_t targetpath_maxncpy,
                                 const char *subfolder_name,
                                 const char *envvar)
{
  const bool check_is_dir = true;
  return get_path_environment_ex(
      targetpath, targetpath_maxncpy, subfolder_name, envvar, check_is_dir);
}
 
static blender::Vector<std::string> get_path_environment_multiple(const char *subfolder_name,
                                                                  const char *envvar,
                                                                  const bool check_is_dir)
{
  blender::Vector<std::string> paths;
  const char *env_path = envvar ? BLI_getenv(envvar) : nullptr;
  if (!env_path) {
    return paths;
  }
 
#ifdef _WIN32
  const char separator = ';';
#else
  const char separator = ':';
#endif
 
  const char *char_begin = env_path;
  const char *char_end = BLI_strchr_or_end(char_begin, separator);
  while (char_begin[0]) {
    const size_t base_path_len = char_end - char_begin;
    if (base_path_len > 0 && base_path_len < PATH_MAX) {
      char base_path[PATH_MAX];
      memcpy(base_path, char_begin, base_path_len);
      base_path[base_path_len] = '\0';
 
      char path[PATH_MAX];
      if (test_path(path, sizeof(path), check_is_dir, base_path, subfolder_name, nullptr)) {
        paths.append(path);
      }
    }
    char_begin = char_end[0] ? char_end + 1 : char_end;
    char_end = BLI_strchr_or_end(char_begin, separator);
  }
 
  return paths;
}

static bool get_path_user_ex(char *targetpath,
                             size_t targetpath_maxncpy,
                             const char *folder_name,
                             const char *subfolder_name,
                             const int version,
                             const bool check_is_dir)
{
  char user_path[FILE_MAX];
 
  /* Environment variable override. */
  if (test_env_path(user_path, "BLENDER_USER_RESOURCES", check_is_dir)) {
    /* Pass. */
  }
  /* Portable install, to store user files next to Blender executable. */
  else if (get_path_local_ex(user_path, sizeof(user_path), "portable", nullptr, 0, true)) {
    /* Pass. */
  }
  else {
    user_path[0] = '\0';
 
    const char *user_base_path = GHOST_getUserDir(version, blender_version_decimal(version));
    if (user_base_path) {
      STRNCPY(user_path, user_base_path);
    }
  }
 
  if (!user_path[0]) {
    return false;
  }
 
  CLOG_INFO(&LOG,
            3,
            "'%s', folder='%s', subfolder='%s'",
            user_path,
            STR_OR_FALLBACK(folder_name),
            STR_OR_FALLBACK(subfolder_name));
 
  /* `subfolder_name` may be nullptr. */
  return test_path(
      targetpath, targetpath_maxncpy, check_is_dir, user_path, folder_name, subfolder_name);
}
static bool get_path_user(char *targetpath,
                          size_t targetpath_maxncpy,
                          const char *folder_name,
                          const char *subfolder_name)
{
  const int version = BLENDER_VERSION;
  const bool check_is_dir = true;
  return get_path_user_ex(
      targetpath, targetpath_maxncpy, folder_name, subfolder_name, version, check_is_dir);
}

static bool get_path_system_ex(char *targetpath,
                               size_t targetpath_maxncpy,
                               const char *folder_name,
                               const char *subfolder_name,
                               const int version,
                               const bool check_is_dir)
{
  char system_path[FILE_MAX];
 
  if (test_env_path(system_path, "BLENDER_SYSTEM_RESOURCES", check_is_dir)) {
    /* Pass. */
  }
  else {
    system_path[0] = '\0';
    const char *system_base_path = GHOST_getSystemDir(version, blender_version_decimal(version));
    if (system_base_path) {
      STRNCPY(system_path, system_base_path);
    }
  }
 
  if (!system_path[0]) {
    return false;
  }
 
  CLOG_INFO(&LOG,
            3,
            "'%s', folder='%s', subfolder='%s'",
            system_path,
            STR_OR_FALLBACK(folder_name),
            STR_OR_FALLBACK(subfolder_name));
 
  /* Try `$BLENDERPATH/folder_name/subfolder_name`, `subfolder_name` may be nullptr. */
  return test_path(
      targetpath, targetpath_maxncpy, check_is_dir, system_path, folder_name, subfolder_name);
}
 
static bool get_path_system(char *targetpath,
                            size_t targetpath_maxncpy,
                            const char *folder_name,
                            const char *subfolder_name)
{
  const int version = BLENDER_VERSION;
  const bool check_is_dir = true;
  return get_path_system_ex(
      targetpath, targetpath_maxncpy, folder_name, subfolder_name, version, check_is_dir);
}

 
/* -------------------------------------------------------------------- */
 
bool BKE_appdir_folder_id_ex(const int folder_id,
                             const char *subfolder,
                             char *path,
                             size_t path_maxncpy)
{
  switch (folder_id) {
    case BLENDER_DATAFILES: /* general case */
      if (get_path_environment(path, path_maxncpy, subfolder, "BLENDER_USER_DATAFILES")) {
        break;
      }
      if (get_path_user(path, path_maxncpy, "datafiles", subfolder)) {
        break;
      }
      if (get_path_environment(path, path_maxncpy, subfolder, "BLENDER_SYSTEM_DATAFILES")) {
        break;
      }
      if (get_path_system(path, path_maxncpy, "datafiles", subfolder)) {
        break;
      }
      if (get_path_local(path, path_maxncpy, "datafiles", subfolder)) {
        break;
      }
      return false;
 
    case BLENDER_USER_DATAFILES:
      if (get_path_environment(path, path_maxncpy, subfolder, "BLENDER_USER_DATAFILES")) {
        break;
      }
      if (get_path_user(path, path_maxncpy, "datafiles", subfolder)) {
        break;
      }
      return false;
 
    case BLENDER_SYSTEM_DATAFILES:
      if (get_path_environment(path, path_maxncpy, subfolder, "BLENDER_SYSTEM_DATAFILES")) {
        break;
      }
      if (get_path_system(path, path_maxncpy, "datafiles", subfolder)) {
        break;
      }
      if (get_path_local(path, path_maxncpy, "datafiles", subfolder)) {
        break;
      }
      return false;
 
    case BLENDER_USER_CONFIG:
      if (get_path_environment(path, path_maxncpy, subfolder, "BLENDER_USER_CONFIG")) {
        break;
      }
      if (get_path_user(path, path_maxncpy, "config", subfolder)) {
        break;
      }
      return false;
 
    case BLENDER_USER_SCRIPTS:
      if (get_path_environment(path, path_maxncpy, subfolder, "BLENDER_USER_SCRIPTS")) {
        break;
      }
      if (get_path_user(path, path_maxncpy, "scripts", subfolder)) {
        break;
      }
      return false;
 
    case BLENDER_SYSTEM_SCRIPTS:
      if (get_path_system(path, path_maxncpy, "scripts", subfolder)) {
        break;
      }
      if (get_path_local(path, path_maxncpy, "scripts", subfolder)) {
        break;
      }
      return false;
 
    case BLENDER_USER_EXTENSIONS:
      if (get_path_environment(path, path_maxncpy, subfolder, "BLENDER_USER_EXTENSIONS")) {
        break;
      }
      if (get_path_user(path, path_maxncpy, "extensions", subfolder)) {
        break;
      }
      return false;
 
    case BLENDER_SYSTEM_EXTENSIONS:
      if (get_path_environment(path, path_maxncpy, subfolder, "BLENDER_SYSTEM_EXTENSIONS")) {
        break;
      }
      if (get_path_system(path, path_maxncpy, "extensions", subfolder)) {
        break;
      }
      if (get_path_local(path, path_maxncpy, "extensions", subfolder)) {
        break;
      }
      return false;
 
    case BLENDER_SYSTEM_PYTHON:
      if (get_path_environment(path, path_maxncpy, subfolder, "BLENDER_SYSTEM_PYTHON")) {
        break;
      }
      if (get_path_system(path, path_maxncpy, "python", subfolder)) {
        break;
      }
      if (get_path_local(path, path_maxncpy, "python", subfolder)) {
        break;
      }
      return false;
 
    default:
      BLI_assert_unreachable();
      break;
  }
 
  return true;
}
 
std::optional<std::string> BKE_appdir_folder_id(const int folder_id, const char *subfolder)
{
  char path[FILE_MAX] = "";
  if (BKE_appdir_folder_id_ex(folder_id, subfolder, path, sizeof(path))) {
    return path;
  }
  return std::nullopt;
}
 
std::optional<std::string> BKE_appdir_folder_id_user_notest(const int folder_id,
                                                            const char *subfolder)
{
  const int version = BLENDER_VERSION;
  char path[FILE_MAX] = "";
  const bool check_is_dir = false;
 
  switch (folder_id) {
    case BLENDER_USER_DATAFILES:
      if (get_path_environment_ex(
              path, sizeof(path), subfolder, "BLENDER_USER_DATAFILES", check_is_dir))
      {
        break;
      }
      get_path_user_ex(path, sizeof(path), "datafiles", subfolder, version, check_is_dir);
      break;
    case BLENDER_USER_CONFIG:
      if (get_path_environment_ex(
              path, sizeof(path), subfolder, "BLENDER_USER_CONFIG", check_is_dir))
      {
        break;
      }
      get_path_user_ex(path, sizeof(path), "config", subfolder, version, check_is_dir);
      break;
    case BLENDER_USER_SCRIPTS:
      if (get_path_environment_ex(
              path, sizeof(path), subfolder, "BLENDER_USER_SCRIPTS", check_is_dir))
      {
        break;
      }
      get_path_user_ex(path, sizeof(path), "scripts", subfolder, version, check_is_dir);
      break;
    case BLENDER_USER_EXTENSIONS:
      if (get_path_environment_ex(
              path, sizeof(path), subfolder, "BLENDER_USER_EXTENSIONS", check_is_dir))
      {
        break;
      }
      get_path_user_ex(path, sizeof(path), "extensions", subfolder, version, check_is_dir);
      break;
    default:
      BLI_assert_unreachable();
      break;
  }
 
  if ('\0' == path[0]) {
    return std::nullopt;
  }
  return path;
}
 
std::optional<std::string> BKE_appdir_folder_id_create(const int folder_id, const char *subfolder)
{
  /* Only for user folders. */
  if (!ELEM(folder_id,
            BLENDER_USER_DATAFILES,
            BLENDER_USER_CONFIG,
            BLENDER_USER_SCRIPTS,
            BLENDER_USER_EXTENSIONS))
  {
    BLI_assert_unreachable();
    return std::nullopt;
  }
 
  std::optional<std::string> path = BKE_appdir_folder_id(folder_id, subfolder);
 
  if (!path.has_value()) {
    path = BKE_appdir_folder_id_user_notest(folder_id, subfolder);
    if (path.has_value()) {
      BLI_dir_create_recursive(path->c_str());
    }
  }
 
  return path;
}
 
std::optional<std::string> BKE_appdir_resource_path_id_with_version(const int folder_id,
                                                                    const bool check_is_dir,
                                                                    const int version)
{
  char path[FILE_MAX] = "";
  bool ok;
  switch (folder_id) {
    case BLENDER_RESOURCE_PATH_USER:
      ok = get_path_user_ex(path, sizeof(path), nullptr, nullptr, version, check_is_dir);
      break;
    case BLENDER_RESOURCE_PATH_LOCAL:
      ok = get_path_local_ex(path, sizeof(path), nullptr, nullptr, version, check_is_dir);
      break;
    case BLENDER_RESOURCE_PATH_SYSTEM:
      ok = get_path_system_ex(path, sizeof(path), nullptr, nullptr, version, check_is_dir);
      break;
    default:
      path[0] = '\0'; /* in case check_is_dir is false */
      ok = false;
      BLI_assert_msg(0, "incorrect ID");
      break;
  }
  if (!ok) {
    return std::nullopt;
  }
  return path;
}
 
std::optional<std::string> BKE_appdir_resource_path_id(const int folder_id,
                                                       const bool check_is_dir)
{
  return BKE_appdir_resource_path_id_with_version(folder_id, check_is_dir, BLENDER_VERSION);
}

 
/* -------------------------------------------------------------------- */
 
#ifndef WITH_PYTHON_MODULE
static void where_am_i(char *program_filepath,
                       const size_t program_filepath_maxncpy,
                       const char *program_name)
{
#  ifdef WITH_BINRELOC
  /* Linux uses `binreloc` since `argv[0]` is not reliable, call `br_init(nullptr)` first. */
  {
    const char *path = nullptr;
    path = br_find_exe(nullptr);
    if (path) {
      BLI_strncpy(program_filepath, path, program_filepath_maxncpy);
      free((void *)path);
      return;
    }
  }
#  endif
 
#  ifdef _WIN32
  {
    wchar_t *fullname_16 = MEM_malloc_arrayN<wchar_t>(program_filepath_maxncpy, "ProgramPath");
    if (GetModuleFileNameW(0, fullname_16, program_filepath_maxncpy)) {
      conv_utf_16_to_8(fullname_16, program_filepath, program_filepath_maxncpy);
      if (!BLI_exists(program_filepath)) {
        CLOG_ERROR(&LOG,
                   "path can't be found: \"%.*s\"",
                   int(program_filepath_maxncpy),
                   program_filepath);
        MessageBox(nullptr,
                   "path contains invalid characters or is too long (see console)",
                   "Error",
                   MB_OK);
      }
      MEM_freeN(fullname_16);
      return;
    }
 
    MEM_freeN(fullname_16);
  }
#  endif
 
  /* Unix and non Linux. */
  if (program_name && program_name[0]) {
 
    BLI_strncpy(program_filepath, program_name, program_filepath_maxncpy);
    if (program_name[0] == '.') {
      BLI_path_abs_from_cwd(program_filepath, program_filepath_maxncpy);
#  ifdef _WIN32
      BLI_path_program_extensions_add_win32(program_filepath, program_filepath_maxncpy);
#  endif
    }
    else if (BLI_path_slash_rfind(program_name)) {
      /* Full path. */
      BLI_strncpy(program_filepath, program_name, program_filepath_maxncpy);
#  ifdef _WIN32
      BLI_path_program_extensions_add_win32(program_filepath, program_filepath_maxncpy);
#  endif
    }
    else {
      BLI_path_program_search(program_filepath, program_filepath_maxncpy, program_name);
    }
    /* Remove "/./" and "/../" so string comparisons can be used on the path. */
    BLI_path_normalize_native(program_filepath);
 
#  ifndef NDEBUG
    if (!STREQ(program_name, program_filepath)) {
      CLOG_INFO(&LOG, 2, "guessing '%s' == '%s'", program_name, program_filepath);
    }
#  endif
  }
}
#endif /* WITH_PYTHON_MODULE */
 
void BKE_appdir_program_path_init(const char *argv0)
{
#ifdef WITH_PYTHON_MODULE
  /* NOTE(@ideasman42): Always use `argv[0]` as is, when building as a Python module.
   * Otherwise other methods of detecting the binary that override this argument
   * which must point to the Python module for data-files to be detected. */
  STRNCPY(g_app.program_filepath, argv0);
  BLI_path_canonicalize_native(g_app.program_filepath, sizeof(g_app.program_filepath));
 
  if (g_app.program_dirname[0] == '\0') {
    /* First time initializing, the file binary path isn't valid from a Python module.
     * Calling again must set the `filepath` and leave the directory as-is. */
    BLI_path_split_dir_part(
        g_app.program_filepath, g_app.program_dirname, sizeof(g_app.program_dirname));
    g_app.program_filepath[0] = '\0';
  }
#else
  where_am_i(g_app.program_filepath, sizeof(g_app.program_filepath), argv0);
  BLI_path_split_dir_part(
      g_app.program_filepath, g_app.program_dirname, sizeof(g_app.program_dirname));
#endif
}
 
const char *BKE_appdir_program_path()
{
#ifndef WITH_PYTHON_MODULE /* Default's to empty when building as a Python module. */
  BLI_assert(g_app.program_filepath[0]);
#endif
  return g_app.program_filepath;
}
 
const char *BKE_appdir_program_dir()
{
  BLI_assert(g_app.program_dirname[0]);
  return g_app.program_dirname;
}
 
bool BKE_appdir_program_python_search(char *program_filepath,
                                      const size_t program_filepath_maxncpy,
                                      const int version_major,
                                      const int version_minor)
{
  ASSERT_IS_INIT();
 
#ifdef PYTHON_EXECUTABLE_NAME
  /* Passed in from the build-systems 'PYTHON_EXECUTABLE'. */
  const char *python_build_def = STRINGIFY(PYTHON_EXECUTABLE_NAME);
#endif
  const char *basename = "python";
#if defined(WIN32) && !defined(NDEBUG)
  const char *basename_debug = "python_d";
#endif
  char python_version[16];
  /* Check both possible names. */
  const char *python_names[] = {
#ifdef PYTHON_EXECUTABLE_NAME
    python_build_def,
#endif
#if defined(WIN32) && !defined(NDEBUG)
    basename_debug,
#endif
    python_version,
    basename,
  };
  bool is_found = false;
 
  SNPRINTF(python_version, "%s%d.%d", basename, version_major, version_minor);
 
  {
    const std::optional<std::string> python_bin_dir = BKE_appdir_folder_id(BLENDER_SYSTEM_PYTHON,
                                                                           "bin");
    if (python_bin_dir.has_value()) {
 
      for (int i = 0; i < ARRAY_SIZE(python_names); i++) {
        BLI_path_join(
            program_filepath, program_filepath_maxncpy, python_bin_dir->c_str(), python_names[i]);
 
        if (
#ifdef _WIN32
            BLI_path_program_extensions_add_win32(program_filepath, program_filepath_maxncpy)
#else
            BLI_exists(program_filepath)
#endif
        )
        {
          is_found = true;
          break;
        }
      }
    }
  }
 
  if (is_found == false) {
    for (int i = 0; i < ARRAY_SIZE(python_names); i++) {
      if (BLI_path_program_search(program_filepath, program_filepath_maxncpy, python_names[i])) {
        is_found = true;
        break;
      }
    }
  }
 
  if (is_found == false) {
    *program_filepath = '\0';
  }
 
  return is_found;
}

 
/* -------------------------------------------------------------------- */
 
static blender::Vector<std::string> appdir_app_template_directories()
{
  blender::Vector<std::string> directories;

  char temp_dir[FILE_MAX];
  if (BKE_appdir_folder_id_ex(BLENDER_USER_SCRIPTS,
                              "startup" SEP_STR "bl_app_templates_user",
                              temp_dir,
                              sizeof(temp_dir)))
  {
    directories.append(temp_dir);
  }
 
  /* Environment variable. */
  directories.extend(get_path_environment_multiple(
      "startup" SEP_STR "bl_app_templates_system", "BLENDER_SYSTEM_SCRIPTS", true));
 
  /* Local or system directory. */
  if (BKE_appdir_folder_id_ex(BLENDER_SYSTEM_SCRIPTS,
                              "startup" SEP_STR "bl_app_templates_system",
                              temp_dir,
                              sizeof(temp_dir)))
  {
    directories.append(temp_dir);
  }
 
  return directories;
}
 
bool BKE_appdir_app_template_any()
{
  return !appdir_app_template_directories().is_empty();
}
 
bool BKE_appdir_app_template_id_search(const char *app_template, char *path, size_t path_maxncpy)
{
  const blender::Vector<std::string> directories = appdir_app_template_directories();
 
  for (const std::string &directory : directories) {
    BLI_path_join(path, path_maxncpy, directory.c_str(), app_template);
    if (BLI_is_dir(path)) {
      return true;
    }
  }
 
  return false;
}
 
bool BKE_appdir_app_template_has_userpref(const char *app_template)
{
  /* Test if app template provides a `userpref.blend`.
   * If not, we will share user preferences with the rest of Blender. */
  if (app_template[0] == '\0') {
    return false;
  }
 
  char app_template_path[FILE_MAX];
  if (!BKE_appdir_app_template_id_search(
          app_template, app_template_path, sizeof(app_template_path)))
  {
    return false;
  }
 
  char userpref_path[FILE_MAX];
  BLI_path_join(userpref_path, sizeof(userpref_path), app_template_path, BLENDER_USERPREF_FILE);
  return BLI_exists(userpref_path);
}
 
void BKE_appdir_app_templates(ListBase *templates)
{
  BLI_listbase_clear(templates);
 
  const blender::Vector<std::string> directories = appdir_app_template_directories();
 
  for (const std::string &subdir : directories) {
    direntry *dirs;
    const uint dir_num = BLI_filelist_dir_contents(subdir.c_str(), &dirs);
    for (int f = 0; f < dir_num; f++) {
      if (!FILENAME_IS_CURRPAR(dirs[f].relname) && S_ISDIR(dirs[f].type)) {
        char *app_template = BLI_strdup(dirs[f].relname);
        BLI_addtail(templates, BLI_genericNodeN(app_template));
      }
    }
 
    BLI_filelist_free(dirs, dir_num);
  }
}

 
/* -------------------------------------------------------------------- */

static bool where_is_temp(char *tempdir, const size_t tempdir_maxncpy, const char *userdir)
{
  if (userdir && BLI_temp_directory_path_copy_if_valid(tempdir, tempdir_maxncpy, userdir)) {
    return true;
  }
  BLI_temp_directory_path_get(tempdir, tempdir_maxncpy);
  return false;
}
 
static bool tempdir_session_create(char *tempdir_session,
                                   const size_t tempdir_session_maxncpy,
                                   const char *tempdir)
{
  tempdir_session[0] = '\0';
 
  const int tempdir_len = strlen(tempdir);
  /* 'XXXXXX' is kind of tag to be replaced by `mktemp-family` by an UUID. */
  const char *session_name = "blender_XXXXXX";
  const int session_name_len = strlen(session_name);
 
  /* +1 as a slash is added,
   * #_mktemp_s also requires the last null character is included. */
  const int tempdir_session_len_required = tempdir_len + session_name_len + 1;
 
  if (tempdir_session_len_required <= tempdir_session_maxncpy) {
    /* No need to use path joining utility as we know the last character of #tempdir is a slash. */
    BLI_string_join(tempdir_session, tempdir_session_maxncpy, tempdir, session_name);
#ifdef WIN32
    const bool needs_create = (_mktemp_s(tempdir_session, tempdir_session_len_required) == 0);
#else
    const bool needs_create = (mkdtemp(tempdir_session) == nullptr);
#endif
    if (needs_create) {
      BLI_dir_create_recursive(tempdir_session);
    }
    if (BLI_is_dir(tempdir_session)) {
      BLI_path_slash_ensure(tempdir_session, tempdir_session_maxncpy);
      /* Success. */
      return true;
    }
  }
 
  CLOG_WARN(&LOG, "Could not generate a temp file name for '%s'", tempdir_session);
  return false;
}
 
void BKE_tempdir_init(const char *userdir)
{
  /* Sets #g_app.temp_dirname_base to `userdir` if specified and is a valid directory,
   * otherwise chooses a suitable OS-specific temporary directory.
   * Sets #g_app.temp_dirname_session to a #mkdtemp
   * generated sub-dir of #g_app.temp_dirname_base. */
 
  /* Clear existing temp dir, if needed. */
  BKE_tempdir_session_purge();
 
  /* Perform two passes, the first pass for the user preference path,
   * then a second pass if the the preferences failed to create the *session* sub-directory.
   *
   * This avoid problems if the preferences points to a path without write access,
   * `C:\` or `/` for example. */
  g_app.temp_dirname_session_can_be_deleted = false;
  for (int pass = 0; pass < 2; pass += 1) {
    const bool from_userdir = where_is_temp(
        g_app.temp_dirname_base, sizeof(g_app.temp_dirname_base), pass == 0 ? userdir : nullptr);
 
    /* Now that we have a valid temp dir, add system-generated unique sub-dir. */
    if (tempdir_session_create(g_app.temp_dirname_session,
                               sizeof(g_app.temp_dirname_session),
                               g_app.temp_dirname_base))
    {
      /* Created the session sub-directory. */
      g_app.temp_dirname_session_can_be_deleted = true;
      break;
    }
 
    /* Only perform the second pass if the `userdir` was used
     * and failed to created the sub-directory. */
    if (from_userdir == false) {
      break;
    }
  }
 
  if (UNLIKELY(g_app.temp_dirname_session_can_be_deleted == false)) {
    /* This should practically never happen as either the preferences or the systems
     * default temporary directory should be usable, if not, use the base directory and warn. */
    STRNCPY(g_app.temp_dirname_session, g_app.temp_dirname_base);
    CLOG_WARN(&LOG,
              "Could not generate a temp session subdirectory, falling back to '%s'",
              g_app.temp_dirname_base);
  }
}
 
const char *BKE_tempdir_session()
{
  return g_app.temp_dirname_session[0] ? g_app.temp_dirname_session : BKE_tempdir_base();
}
 
const char *BKE_tempdir_base()
{
  return g_app.temp_dirname_base;
}
 
void BKE_tempdir_session_purge()
{
  if (g_app.temp_dirname_session_can_be_deleted == false) {
    /* It's possible this path references an arbitrary location
     * in that case *never* recursively remove, see: #139585. */
    return;
  }
  if (g_app.temp_dirname_session[0] && BLI_is_dir(g_app.temp_dirname_session)) {
    BLI_delete(g_app.temp_dirname_session, true, true);
  }
}