com.yelstream.topp.standard.gradle.contribution.tool.util.Configuration Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of topp-standard-gradle-contribution Show documentation
Topp Standard Gradle Contribution provides utilities with application in the context of Gradle.
The newest version!
package com.yelstream.topp.standard.gradle.contribution.tool.util;

import lombok.AllArgsConstructor;
import lombok.experimental.UtilityClass;

import java.util.List;
import java.util.function.BooleanSupplier;
import java.util.function.Supplier;

/**
 * Utilities addressing configuration by Gradle properties.
 * 
 *     Provides methods to resolve configuration values by evaluating
 *     multiple sources in order of priority.
 * 
 * @author Morten Sabroe Mortensen
 * @version 1.1
 * @since 2024-11-26
 */
@UtilityClass
public class Configuration {

    @AllArgsConstructor
    @lombok.Builder(builderClassName="Builder",toBuilder=true)
    public static class Definition {
        @lombok.Singular
        public final List> sources;

        private final T defaultValue;

        @SuppressWarnings("java:S4276")
        public T resolve() {
            T resolved=null;
            for (var source: sources) {
                T value=source.get();
                if (value!=null) {
                    resolved=value;
                    break;
                }
            }
            return resolved;
        }

        public T getValue() {
            T resolved=resolve();
            return resolved!=null?resolved:defaultValue;
        }

        public T getValue(T defaultValue) {
            T resolved=resolve();
            return resolved!=null?resolved:defaultValue;
        }

        public static class Builder {
            private Builder append(Supplier enableSupplier) {
                this.source(enableSupplier);
                return this;
            }

            public T getValue() {
                return build().getValue();
            }

            public T getValue(T defaultValue) {
                return build().getValue(defaultValue);
            }

            public Builder value(Supplier enableSupplier) {
                return append(enableSupplier);
            }

            public Builder value(T enable) {
                return append(()->enable);
            }
       }
    }

    @AllArgsConstructor
    @lombok.Builder(builderClassName="Builder",toBuilder=true)
    public static class Feature {
        @lombok.Singular
        private final List> sources;

        private final boolean defaultValue;

        @SuppressWarnings("java:S4276")
        public Boolean resolve() {
            Boolean resolved=null;
            for (var source: sources) {
                Boolean value=source.get();
                if (value!=null) {
                    resolved=value;
                    break;
                }
            }
            return resolved;
        }

        public boolean isEnabled() {
            Boolean resolved=resolve();
            return resolved!=null?resolved:defaultValue;
        }

        public boolean isEnabled(boolean defaultValue) {
            Boolean resolved=resolve();
            return resolved!=null?resolved:defaultValue;
        }

        public static class Builder {
            private Builder append(Supplier enableSupplier) {
                this.source(enableSupplier);
                return this;
            }

            private static Boolean valueOf(String text) {  //TO-DO: Consider relocating this to a 'Booleans' utility object!
                Boolean value=null;
                if (text!=null) {
                    String trimmedText=text.trim();
                    if (!trimmedText.isEmpty()) {
                        value=Boolean.valueOf(trimmedText);
                    }
                }
                return value;
            }

            public boolean isEnabled() {
                return build().isEnabled();
            }

            public boolean isEnabled(boolean defaultValue) {
                return build().isEnabled(defaultValue);
            }

            public Builder enable(BooleanSupplier enableSupplier) {
                return append(enableSupplier::getAsBoolean);
            }

            public Builder enable(Boolean enable) {
                return append(()->enable);
            }

            public Builder enable(boolean enable) {
                return append(()->enable);
            }

            public Builder enable(String enable) {
                return append(()->valueOf(enable));
            }

            public Builder enable(Object enable) {
                return append(()->valueOf(enable==null?null:enable.toString()));
            }

            public Builder enable(Supplier