bin

Bin

A format for binary data, like protobuf

Encoder

This implements encoding and takes an io.Writer.

Decoder

This implements decoding and takes an io.Reader.

Struct

A map where it can translate into a struct with the help of the tag.

Usage

Encoder

• Encode - Takes an interface{} and writes to io.Writer, returns an error if value is invalid.
• _struct - Takes a reflect.Value and a boolean if kind is required to write into io.Writer, returns an error if value is either invalid or tag is not a number.

Decoder

• Decode - Takes an interface{} and decodes from io.Reader, returs an error if value is invalid or value is not settable or io.Reader read an invalid VarUint.
• ReadByte - Returns a byte and an io.EOF if io.Read is done.
• _struct - Takes a reflect.Value and decodes each struct field, might return an error as the same for Decode.

Struct

• Map - Returns a map representing the struct.
• Get - Returns the key and a status.
• As - Takes an interface{} and sets what the interface{} has, it will do nothing if the interface is not a struct.
• Sub - Takes a tag and an interface{} and sets the interface with the value from the tag.
• _map - Takes an interface{} of a map and deference it, returns map[interface{}]interface{}
• fields - Takes a struct and map its fields by their tag, returns map[tag]field
• rangeFields - Takes fields map and check the values if possible to set, converting if required, if not continue.
• ptr - Matches the reflect.Value of the field.

Utilities

• Value - Takes an interface{} and returns reflect.Value, if interface is already return it back, else get the absolute value of the interface{}.
• Zero - Initializes a reflect.Value.
• Abs[T] - Gets absolute reflect.Type or reflect.Value.
• Marshal - Takes interface{} and returns bytes, returns error as the same as Encoder.
• Unmarshal[T] - Takes []byte and decodes into T, returns error as the same as Decoder.
• Interface - Takes an interface{} and returns reflect.Value.
• VarIntIn[T] - Takes int and uint ranges and an io.Writer and returns bytes, error if io.Writer is done.
• VarIntOut - Must disclosure the type and takes an io.ByteReader, returns the number and an error if io.Reader of Decoder is done.
• typeFromKind - Important for decoding, if not a basic type returns nil.
• _interface - Takes a reflect.Value and switches to interface{} whatever is needed, returns itself.

Example

package main

import (
	"fmt"
	"github.com/Dviih/bin"
	"reflect"
)

type Example struct {
	Twenty  int    `bin:"20"`
	Fifth   []int  `bin:"50"`
	Hundred string `bin:"100"`
}

func main() {
	example := &Example{
		Twenty:  20,
		Fifth:   []int{5, 0},
		Hundred: "A hundred",
	}

	data, err := bin.Marshal(example)
	if err != nil {
		panic(err)
	}

	fmt.Println(data)

	example2, err := bin.Unmarshal[*Example](data)
	if err != nil {
		panic(err)
	}

	fmt.Printf("%+v\n", example2)
	fmt.Println("Equal", reflect.DeepEqual(example, example2))
}

Made for Gophers by @Dviih