aboutsummaryrefslogtreecommitdiffstats
path: root/nihil.posix/find_in_path.ccm
blob: dabe3581cee69e27a690b56f05015903ed0bcf67 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
// This source code is released into the public domain.
module;

#include <unistd.h> // access()

export module nihil.posix:find_in_path;

import nihil.std;
import nihil.error;
import :fd;
import :getenv;
import :paths;

namespace nihil {

// Find an executable by searching the given path string, which should be a colon-separated list of
// directories, and return the full path.  If the file can't be found or is not executable, returns
// an appropriate error.
export [[nodiscard]] auto find_in_path(std::filesystem::path const &file, std::string_view path)
	-> std::expected<std::filesystem::path, error>
{
	auto try_return =
		[](std::filesystem::path file) -> std::expected<std::filesystem::path, error> {
		auto ret = ::access(file.string().c_str(), X_OK);
		if (ret == 0)
			return {std::move(file)};
		return std::unexpected(error(sys_error()));
	};

	// Absolute pathname skips the search.
	if (file.is_absolute())
		return try_return(file);

	// Default to ENOENT as the error.
	auto err = error(std::errc::no_such_file_or_directory);

	for (auto &&dir : path | std::views::split(':')) {
		// An empty $PATH element means cwd.
		auto sdir = dir.empty() ? std::filesystem::path(".")
		                        : std::filesystem::path(std::string_view(dir));

		if (auto ret = try_return(sdir / file); ret)
			return ret;
		// If we get an error other than ENOENT, cache it to return to the caller.
		// This means we can propagate access() errors.
		else if (ret.error().root_cause() != std::errc::no_such_file_or_directory)
			err = std::move(ret.error());
	}

	return std::unexpected(std::move(err));
}

// Find an executable in $PATH and return the full path.  If $PATH is not set, uses _PATH_DEFPATH.
// If the file can't be found or is not executable, returns an appropriate error.
export [[nodiscard]] auto
find_in_path(std::filesystem::path const &file) -> std::expected<std::filesystem::path, error>
{
	auto const path = getenv("PATH").value_or(std::string(paths::defpath)); // NOLINT
	return find_in_path(file, path);
}

} // namespace nihil