(commons-io) 01/02: Add ProxyInputStream.setReference(InputStream), was package-private setIn(InputStream)

[ggregory]

This is an automated email from the ASF dual-hosted git repository.

ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-io.git

commit f78f7a2565a7cd454196719eb11e02a09401e0b3
Author: Gary Gregory <garydgreg...@gmail.com>
AuthorDate: Thu Jan 2 08:30:23 2025 -0500

    Add ProxyInputStream.setReference(InputStream), was package-private
    setIn(InputStream)
---
 src/changes/changes.xml                                        |  1 +
 .../java/org/apache/commons/io/input/ProxyInputStream.java     |  7 +++++--
 .../java/org/apache/commons/io/input/ProxyInputStreamTest.java | 10 +++++-----
 3 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index f4de083fe..a5f4ae83f 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -58,6 +58,7 @@ The <action> type attribute can be add,update,fix,remove.
       <action dev="ggregory" type="add"                due-to="Gary 
Gregory">Add AbstractByteArrayOutputStream.write(CharSequence, 
Charset).</action>
       <action dev="ggregory" type="add"                due-to="Gary 
Gregory">Add AbstractByteArrayOutputStream.write(byte[]).</action>
       <action dev="ggregory" type="add"                due-to="Gary 
Gregory">Add RandomAccessFileOutputStream.getRandomAccessFile().</action>
+      <action dev="ggregory" type="add"                due-to="Gary 
Gregory">Add ProxyInputStream.setReference(InputStream), was package-private 
setIn(InputStream).</action>
       <!-- UPDATE -->
       <action dev="ggregory" type="update"             due-to="Dependabot, 
Gary Gregory">Bump commons.bytebuddy.version from 1.15.10 to 1.15.11 
#710.</action>
     </release>
diff --git a/src/main/java/org/apache/commons/io/input/ProxyInputStream.java 
b/src/main/java/org/apache/commons/io/input/ProxyInputStream.java
index 8dfa2391d..eecee50a5 100644
--- a/src/main/java/org/apache/commons/io/input/ProxyInputStream.java
+++ b/src/main/java/org/apache/commons/io/input/ProxyInputStream.java
@@ -367,12 +367,15 @@ public abstract class ProxyInputStream extends 
FilterInputStream {
     }
 
     /**
-     * Package-private for testing.
+     * Sets the underlying input stream.
      *
      * @param in The input stream to set in {@link 
java.io.FilterInputStream#in}.
+     * @return this instance.
+     * @since 2.19.0
      */
-    void setIn(final InputStream in) {
+    public ProxyInputStream setReference(final InputStream in) {
         this.in = in;
+        return this;
     }
 
     /**
diff --git 
a/src/test/java/org/apache/commons/io/input/ProxyInputStreamTest.java 
b/src/test/java/org/apache/commons/io/input/ProxyInputStreamTest.java
index 2b5ba176f..04ab4ffc7 100644
--- a/src/test/java/org/apache/commons/io/input/ProxyInputStreamTest.java
+++ b/src/test/java/org/apache/commons/io/input/ProxyInputStreamTest.java
@@ -145,11 +145,11 @@ public class ProxyInputStreamTest<T extends 
ProxyInputStream> {
     public void testAvailableNull() throws IOException {
         try (T inputStream = createFixture(null)) {
             assertEquals(0, inputStream.available());
-            inputStream.setIn(createFixture());
+            inputStream.setReference(createFixture());
             assertEquals(3, inputStream.available());
             IOUtils.toByteArray(inputStream);
             assertEquals(0, inputStream.available());
-            inputStream.setIn(null);
+            inputStream.setReference(null);
             assertEquals(0, inputStream.available());
         }
     }
@@ -162,11 +162,11 @@ public class ProxyInputStreamTest<T extends 
ProxyInputStream> {
     public void testMarkOnNull() throws IOException {
         try (T inputStream = createFixture(null)) {
             inputStream.mark(1);
-            inputStream.setIn(createFixture());
+            inputStream.setReference(createFixture());
             inputStream.mark(1);
             IOUtils.toByteArray(inputStream);
             inputStream.mark(1);
-            inputStream.setIn(null);
+            inputStream.setReference(null);
             inputStream.mark(1);
         }
     }
@@ -192,7 +192,7 @@ public class ProxyInputStreamTest<T extends 
ProxyInputStream> {
     public void testMarkSupportedOnNull() throws IOException {
         try (ProxyInputStream fixture = createFixture()) {
             assertMarkSupportedEquals(fixture);
-            fixture.setIn(null);
+            fixture.setReference(null);
             assertFalse(fixture.markSupported());
         }
     }