read_buffer 1.4.0

This crate provides ReadBuffer, a wrapper to safely read into a buffer from a Read.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

pub mod utils;

use std::io::ErrorKind;

use read_buffer::DynReadBuffer;
use crate::utils::{ErrorReader, ChunkedReader};

#[test]
fn read() {
	let reader = [1, 2, 3, 4, 5, 6, 7, 8].as_slice();
	let mut buffer = DynReadBuffer::new(reader);
	
	let result = buffer.read_bytes(8).unwrap();
	assert_eq!(result.len(), 8);
	assert_eq!(
		result,
		[1, 2, 3, 4, 5, 6, 7, 8]
	);
}

#[test]
fn read_partial() {
	let reader = [5, 4, 3, 2, 1].as_slice();
	let mut buffer = DynReadBuffer::new(reader);
	
	let result = buffer.read_bytes(3).unwrap();
	assert_eq!(result.len(), 3);
	assert_eq!(
		result,
		[5, 4, 3]
	);
	
	let result = buffer.read_bytes(2).unwrap();
	assert_eq!(result.len(), 2);
	assert_eq!(
		result,
		[2, 1]
	);
}

#[test]
fn read_nothing() {
	let reader = [1, 2, 3].as_slice();
	let mut buffer = DynReadBuffer::new(reader);
	
	let result = buffer.read_bytes(0).unwrap();
	assert!(result.is_empty());
	
	let result = buffer.read_bytes(1).unwrap();
	assert_eq!(
		result,
		[1]
	);
	
	let result = buffer.read_bytes(0).unwrap();
	assert!(result.is_empty());
	
	let result = buffer.read_bytes(2).unwrap();
	assert_eq!(
		result,
		[2, 3]
	);
	
	let result = buffer.read_bytes(0).unwrap();
	assert!(result.is_empty());
}

#[test]
fn with_capacity() {
	let mut reader = ChunkedReader::new();
	reader.add_chunk(vec![1]);
	reader.add_chunk(vec![5; 2048]);
	let mut buffer = DynReadBuffer::with_capacity(reader, 2048);
	
	let result = buffer.read_bytes(1).unwrap();
	assert_eq!(
		result,
		[1]
	);
	
	let original_address = &result[0] as *const u8 as usize;
	
	let result = buffer.read_bytes(2048).unwrap();
	assert_eq!(
		result,
		[5; 2048]
	);
	
	let new_address = &result[0] as *const u8 as usize;
	
	assert!(original_address <= new_address && new_address < original_address + 2048);
}

#[test]
fn unexpected_eof() {
	let reader = [1, 2, 4, 8, 16].as_slice();
	let mut buffer = DynReadBuffer::new(reader);
	
	let error = buffer.read_bytes(8).unwrap_err();
	assert_eq!(error.kind(), ErrorKind::UnexpectedEof);
	
	let result = buffer.read_bytes(5).unwrap();
	assert_eq!(
		result,
		[1, 2, 4, 8, 16]
	);
	
	let error = buffer.read_bytes(1).unwrap_err();
	assert_eq!(error.kind(), ErrorKind::UnexpectedEof);
}

#[test]
fn error_result() {
	let reader = ErrorReader;
	let mut buffer = DynReadBuffer::new(reader);
	
	let error = buffer.read_bytes(1).unwrap_err();
	assert_eq!(error.kind(), ErrorKind::NotFound);
}