0.8.2 - refactor FileReadUtil with more optimized code and InputStream -> char[]/String methods, better FileReadUtil chunkSize and charset defaults customization via constructor and static defaults for thread local instances, more unit tests

Author: TeamworkGuy2

.classpath

@@ -1,15 +1,14 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <classpath>
 	<classpathentry kind="src" path="src"/>
 	<classpathentry kind="src" path="test"/>
-	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/jre-9.0.1">
+	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER">
 		<attributes>
 			<attribute name="module" value="true"/>
 		</attributes>
 	</classpathentry>
 	<classpathentry kind="con" path="org.eclipse.jdt.junit.JUNIT_CONTAINER/5"/>
 	<classpathentry kind="con" path="org.eclipse.jdt.USER_LIBRARY/TestChecks"/>
-	<classpathentry kind="output" path="bin"/>
 	<classpathentry kind="lib" path="C:/Users/TeamworkGuy2/Documents/Java/Libraries/jarrays/bin/jarrays.jar" sourcepath="/JArrays"/>
 	<classpathentry kind="lib" path="C:/Users/TeamworkGuy2/Documents/Java/Libraries/jcollection-interfaces/bin/jcollection_interfaces.jar" sourcepath="/JCollectionInterfaces"/>
 	<classpathentry kind="lib" path="C:/Users/TeamworkGuy2/Documents/Java/Libraries/jcollection-util/bin/jcollection_util.jar" sourcepath="/JCollectionUtil"/>
@@ -19,4 +18,5 @@
 	<classpathentry kind="lib" path="C:/Users/TeamworkGuy2/Documents/Java/Libraries/jtext-template/bin/jtext_template.jar" sourcepath="/JTextTemplate"/>
 	<classpathentry kind="lib" path="C:/Users/TeamworkGuy2/Documents/Java/Libraries/jtext-util/bin/jtext_util.jar" sourcepath="/JTextUtil"/>
 	<classpathentry kind="lib" path="C:/Users/TeamworkGuy2/Documents/Java/Libraries/jtwg2-logging/bin/jtwg2_logging.jar" sourcepath="/JTwg2Logging"/>
+	<classpathentry kind="output" path="bin"/>
 </classpath>

CHANGELOG.md

@@ -4,7 +4,18 @@ This project does its best to adhere to [Semantic Versioning](http://semver.org/
 
 
 --------
-### [0.8.1](N/A) - 2017-12-30
+### [0.8.2](N/A) - 2019-03-30
+#### Changed
+* Rewrite `FileReadUtil`:
+  * Less array allocations
+  * Text decoding methods from `InputStream` -> `char[]` or `String` with optimized direct `CharsetDecoder.decode()` calls
+  * More helper methods for `File`, `InputStream`, and overloads with default `chunkSize` and `charsetDecoder` overrides
+  * Static default `ChunkSize` and `charsetDecoder` fields with setters to allow the `threadLocalInst()` constructor defaults to be set
+  * Bug fixes and better unit testing with `LimitedByteArrayInputStream` to replicate input stream `read()` calls that only return partial and require subseqent calls
+
+
+--------
+### [0.8.1](https://github.com/TeamworkGuy2/JFileIo/commit/73c98e3414a598f3faa979da2d0abcad2316627c) - 2017-12-30
 #### Changed
 * Upgrade to Java 9
 * Upgrade to JUnit 5
@@ -120,7 +131,7 @@ This project does its best to adhere to [Semantic Versioning](http://semver.org/
 --------
 ### [0.4.0](https://github.com/TeamworkGuy2/JFileIo/commit/65a89848376862c2fc3ce12e1e8e011e8166ae9f) - 2016-02-24
 #### Changed
-* Move twg2.io.log package to separate [JTwg2Logging] (https://github.com/TeamworkGuy2/JTwg2Logging) library
+* Move twg2.io.log package to separate [JTwg2Logging](https://github.com/TeamworkGuy2/JTwg2Logging) library
 
 
 --------
@@ -130,7 +141,7 @@ This project does its best to adhere to [Semantic Versioning](http://semver.org/
 * Updated FileReadUtil to only use thread local caches to prevent bugs when calling these static methods from multiple threads
 
 #### Removed
-* Removed some unused CharsetUtil methods 
+* Removed some unused CharsetUtil methods
 
 
 --------

README.md

@@ -1,14 +1,22 @@
 JFileIo
 ==============
-version: 0.8.1
 
 Utilities for reading/writing data from/to files in Java. Includes:
 * Builders and utility methods for external process execution (i.e. runtime.exec(...))
 * Filtered FileVisitor builders which can be passed to Files.walkFileTree(...)
 * Rolling file renamer for creating log files or file snapshots/backups
-* File reader utility class for reading files using interal cache which is reused between file reads with smart buffer resizing to minimize garbage generated 
+* File reader utility class for reading files using internal cache which is reused between file reads with smart buffer resizing to minimize garbage generated 
 
-Take a look at the 'twg2.io.test' package for some examples of how the API can be used.
+Take a look at the `twg2.io.test` package for some examples of how the API can be used.
+
+
+--------
+## Reusable Buffered File Reading
+
+Reuses internal buffers to allow for nearly allocation free file loading on subsequent files read:
+```Java
+String text = FileReadUtil.threadLocalInst().readString(new File(...));
+```
 
 
 --------

bin/jfile_io-with-tests.jar

@@ -1,5 +1,5 @@
 {
-	"version" : "0.8.1",
+	"version" : "0.8.2",
 	"name" : "jfile-io",
 	"description" : "Java Helpers for File I/O: filtered FileVisitor builders, rolling file renamer, cached buffer file reader, and other File/Path helpers to make Java I/O easier",
 	"homepage" : "https://github.com/TeamworkGuy2/JFileIo",