AuthMe/AuthMeReloaded

View on GitHub
src/test/java/tools/docs/hashmethods/HashAlgorithmsDescriptionTask.java

Summary

Maintainability
A
0 mins
Test Coverage
package tools.docs.hashmethods;

import fr.xephi.authme.security.HashAlgorithm;
import tools.utils.AutoToolTask;
import tools.utils.FileIoUtils;
import tools.utils.TagValue.NestedTagValue;
import tools.utils.TagValueHolder;
import tools.utils.ToolsConstants;

import java.util.Locale;
import java.util.Map;

/**
 * Task for generating the markdown page describing the AuthMe hash algorithms.
 *
 * @see fr.xephi.authme.security.HashAlgorithm
 */
public class HashAlgorithmsDescriptionTask implements AutoToolTask {

    private static final String CUR_FOLDER = ToolsConstants.TOOLS_SOURCE_ROOT + "docs/hashmethods/";
    private static final String OUTPUT_FILE = ToolsConstants.DOCS_FOLDER + "hash_algorithms.md";

    @Override
    public void executeDefault() {
        // Gather info and construct a row for each method
        EncryptionMethodInfoGatherer infoGatherer = new EncryptionMethodInfoGatherer();
        Map<HashAlgorithm, MethodDescription> descriptions = infoGatherer.getDescriptions();
        final NestedTagValue methodRows = constructMethodRows(descriptions);

        // Write to the docs file
        TagValueHolder tags = TagValueHolder.create().put("algorithms", methodRows);
        FileIoUtils.generateFileFromTemplate(CUR_FOLDER + "hash_algorithms.tpl.md", OUTPUT_FILE, tags);
        System.out.println("Wrote to '" + OUTPUT_FILE + "'");
    }

    private static NestedTagValue constructMethodRows(Map<HashAlgorithm, MethodDescription> descriptions) {
        NestedTagValue methodTags = new NestedTagValue();
        for (Map.Entry<HashAlgorithm, MethodDescription> entry : descriptions.entrySet()) {
            MethodDescription description = entry.getValue();
            TagValueHolder tags = TagValueHolder.create()
                .put("name",             asString(entry.getKey()))
                .put("recommendation",   asString(description.getUsage()))
                .put("hash_length",      asString(description.getHashLength()))
                .put("ascii_restricted", asString(description.isAsciiRestricted()))
                .put("salt_type",        asString(description.getSaltType()))
                .put("salt_length",      asString(description.getSaltLength()))
                .put("separate_salt",    asString(description.hasSeparateSalt()));
            methodTags.add(tags);
        }
        return methodTags;
    }

    @Override
    public String getTaskName() {
        return "describeHashAlgos";
    }

    // ----
    // String representations
    // ----
    private static String asString(boolean value) {
        return value ? "Y" : "";
    }

    private static String asString(int value) {
        return String.valueOf(value);
    }

    private static String asString(Integer value) {
        if (value == null) {
            return "";
        }
        return String.valueOf(value);
    }

    private static String asString(HashAlgorithm value) {
        return value.toString();
    }

    private static <E extends Enum<E>> String asString(E value) {
        if (value == null) {
            return "";
        }
        // Get the enum name and replace something like "DO_NOT_USE" to "Do not use"
        String enumName = value.toString().replace("_", " ");
        return enumName.length() > 2
            ? enumName.substring(0, 1) + enumName.substring(1).toLowerCase(Locale.ROOT)
            : enumName;
    }

}