dir / path -- 파일과 디렉터리 #

#include <std/dir.h>
#include <std/path.h>

#define DIR_NONE  0   // 아무것도 없음
#define DIR_FILE  1   // 일반 파일
#define DIR_DIR   2   // 디렉터리
#define DIR_LINK  3   // 심볼릭 링크(따라가지 않음) / Windows 리파스 포인트
#define DIR_OTHER 4   // 장치, 파이프, 소켓, ...

struct DirEntry {
    struct String name;   // 항목 자체의 이름, 디렉터리 부분 없음
    int kind;             // DIR_FILE / DIR_DIR / DIR_LINK / DIR_OTHER
    static struct DirEntry new();
    void free() consume;
};

struct Dir {
    static ?&Dir open(const &char path);   // 읽을 수 있는 디렉터리가 아니면 null
    int  next(&DirEntry out);              // 1 = 항목을 읽음(이름이 교체됨), 0 = 끝
    void close() consume;
};

#include <std/dir.h>
#include <std/io.h>

int main() {
    match (std::Dir::open("docs")) {
        case some(d): {
            struct DirEntry e = DirEntry::new();
            while (d.next(&e)) {
                std::print(e.kind == DIR_DIR ? "dir   " : "file  ");
                std::println(e.name.as_ptr());
            }
            e.free();
            d.close();
        }
        case null: { std::eprintln("cannot open docs/"); return 1; }
    }
    return 0;
}

struct FileStat {
    int       kind;      // DIR_NONE .. DIR_OTHER (링크의 대상이 아니라 링크 자체)
    long long size;      // 바이트
    long long mtime_ns;  // 마지막 수정 시각, Unix epoch 이후 ns
};

int file_stat(const &char path, &FileStat out);   // 아무것도 없으면 0, kind = DIR_NONE
int path_kind(const &char path);                  // 종류만
int path_exists(const &char path);

int dir_create(const &char path);        // 디렉터리 하나, 이미 있어도 1
int dir_create_all(const &char path);    // 없는 상위 디렉터리까지 모두 (mkdir -p)
int dir_remove(const &char path);        // 빈 디렉터리
int dir_remove_all(const &char path);    // 아래의 모든 것까지 (rm -rf), 아무것도 없었으면 1
int file_remove(const &char path);       // 파일 또는 링크
int file_copy(const &char from, const &char to);       // 'to'를 생성/잘라내기
int dir_copy_tree(const &char from, const &char to);   // cp -R from/. to/
int dir_walk(const &char root, &Vec<struct String> out);

// 빌드 출력: 깨끗하게 시작하고, 정적 파일을 복사하고, 소스를 나열.
std::dir_remove_all("dist");
std::dir_copy_tree("public", "dist");

struct Vec<struct String> pages = Vec::new();
std::dir_walk("docs", &pages);
for (unsigned long i = 0UL; i < pages.len; i = i + 1UL) {
    struct String ext = std::path_ext(pages.at(i).as_ptr());
    if (ext.eq_cstr("md")) { std::println(pages.at(i).as_ptr()); }
    ext.free();
}
pages.free();

int path_is_sep(char c);                  // '/', Windows 타깃에서는 '\'도
int path_is_absolute(const &char p);      // "/x", Windows에서는 "\x", "C:\x", "C:/x"도

struct String path_join(const &char a, const &char b);   // 사이에 구분자 하나, 절대 경로 'b'가 우선
struct String path_dirname(const &char p);   // "a/b/c" -> "a/b", "c" -> "", "/c" -> "/"
struct String path_basename(const &char p);  // "a/b.c" -> "b.c", "a/b/" -> "b"
struct String path_ext(const &char p);       // "a/b.tar.gz" -> "gz", ".bashrc" -> ""
struct String path_stem(const &char p);      // "a/b.tar.gz" -> "b.tar"
struct String path_normalize(const &char p); // "a//b/./c/../d/" -> "a/b/d", "" -> "."
struct String path_relative(const &char from, const &char to);   // ("a/b", "a/c/d") -> "../c/d"