io.cucumber.cucumberexpressions.Group Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of cucumber-expressions Show documentation

Cucumber Expressions are simple patterns for matching Step Definitions with Gherkin steps

There is a newer version: 18.0.1

package io.cucumber.cucumberexpressions;

import org.apiguardian.api.API;

import java.util.List;
import java.util.regex.Pattern;
import java.util.stream.Collectors;

import static java.util.Collections.singletonList;

import java.util.ArrayList;
import java.util.Collection;

@API(status = API.Status.STABLE)
public class Group {
    private final List children;
    private final String value;
    private final int start;
    private final int end;

    Group(String value, int start, int end, List children) {
        this.value = value;
        this.start = start;
        this.end = end;
        this.children = children;
    }

    public String getValue() {
        return value;
    }

    public int getStart() {
        return start;
    }

    public int getEnd() {
        return end;
    }

    public List getChildren() {
        return children;
    }

    public List getValues() {
        List groups = getChildren().isEmpty() ? singletonList(this) : getChildren();
        return groups.stream()
                .map(Group::getValue)
                .collect(Collectors.toList());
    }

    /**
     * Parse a {@link Pattern} into collection of {@link Group}s
     * 
     * @param expression the expression to decompose
     * @return A collection of {@link Group}s, possibly empty but never
     *         null
     */
    public static Collection parse(Pattern expression) {
        GroupBuilder builder = TreeRegexp.createGroupBuilder(expression);
        return toGroups(builder.getChildren());
    }

    private static List toGroups(List children) {
        List list = new ArrayList<>();
        if (children != null) {
            for (GroupBuilder child : children) {
                list.add(new Group(child.getSource(), child.getStartIndex(), child.getEndIndex(),
                        toGroups(child.getChildren())));
            }
        }
        return list;
    }
}