Add mustRead

Author: mgenware

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.2.1
+
+- Add `mustRead`.
+
 ## 2.2.0
 
 - Remove undocumented binary reader.

lib/src/random_access_source.dart

@@ -22,4 +22,14 @@ abstract class RandomAccessSource {
 
   /// Closes the source.
   Future<void> close();
+
+  /// Reads a specific number of bytes, ensuring that the exact number is read.
+  /// Throws an exception if the number of bytes read is not equal to [length].
+  Future<Uint8List> mustRead(int length) async {
+    final bytes = await read(length);
+    if (bytes.length != length) {
+      throw Exception('Failed to read $length bytes, got ${bytes.length}');
+    }
+    return bytes;
+  }
 }

pubspec.yaml

@@ -1,6 +1,6 @@
 name: random_access_source
 description: A shared interface for common random access data.
-version: 2.2.0
+version: 2.2.1
 repository: https://github.com/flutter-cavalry/random_access_source
 
 environment: