Netstring is a library for packing and parsing netstrings, self-delimiting encoding of strings. The library is extremely simple and well-tested.
Netstrings may be used as a basic building block for reliable network protocols. Most high-level protocols, in effect, transmit a sequence of strings; those strings may be encoded as netstrings and then concatenated into a sequence of characters, which in turn may be transmitted over a reliable stream protocol such as TCP.
Netstring can be installed like any other Go package that supports Go modules.
Just go get the library:
go get github.com/kyrylo/netstringpackage main import ( "bufio" "bytes" "fmt" "log" "github.com/kyrylo/netstring" ) func main() { // The netstring is "8:sunshine," netstr := []byte{ 0x38, 0x3a, 0x73, 0x75, 0x6e, 0x73, 0x68, 0x69, 0x6e, 0x65, 0x2c, } // Create a reader. buf := bufio.NewReader(bytes.NewReader(netstr)) // Parse the "8:sunshine," into "sunshine". str, err := netstring.Parse(buf) if err != nil { log.Fatal(err) } // Output: "sunshine" fmt.Printf("Input netstring: %s\n", netstr) fmt.Printf(" Parsed string: %s\n", str) }package main import ( "fmt" "log" "github.com/kyrylo/netstring" ) func main() { s := []byte("sunshine") netstr, err := netstring.Pack(s) if err != nil { log.Fatal(err) } // netstr is "8:sunshine," // bytes: [0x38, 0x3a, 0x73, 0x75, 0x6e, 0x73, 0x68, 0x69, 0x6e, 0x65, 0x2c] fmt.Printf(" Input string: %s\n", s) fmt.Printf("Output netstring: %s\n", netstr) }The library supports Go v1.17+. The CI file would be the best source of truth because it contains all Go versions that are tested against.
In case you have a problem, question or a bug report, feel free to:
The project uses the MIT License. See LICENSE.md for details.