mirror of
https://github.com/RGBCube/serenity
synced 2025-05-14 12:05:00 +00:00
44e4a38535
This is necessary for subclassing SectionNode, but generally allows more code to rely on path() virtual dispatch always finding the correct path regardless of the static type.
38 lines
1.1 KiB
C++
38 lines
1.1 KiB
C++
/*
|
|
* Copyright (c) 2019-2020, Sergey Bugaev <bugaevc@serenityos.org>
|
|
* Copyright (c) 2022, the SerenityOS developers.
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/NonnullRefPtrVector.h>
|
|
#include <AK/RefCounted.h>
|
|
#include <AK/String.h>
|
|
#include <AK/StringView.h>
|
|
|
|
namespace Manual {
|
|
|
|
class PageNode;
|
|
|
|
class Node : public RefCounted<Node> {
|
|
public:
|
|
virtual ~Node() = default;
|
|
|
|
virtual ErrorOr<Span<NonnullRefPtr<Node>>> children() const = 0;
|
|
virtual Node const* parent() const = 0;
|
|
virtual ErrorOr<String> name() const = 0;
|
|
virtual bool is_page() const { return false; }
|
|
virtual bool is_open() const { return false; }
|
|
virtual ErrorOr<String> path() const = 0;
|
|
|
|
// Backend for the command-line argument format that Help and man accept. Handles:
|
|
// [/path/to/documentation.md] (no second argument)
|
|
// [page] (no second argument) - will find first section with that page
|
|
// [section] [page]
|
|
// Help can also (externally) handle search queries, which is not possible (yet) in man.
|
|
static ErrorOr<NonnullRefPtr<PageNode>> try_create_from_query(Vector<StringView, 2> const& query_parameters);
|
|
};
|
|
|
|
}
|