ConstantStream 1.0.14

ConstantStream

A collection of fake streams for testing purposes.

Types

The library have three fake stream types:

• ConstantByteStream: A fake stream that generate a finite set of the same bytes.
• ConstantStrideStream: A fake stream that generate a byte stride in a loop.
• TimedStream: A fake constant byte stream that waits in determined positions.

Utility streams:

• SubStream: a substream is a small window to the base stream.
• CountedStream: record all the bytes readed.

For example:

// The constant byte stream
var cbs = ConstantByteStream(5, (byte) 'A'); 
// Should return  "AAAAA"
string text = (new StreamReader(cbs)).ReadToEnd() ;

// The constant stride stream
// Should read as "ABCABCABCA"
ConstantStrideStream(10, Encoding.UTF8.GetBytes("ABC")); 

// The TimedStream: just like a constant byte stream
var timedStream = new TimedStream(1024, (byte)'c'); 

// add a wait in position 0 of 200 ms
timedStream.Delays.Add(0, TimeSpan.FromMilliseconds(200)); 
// add a wait in position 15 of 250 ms
timedStream.Delays.Add(15, TimeSpan.FromMilliseconds(250)); 
// add a wait in position 1000 of 1 min
timedStream.Delays.Add(1000, TimeSpan.FromMinutes(1)); 
// the timedStream should take about 1 minute + 450 ms + reading overhead(ms) to read in total

Usage

using ConstantStream;

// Creates a 1 Mb stream of zeroes.
var zeroesStream = new ConstantByteStream(1024*1024, (byte)0);

// Creates a 1 Gb stream full of 's'.
var sStream = new ConstantByteStream(1024*1024*1024, (byte)'s');

// Handy factory methods (From*) for ConstantByteStream
// 1 Mb of zeroes
var zeroesStreamEasy = ConstantByteStream.FromZeroes(1024*1024);
// 1 Kb of ones 
var onesStreamEasy = ConstantByteStream.FromOnes(1024); 
// 42 bytes of 'a'
var onesStreamEasy = ConstantByteStream.FromFromA(42); 


// Handy factory methods (From*) for ConstantStrideStream
// 01234567890123456... numbers from 0 to 9 in a loop
var zeroesStreamEasy = ConstantStrideStream.FromNumbers(1024*1024); 
// abcdefghijkl.... alphabet in a loop
var zeroesStreamEasy = ConstantStrideStream.FromAlphabet(1024); 

Info

The Stream doesnt have a base stream. Its a fake generator and provide a simple Stream that generates large amounts of data. It can be used with stream readers like TextReader, copyTo(file), HttpBody, crypto readers, and compression readers.