StreamLib

Streaming I/O for stdio, memory blocks and files in zip archives. Supports memory mapping where available, and transparent gzip decompression.

module		gzip	open	read	write	seek	eof	tell	mmap	munmap	close
mem	R	no	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔
	R	yes	☑️	☑️	⛔	☑️1	☑️	☑️	☑️2	☑️2	☑️
	W	no	☑️	☑️	☑️	☑️	☑️	☑️	☑️	☑️	☑️
	W	yes	☑️	⛔	☑️	☑️3	⛔	☑️	⛔	⛔	☑️
	RW	no	☑️	☑️	☑️	☑️	☑️	☑️	☑️	☑️	☑️
	RW	yes	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔
file	R	no	☑️	☑️	⛔	☑️	☑️	☑️	☑️	☑️	☑️
	R	yes	☑️	☑️	⛔	☑️1	☑️	☑️	☑️2	☑️2	☑️
	W	no	☑️	⛔	☑️	☑️	☑️	☑️	☑️	☑️	☑️
	W	yes	☑️	⛔	☑️	☑️3	⛔	☑️	⛔	⛔	☑️
	RW	no	☑️	☑️	☑️	☑️	☑️	☑️	☑️	☑️	☑️
	RW	yes	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔
zip_file	R	no	☑️	☑️	⛔	☑️4	☑️	☑️	☑️	☑️	☑️
	R	yes	☑️	☑️	⛔	☑️14	☑️	☑️	☑️2	☑️2	☑️
	W	no	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔
	W	yes	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔
	RW	no	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔
	RW	yes	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔	⛔

Building

1. Clone the repository:

   git clone https://github.com/vampirefrog/streamlib.git
   cd streamlib

2. Install dependencies:

   sudo apt install libzip-dev zlib1g-dev

3. Compile the library:

   make HAVE_LIBZIP=1 HAVE_GZIP=1

Footnotes

1. Slow ↩ ↩² ↩³

2. Slurp into memory block ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶

3. Forward only ↩ ↩²

4. Uncompressed data only ↩ ↩²