README.md

go-strm

A library that provides an opinionated framework for processing both finite and infinite data tables as streams, for the Go programming language.

Documention

Online documentation, which includes examples, can be found at: http://godoc.org/github.com/reiver/go-strm

Example

package main

import (
	. "github.com/reiver/go-strm"
	. "github.com/reiver/strm-append"
	. "github.com/reiver/strm-csv"
	. "github.com/reiver/strm-head"
	. "github.com/reiver/strm-select"
	. "github.com/reiver/strm-stdout"
)

func main() {
	Begin(CSV, "table.csv").
		Strm(HEAD, 100).
		Strm(SELECT, "color", "size").
		Strm(APPEND, "blue",  5).
	End(STDOUT, "tsv")
}

(Note that in that example dot imports were used.)

Drivers

go-strm is only useful with drivers. Here is a list of some drivers:

• APPEND Returns all rows, with a new row appended to the end of the data table stream. https://github.com/reiver/strm-append
• HEAD Returns rows from the beginning of the data table stream. https://github.com/reiver/strm-head
• MAP Returns rows that result from applying a func to each row in the origin data table stream. https://github.com/reiver/strm-map
• SELECT Returns all rows but with only certain columns and in a certain order. https://github.com/reiver/strm-select
• SKIP Skips rows from the beginning of the data table stream, and returns everything after that. https://github.com/reiver/strm-skip
• TAIL Return rows from the end of the data table stream. https://github.com/reiver/strm-tail