Add ByteSupplier

Author: garydgregory

src/changes/changes.xml

@@ -85,6 +85,7 @@ The <action> type attribute can be add,update,fix,remove.
     <action                   type="add" dev="ggregory" due-to="Gary Gregory">Add org.apache.commons.lang3.time.DateUtils.toOffsetDateTime(Date[, TimeZone]).</action>
     <action                   type="add" dev="ggregory" due-to="Gary Gregory">Add org.apache.commons.lang3.time.DateUtils.toZonedDateTime(Date[, TimeZone]).</action>
     <action                   type="add" dev="ggregory" due-to="Gary Gregory">Add ByteConsumer.</action>
+    <action                   type="add" dev="ggregory" due-to="Gary Gregory">Add ByteSupplier.</action>
     <action                   type="add" dev="ggregory" due-to="Gary Gregory">Add FailableByteConsumer.</action>
     <action                   type="add" dev="ggregory" due-to="Gary Gregory">Add FailableByteSupplier.</action>
     <!-- UPDATE -->

src/main/java/org/apache/commons/lang3/function/ByteSupplier.java

@@ -0,0 +1,36 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.commons.lang3.function;
+
+import java.util.function.IntSupplier;
+
+/**
+ * A functional interface like {@link IntSupplier}, but for a byte.
+ *
+ * @since 3.19
+ */
+@FunctionalInterface
+public interface ByteSupplier {
+
+    /**
+     * Supplies a byte.
+     *
+     * @return a result.
+     */
+    byte getAsByte();
+}

src/test/java/org/apache/commons/lang3/function/ByteSupplierTest.java

@@ -0,0 +1,38 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.commons.lang3.function;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.api.Test;
+
+/**
+ * Tests {@link ByteSupplier}.
+ */
+class ByteSupplierTest {
+
+    @Test
+    void testGetAsByte() {
+        assertEquals(1, new ByteSupplier() {
+            @Override
+            public byte getAsByte() {
+                return 1;
+            }
+        }.getAsByte());
+    }
+}