YQL-20112: Improve dramatically yql/utils/docs

Introduced `links.json` format to link names to
documentation sections. Implement general links
verification framework. Also fixed two small typos.

Extended Description: https://nda.ya.ru/t/zR4voivb7GzD9r.
commit_hash:e72db0e202b4ff612374c73fa384f70d029f0ef0

1 files changed, 43 insertions, 0 deletions

diff --git a/yql/essentials/utils/docs/resource.cpp b/yql/essentials/utils/docs/resource.cpp
new file mode 100644
index 00000000000..8ca724c432e
--- /dev/null
+++ b/yql/essentials/utils/docs/resource.cpp
@@ -0,0 +1,43 @@
+#include "resource.h"
+
+#include <yql/essentials/utils/yql_panic.h>
+
+#include <library/cpp/resource/resource.h>
+
+namespace NYql::NDocs {
+
+    bool IsMatching(const TResourceFilter& filter, TStringBuf key) {
+        return key.Contains(filter.BaseDirectorySuffix) &&
+               key.EndsWith(filter.CutSuffix);
+    }
+
+    TStringBuf RelativePath(const TResourceFilter& filter, TStringBuf key Y_LIFETIME_BOUND) {
+        size_t pos = key.find(filter.BaseDirectorySuffix);
+        YQL_ENSURE(pos != TString::npos);
+        pos += filter.BaseDirectorySuffix.size();
+
+        TStringBuf tail = TStringBuf(key).SubStr(pos);
+        tail.remove_suffix(filter.CutSuffix.size());
+        return tail;
+    }
+
+    TResourcesByRelativePath FindResources(const TResourceFilter& filter) {
+        YQL_ENSURE(
+            filter.BaseDirectorySuffix.EndsWith('/'),
+            "BaseDirectory should end with '/', but got '" << filter.BaseDirectorySuffix << "'");
+
+        TResourcesByRelativePath resources;
+        for (TStringBuf key : NResource::ListAllKeys()) {
+            if (!key.StartsWith("resfs/file/") || !IsMatching(filter, key)) {
+                continue;
+            }
+
+            TStringBuf path = RelativePath(filter, key);
+            YQL_ENSURE(!resources.contains(path));
+
+            resources[path] = NResource::Find(key);
+        }
+        return resources;
+    }
+
+} // namespace NYql::NDocs