Andy Kopra
fd9a370af7
- Filenames may contain spaces: quote on the command line; filename lists use a standalone "/" separator; unseparated names that do not exist are rejoined into names that do (announced); leading ~ expands. - Without -o, output is written to the input file's directory; -o fully specifies the output directory and basename. - "Word not parsed" warnings now appear without -v, only for text that survives removal, with correct line numbers. - New tst/filename_test.sh regression suite. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
79 lines
3.9 KiB
C++
79 lines
3.9 KiB
C++
#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);
|
|
|
|
// Filenames may contain spaces. A filename LIST in a flat string or an
|
|
// argument vector is separated by a standalone "/" token (whitespace on both
|
|
// sides; never a legal input filename -- "/" alone is the root directory).
|
|
// Without a separator, whitespace-split tokens that do not name existing
|
|
// files are greedily rejoined with their neighbors into names that do (the
|
|
// rescue is announced). A leading "~/" (or bare "~") expands to $HOME.
|
|
std::string expand_tilde(const std::string& path);
|
|
std::vector<std::string> group_filename_tokens(
|
|
const std::vector<std::string>& tokens, const std::string& base_dir="");
|
|
std::vector<std::string> resolve_filename_list(
|
|
const std::string& text, const std::string& base_dir="");
|
|
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());
|