GH-57 Add Progessbar

eternalcode-commons-shared/src/main/java/com/eternalcode/commons/progressbar/ProgressBar.java

@@ -0,0 +1,147 @@
+package com.eternalcode.commons.progressbar;
+
+public class ProgressBar {
+
+    private final String filledToken;
+
+    private final String emptyToken;
+
+    private final boolean showBrackets;
+    private final String leftBracket;
+    private final String rightBracket;
+    private final String bracketColor;
+
+    private final int length;
+
+    private ProgressBar(Builder builder) {
+        this.leftBracket = builder.leftBracket;
+        this.rightBracket = builder.rightBracket;
+        this.bracketColor = builder.bracketColor;
+        this.length = builder.length;
+        this.showBrackets = builder.showBrackets;
+
+        this.filledToken = builder.filledColor + builder.filledChar;
+        this.emptyToken = builder.emptyColor + builder.emptyChar;
+    }
+
+    public String render(double progress) {
+        double clampedProgress = Math.max(0, Math.min(1, progress));
+        int filled = (int) (this.length * clampedProgress);
+
+        StringBuilder bar = new StringBuilder();
+
+        if (this.showBrackets) {
+            bar.append(this.bracketColor).append(this.leftBracket);
+        }
+
+        for (int i = 0; i < this.length; i++) {
+            if (i < filled) {
+                bar.append(this.filledToken);
+            }
+            else {
+                bar.append(this.emptyToken);
+            }
+        }
+
+        if (this.showBrackets) {
+            bar.append(this.bracketColor).append(this.rightBracket);
+        }
+
+        return bar.toString();
+    }
+
+    public String render(int current, int max) {
+        if (max <= 0) {
+            return this.render(1.0);
+        }
+        double progress = (double) current / max;
+        return this.render(progress);
+    }
+
+    public String render(long current, long max) {
+        if (max <= 0) {
+            return this.render(1.0);
+        }
+        double progress = (double) current / max;
+        return this.render(progress);
+    }
+
+    public static Builder builder() {
+        return new Builder();
+    }
+
+    public static class Builder {
+        private String filledChar = "█";
+        private String emptyChar = "░";
+        private String filledColor = "";
+        private String emptyColor = "";
+        private String leftBracket = "[";
+        private String rightBracket = "]";
+        private String bracketColor = "";
+        private int length = 10;
+        private boolean showBrackets = true;
+
+        public Builder filledChar(String filledChar) {
+            this.filledChar = filledChar;
+            return this;
+        }
+
+        public Builder emptyChar(String emptyChar) {
+            this.emptyChar = emptyChar;
+            return this;
+        }
+
+        public Builder filledColor(String filledColor) {
+            this.filledColor = filledColor;
+            return this;
+        }
+
+        public Builder emptyColor(String emptyColor) {
+            this.emptyColor = emptyColor;
+            return this;
+        }
+
+        public Builder leftBracket(String leftBracket) {
+            this.leftBracket = leftBracket;
+            return this;
+        }
+
+        public Builder rightBracket(String rightBracket) {
+            this.rightBracket = rightBracket;
+            return this;
+        }
+
+        public Builder brackets(String left, String right) {
+            this.leftBracket = left;
+            this.rightBracket = right;
+            return this;
+        }
+
+        public Builder bracketColor(String bracketColor) {
+            this.bracketColor = bracketColor;
+            return this;
+        }
+
+        public Builder length(int length) {
+            if (length <= 0) {
+                throw new IllegalArgumentException("Length must be positive");
+            }
+            this.length = length;
+            return this;
+        }
+
+        public Builder showBrackets(boolean showBrackets) {
+            this.showBrackets = showBrackets;
+            return this;
+        }
+
+        public Builder hideBrackets() {
+            this.showBrackets = false;
+            return this;
+        }
+
+        public ProgressBar build() {
+            return new ProgressBar(this);
+        }
+    }
+}

eternalcode-commons-shared/src/main/java/com/eternalcode/commons/time/SimpleDurationUtil.java

@@ -0,0 +1,48 @@
+package com.eternalcode.commons.time;
+
+import java.time.Duration;
+import java.time.temporal.ChronoUnit;
+
+public class SimpleDurationUtil {
+
+    private static final Duration ONE_SECOND = Duration.ofSeconds(1);
+    private static final String ZERO_SECONDS = "0s";
+
+    private static final TemporalAmountParser<Duration> WITHOUT_MILLIS_FORMAT = new DurationParser()
+        .withUnit("s", ChronoUnit.SECONDS)
+        .withUnit("m", ChronoUnit.MINUTES)
+        .withUnit("h", ChronoUnit.HOURS)
+        .withUnit("d", ChronoUnit.DAYS)
+        .withUnit("w", ChronoUnit.WEEKS)
+        .withUnit("mo", ChronoUnit.MONTHS)
+        .withUnit("y", ChronoUnit.YEARS)
+        .roundOff(ChronoUnit.MILLIS);
+
+    private static final TemporalAmountParser<Duration> STANDARD_FORMAT = new DurationParser()
+        .withUnit("ms", ChronoUnit.MILLIS)
+        .withUnit("s", ChronoUnit.SECONDS)
+        .withUnit("m", ChronoUnit.MINUTES)
+        .withUnit("h", ChronoUnit.HOURS)
+        .withUnit("d", ChronoUnit.DAYS)
+        .withUnit("w", ChronoUnit.WEEKS)
+        .withUnit("mo", ChronoUnit.MONTHS)
+        .withUnit("y", ChronoUnit.YEARS);
+
+    public static String format(Duration duration, boolean removeMillis) {
+        if (removeMillis) {
+            if (duration.toMillis() < ONE_SECOND.toMillis()) {
+                return ZERO_SECONDS;
+            }
+
+            return WITHOUT_MILLIS_FORMAT.format(duration);
+        }
+
+        return STANDARD_FORMAT.format(duration);
+    }
+
+    public static String format(Duration duration) {
+        return format(duration, false);
+    }
+
+
+}

eternalcode-commons-shared/test/com/eternalcode/commons/progressbar/ProgressBarTest.java

@@ -0,0 +1,114 @@
+package com.eternalcode.commons.progressbar;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+class ProgressBarTest {
+
+    @Test
+    void testRenderFullProgress() {
+        ProgressBar bar = ProgressBar.builder()
+            .length(5)
+            .build();
+        String rendered = bar.render(1.0);
+
+        assertTrue(rendered.contains("█"));
+        assertFalse(rendered.contains("░"));
+        assertEquals(7, rendered.length());
+    }
+
+    @Test
+    void testRenderEmptyProgress() {
+        ProgressBar bar = ProgressBar.builder()
+            .length(5)
+            .build();
+        String rendered = bar.render(0.0);
+
+        assertTrue(rendered.contains("░"));
+        assertFalse(rendered.contains("█"));
+        assertEquals(7, rendered.length());
+    }
+
+    @Test
+    void testRenderHalfProgress() {
+        ProgressBar bar = ProgressBar.builder()
+            .length(4)
+            .build();
+        String rendered = bar.render(0.5);
+
+        assertTrue(rendered.contains("█"));
+        assertTrue(rendered.contains("░"));
+        assertEquals(6, rendered.length());
+    }
+
+    @Test
+    void testRenderIntOverMax() {
+        ProgressBar bar = ProgressBar.builder()
+            .length(3)
+            .build();
+        String rendered = bar.render(5, 3);
+
+        assertEquals("[███]", rendered);
+    }
+
+    @Test
+    void testRenderIntWithZeroMax() {
+        ProgressBar bar = ProgressBar.builder()
+            .length(3)
+            .build();
+        String rendered = bar.render(0, 0);
+
+        assertEquals("[███]", rendered);
+    }
+
+    @Test
+    void testHideBrackets() {
+        ProgressBar bar = ProgressBar.builder()
+            .length(3)
+            .hideBrackets()
+            .build();
+        String rendered = bar.render(1.0);
+
+        assertEquals("███", rendered);
+    }
+
+    @Test
+    void testCustomCharacters() {
+        ProgressBar bar = ProgressBar.builder()
+            .length(4)
+            .filledChar("#")
+            .emptyChar("-")
+            .brackets("{", "}")
+            .build();
+
+        String rendered = bar.render(0.5);
+        assertEquals("{##--}", rendered);
+    }
+
+    @Test
+    void testNegativeProgressClampedToZero() {
+        ProgressBar bar = ProgressBar.builder()
+            .length(3)
+            .build();
+        String rendered = bar.render(-1.0);
+
+        assertEquals("[░░░]", rendered);
+    }
+
+    @Test
+    void testProgressGreaterThanOneClampedToOne() {
+        ProgressBar bar = ProgressBar.builder()
+            .length(3)
+            .build();
+        String rendered = bar.render(2.0);
+
+        assertEquals("[███]", rendered);
+    }
+
+    @Test
+    void testInvalidLengthThrowsException() {
+        assertThrows(IllegalArgumentException.class, () -> ProgressBar.builder().length(0));
+        assertThrows(IllegalArgumentException.class, () -> ProgressBar.builder().length(-5));
+    }
+}