io_utils.h

// SPDX-FileCopyrightText: © 2018-2026 Alexandros Theodotou <alex@zrythm.org>
// SPDX-License-Identifier: LicenseRef-ZrythmLicense
 
#pragma once
 
#include "zrythm-config.h"
 
#include <filesystem>
#include <optional>
 
#include "utils/utf8_string.h"
 
#include <QTemporaryDir>
#include <QTemporaryFile>
 
namespace zrythm::utils::io
{
namespace fs = std::filesystem;

utils::Utf8String
get_path_separator_string ();

std::filesystem::path
get_home_path ();
 
std::filesystem::path
get_temp_path ();

std::filesystem::path
get_dir (const std::filesystem::path &filename);

void
mkdir (const std::filesystem::path &dir);

bool
touch_file (const std::filesystem::path &file_path);
 
std::filesystem::path
uri_to_file (const utils::Utf8String &uri);

std::filesystem::path
file_strip_ext (const std::filesystem::path &filename);

std::filesystem::path
file_get_ext (const std::filesystem::path &file);

std::filesystem::path
path_get_basename (const std::filesystem::path &filename);

std::filesystem::path
path_get_basename_without_ext (const std::filesystem::path &filename);

qint64
file_get_last_modified_datetime (const std::filesystem::path &filename);
 
Utf8String
file_get_last_modified_datetime_as_str (const std::filesystem::path &filename);

bool
remove (const std::filesystem::path &path);

std::unique_ptr<QTemporaryDir>
make_tmp_dir (
  std::optional<QString> template_path = std::nullopt,
  bool                   in_temp_dir = true);

inline std::unique_ptr<QTemporaryDir>
make_tmp_dir_at_path (const std::filesystem::path &absolute_template_path)
{
  return make_tmp_dir (
    Utf8String::from_path (absolute_template_path).to_qstring (), false);
}

std::unique_ptr<QTemporaryFile>
make_tmp_file (
  std::optional<utils::Utf8String> template_path = std::nullopt,
  bool                             in_temp_dir = true);

bool
rmdir (const std::filesystem::path &path, bool force);

std::vector<std::filesystem::path>
get_files_in_dir_as_basenames (const std::filesystem::path &_dir);

std::vector<std::filesystem::path>
get_files_in_dir_ending_in (
  const std::filesystem::path            &_dir,
  bool                                    recursive,
  const std::optional<utils::Utf8String> &end_string);

std::vector<std::filesystem::path>
get_files_in_dir (const std::filesystem::path &_dir);

void
copy_dir (
  const std::filesystem::path &destdir,
  const std::filesystem::path &srcdir,
  bool                         follow_symlinks,
  bool                         recursive);

void
copy_file (
  const std::filesystem::path &destfile,
  const std::filesystem::path &srcfile);

void
move_file (
  const std::filesystem::path &destfile,
  const std::filesystem::path &srcfile,
  bool                         force = false);

std::filesystem::path
get_next_available_filepath (const std::filesystem::path &filepath);

Utf8String
get_legal_file_name (const Utf8String &file_name);

Utf8String
get_legal_path_name (const Utf8String &path);
 
#ifdef _WIN32
utils::Utf8String
get_registry_string_val (const utils::Utf8String &key);
#endif
 
#if defined(__APPLE__) && ZRYTHM_IS_INSTALLER_VER
[[gnu::nonnull]] int
get_bundle_path (char * bundle_path);
#endif

bool
path_exists (const std::filesystem::path &path);
 
bool
is_file_hidden (const std::filesystem::path &file);

[[nodiscard]] bool
reflink_file (
  const std::filesystem::path &dest,
  const std::filesystem::path &src);

[[nodiscard]] QByteArray
read_file_contents (const std::filesystem::path &path);

void
set_file_contents (
  const std::filesystem::path &path,
  const char *                 contents,
  size_t                       size);

void
set_file_contents (
  const std::filesystem::path &file_path,
  const utils::Utf8String     &data);

QStringList
split_paths (const QString &paths);
 
}; // namespace zrythm::utils::io