Everywhere: Hoist the Libraries folder to the top-level

Libraries/LibCore/DirIterator.h

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2018-2020, Andreas Kling <andreas@ladybird.org>
+ * Copyright (c) 2023, Sam Atkins <atkinssj@serenityos.org>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#pragma once
+
+#include <LibCore/DirectoryEntry.h>
+
+namespace Core {
+
+class DirIterator {
+public:
+    enum Flags {
+        NoFlags = 0x0,
+        SkipDots = 0x1,
+        SkipParentAndBaseDir = 0x2,
+        NoStat = 0x4,
+    };
+
+    explicit DirIterator(ByteString path, Flags = Flags::NoFlags);
+    ~DirIterator();
+
+    DirIterator(DirIterator&&);
+    DirIterator(DirIterator const&) = delete;
+
+    bool has_error() const { return m_error.has_value(); }
+    Error error() const { return Error::copy(m_error.value()); }
+    bool has_next();
+    Optional<DirectoryEntry> next();
+    ByteString next_path();
+    ByteString next_full_path();
+    int fd() const;
+
+private:
+    DIR* m_dir = nullptr;
+    Optional<Error> m_error;
+    Optional<DirectoryEntry> m_next;
+    ByteString m_path;
+    int m_flags;
+
+    bool advance_next();
+};
+
+}