xaizek / zograscope (License: AGPLv3 only) (since 2018-12-07)
Mainly a syntax-aware diff that also provides a number of additional tools.
<root> / src / tooling / Matcher.hpp (a9df76cd076900f9beb3240b5e196171a9aae04f) (3,252B) (mode 100644) [raw]
// Copyright (C) 2018 xaizek <xaizek@posteo.net>
//
// This file is part of zograscope.
//
// zograscope is free software: you can redistribute it and/or modify
// it under the terms of version 3 of the GNU Affero General Public License as
// published by the Free Software Foundation.
//
// zograscope is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with zograscope.  If not, see <http://www.gnu.org/licenses/>.

#ifndef ZOGRASCOPE_TOOLING_MATCHER_HPP_
#define ZOGRASCOPE_TOOLING_MATCHER_HPP_

#include <cstdint>

#include <utility>

#include "Language.hpp"
#include "mtypes.hpp"
#include "tree.hpp"

// Finds a node of specified type that matches another matcher.
class Matcher
{
public:
    // Constructs matcher that matches `mtype` and delegates nested matching to
    // `nested`.  `nested` matcher can be `nullptr`, in which case `handler`
    // passed to `match()` is called.
    Matcher(MType mtype, Matcher *nested);

public:
    // Matches children of `node` and invokes `handler` on the last match in the
    // chain.  Returns `true` if at something was matched, `false` otherwise.
    // `handler` must be callable as if it has `void handler(Node *node)`
    // signature.
    template <typename F>
    bool match(const Node *node, Language &lang, F &&handler);

    // Retrieves type this matcher matches against.
    MType getMType() const;
    // Retrieves number of nodes of specified type seen.
    int getSeen() const;
    // Retrieves number of nodes of specified type which were matched.
    int getMatched() const;

private:
    MType mtype;     // Type to match against.
    Matcher *nested; // Nested matcher, can be `nullptr`.
    int seen;        // Number of nodes of specified type seen.
    int matched;     // Number of nodes of specified which were matched.
};

inline
Matcher::Matcher(MType mtype, Matcher *nested)
    : mtype(mtype), nested(nested), seen(0), matched(0)
{
}

template <typename F>
inline bool
Matcher::match(const Node *node, Language &lang, F &&handler)
{
    if (node->next != nullptr) {
        return match(node->next, lang, std::forward<F>(handler));
    }

    bool foundMatch = false;
    for (Node *child : node->children) {
        if (lang.classify(child->stype) != mtype) {
            foundMatch |= match(child, lang, std::forward<F>(handler));
            continue;
        }

        ++seen;
        if (nested == nullptr ||
            nested->match(child, lang, std::forward<F>(handler))) {
            ++matched;
            foundMatch = true;

            if (nested == nullptr) {
                handler(child);
            }

            if (canNest(mtype)) {
                match(child, lang, std::forward<F>(handler));
            }
        }
    }
    return foundMatch;
}

inline MType
Matcher::getMType() const
{
    return mtype;
}

inline int
Matcher::getSeen() const
{
    return seen;
}

inline int
Matcher::getMatched() const
{
    return matched;
}

#endif // ZOGRASCOPE_TOOLING_MATCHER_HPP_
Hints

Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/zograscope

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/zograscope

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master