#pragma once

#include <string>
#include <vector>
#include <filesystem>
#include <functional>

namespace fs = std::filesystem;

std::string file_basename(const std::string& filename);
std::string extension(const std::string& filename);
std::string file_directory(const std::string& filename);
std::string absolute_pathname(const std::string& filename, const std::string& base="");
std::string relative_pathname(const std::string& filename);
std::string relative_pathname(const std::string& filename, const std::string& base);

fs::path relative_to_cwd(const fs::path& input);

bool file_exists(const std::string& pathname, bool error_if_not=false, bool is_directory=false);
std::string string_from_file(const std::string& pathname, bool strip_surrounding_whitespace=false);
void string_to_file(const std::string& pathname, std::string contents);
std::vector<std::string> get_files_in_directory(const std::string& dir);
std::string find_file(const std::string& basename, std::vector<std::string> search_path,
                      bool error_if_not_found=true);

std::vector<fs::path>
find_file_recursive(const fs::path& root, const std::string& filename,
                    bool only_one=true); //, Locator loc=Locator());
std::vector<fs::path>
find_file_from_roots(const std::vector<std::string>& roots, const std::string& filename, bool only_one);

fs::path klammertext_filename(
    const std::string& basename, bool error_if_missing=true, bool make_directory_if_missing=false);
std::vector<std::string> sks_dirs();
std::vector<std::string> get_sks_directories(const std::string& s, bool include_argument=true);
std::string cache_directory(std::string subdirectory, std::string parent_directory="");
std::time_t to_time_t(const fs::file_time_type& ftime);
bool in_modification_order(std::string filename1, std::string filename2);
void write_to_cache(std::string cache_dir, std::string basename, std::string text);
std::string read_from_cache(std::string cache_dir, std::string basename);
bool cache_requires_update(std::string cache_dir, std::string file_to_cache, std::string basename);

std::vector<fs::path> pathnames_with_extension(
    const fs::path& dir, const std::string extension
    );
//std::string find_file(const fs::path& root, const std::string& name);
std::vector<std::string> find_files_with_extension(
    const fs::path& root, const std::string& ext, bool case_insensitive=false);
std::string combine_files(
    std::vector<std::string> filenames,
    std::string prolog="", std::string epilog="",
    std::function <std::string(std::string)> processor = nullptr);

bool files_differ(const fs::path& p1,
                  const fs::path& p2,
                  std::size_t buffer_size = 1 << 16);  // 64 KiB

// Copy a single file with an explicit binary stream (NOT std::filesystem
// copy_file/copy), forcing the destination world-readable.  Required for output
// onto Apple `container` virtiofs mounts — see the definition in file.cpp.
void copy_file_stream(const fs::path& src, const fs::path& dst);

void copy_preserving_basename(
    std::vector<std::string> filenames, std::string output_directory, std::string link_directory);

fs::path resolve_relative_to(const fs::path& relative, const fs::path& base=std::filesystem::current_path());