<commit_before>package nl.beehivejava.scriptj.parser;

import nl.beehivejava.scriptj.PluginInformation;

import java.io.IOException;
import java.io.InputStream;

/**
 * @author Lesley
 */
public interface PluginInformationParser {

    PluginInformation parse(InputStream is) throws IOException;

}
<commit_msg>Add documentation and mark PluginInformationParser a FunctionInterface.<commit_after>package nl.beehivejava.scriptj.parser;

import nl.beehivejava.scriptj.Plugin;
import nl.beehivejava.scriptj.PluginInformation;

import java.io.IOException;
import java.io.InputStream;

/**
 * A {@code PluginInformationParser} can convert/parse an {@link InputStream} to a {@link PluginInformation}.
 *
 * @author Lesley
 */
@FunctionalInterface
public interface PluginInformationParser {

    /**
     * Parses the given {@link InputStream} to a {@link PluginInformation}.
     *
     * @param is The {@code InputStream} that holds the data of the {@code PluginInformation}, should not be
     *           {@code null}.
     * @return A {@code PluginInformation} holding the data of a {@link Plugin}.
     * @throws IOException          If some error occurs while reading from the {@code InputStream}.
     * @throws NullPointerException If the given {@code InputStream} is {@code null}.
     */
    PluginInformation parse(InputStream is) throws IOException;

}

{'fraction_non_alphanumeric': 0.09492273730684327, 'fraction_numerical': 0.0, 'mean_word_length': 4.171102661596958, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1696035', 'n_tokens_mistral': 369, 'n_tokens_neox': 361, 'n_words': 117}