fs.h

Go to the documentation of this file.

// uvco (c) 2024 Lewin Bormann. See LICENSE for specific terms.
 
#pragma once
 
#include <memory>
#include <uv.h>
#include <uv/unix.h>
 
#include "uvco/bounded_queue.h"
#include "uvco/internal/internal_utils.h"
#include "uvco/loop/loop.h"
#include "uvco/promise/multipromise.h"
#include "uvco/promise/promise.h"
 
#include <coroutine>
#include <cstddef>
#include <cstdint>
#include <optional>
#include <span>
#include <string>
#include <string_view>
#include <utility>
#include <vector>
 
namespace uvco {

 
class Directory {
public:
  Directory(const Directory &) = default;
  Directory(Directory &&other) noexcept;
  Directory &operator=(const Directory &) = delete;
  Directory &operator=(Directory &&other) noexcept;
  ~Directory();
 
  struct DirEnt {
    std::string name;
    uv_dirent_type_t type;
  };

  static Promise<void> mkdir(const Loop &loop, std::string_view path,
                             int mode = 0755);
  static Promise<void> rmdir(const Loop &loop, std::string_view path);
  static Promise<Directory> open(const Loop &loop, std::string_view path);
  static MultiPromise<DirEnt> readAll(const Loop &loop, std::string_view path);

  Promise<std::vector<DirEnt>> read(unsigned count = 64);

  Promise<unsigned int> read(std::span<DirEnt> buffer);

  void close();
 
private:
  explicit Directory(uv_loop_t *loop, uv_dir_t *dir) : loop_{loop}, dir_{dir} {}
 
  uv_loop_t *loop_;
  uv_dir_t *dir_;
};

class File {
public:
  File(const File &) = delete;
  File(File &&other) noexcept;
  File &operator=(const File &) = delete;
  File &operator=(File &&other) noexcept;
  ~File();

  static Promise<File> open(const Loop &loop, std::string_view path,
                            int flags = 0, int mode = 0644);
  static Promise<void> unlink(const Loop &loop, std::string_view path);

  Promise<size_t> read(std::string &buffer, int64_t offset = -1);

  Promise<size_t> write(std::string_view buffer, int64_t offset = -1);

  [[nodiscard]] uv_file file() const;

  void close();
 
private:
  File(uv_loop_t *loop, uv_file file) : loop_{loop}, file_(file) {}
 
  uv_loop_t *loop_;
  uv_file file_;
};
 
class FsWatch {
  struct FsWatchAwaiter_;
 
public:
  FsWatch(const FsWatch &) = delete;
  FsWatch(FsWatch &&) = default;
  FsWatch &operator=(const FsWatch &) = delete;
  FsWatch &operator=(FsWatch &&) = default;

  ~FsWatch();

  static Promise<FsWatch> create(const Loop &loop, std::string_view path);

  static Promise<FsWatch> createRecursive(const Loop &loop,
                                          std::string_view path);

  struct FileEvent {
    FileEvent(std::string p, uv_fs_event e)
        : path{std::move(p)}, events{e}, status{} {}
    explicit FileEvent(uv_status s) : events{}, status{s} {}
    FileEvent(FileEvent &&) = default;
    FileEvent &operator=(FileEvent &&) = default;
    FileEvent(const FileEvent &) = default;
    FileEvent &operator=(const FileEvent &) = default;
    ~FileEvent() = default;
 
    std::string path;
    uv_fs_event events;
    uv_status status;
  };
 
  // Start watching the file or path. Events that occurred before calling
  // watch() are dropped.
  //
  // Note: watch() may be only called once at a time. However, after
  // stopWatch(), watch() can be called again.
  MultiPromise<FileEvent> watch();
 
  // In order to ensure a clean shutdown, call stopWatch() before dropping the
  // FsWatch, and consume all remaining events until the watch() generator
  // returns std::nullopt.
  //
  // You must supply the generator returned by watch() to ensure completion of
  // all events.
  Promise<void> stopWatch(MultiPromise<FileEvent> watcher);
 
  // Call this to retire the libuv handle.
  void close();
 
private:
  FsWatch();
  static Promise<FsWatch> createWithFlag(const Loop &loop,
                                         std::string_view path,
                                         uv_fs_event_flags flags);
 
  MultiPromise<FileEvent> watch_();
  static void onFsWatcherEvent(uv_fs_event_t *handle, const char *path,
                               int events, uv_status status);
 
  std::unique_ptr<uv_fs_event_t> uv_handle_{};
};

 
} // namespace uvco