Files
golib/encoding/mux/interface.go
Nicolas JUHEL 9ca3530b1d Package Config/component/LDAP:
- replace mutex by atomic
- fix minor bugs & optimize code

Package Size:
- add function 'mul' allowing do a multiplaction on the size value by a float64 given value (could use another size.float64)
- add function 'div' allowing do a division of the size value by a float64 given value (could use another size.float64)
- add function 'add' allowing do an addtion of the size value with a uint64 given value (could use another size.uint64)
- add function 'sub' allowing do an substraction of the size value with a uint64 given value (could use another size.uint64)

Package Encoding:
- rework completly crypt package to new package encoding
- part aes of old crypt become new subpackage encoding/aes
- part hex of old crypt (associated with aes) become new standalone subpackage encoding/hexa
- adding new subpackage mux to use multiplexer/de-multiplexer of io stream
- mux is different of multireader / multiwriter in way as io send from mux in one channel will be received only in the coresponding channel  of de-mux
- mux is encoding subpackage becauxse based on hex + cbor marshalling / unmarshalling
- all subpackage can be used directly of by io reader / writer

Package Socket/server
- rework server to use as possible direct io to con
- rework server to optimize & fix managment (context / shutdown...)
- rework server to stop connection befor stopping server
- rework server to not load incoming and send it to handler by allowing handler to manager io input/output directly
- server not more used buff internally (less memory consuption)
- adding counter of opened connection
- adding some testing who's checking server & client for each protocol

Package Socket/client
- rework client to allow connect to server before reading/writing on io stream
- rework client to allow consum direct io stream instead of reading locally / call function
- rework client to allow having less memory consumption by removing internal buffer
- rework client allowing to use root io function (bufio, io copy, ...)

Package Socket/multi
- adding new subpackage multi to simplfy using of 1 reader / x writer
- if no writer is define, using an extended io discard
- allowing asynch instancing, populate writer and calling main writer
- allowing calling writer / reader to expose the main io reader / writer

Package Socket/delim:
- adding new subpackage delim to simplify using of bufio reader with delimiter
- using 1 writer / 1 reader
- allowing root io function like readwritecloser, writeto, ...
- use local buffer to prevent race if reader and writer are not is same process

Package PProf:
- fix missing \n in message

Package HttpServer:
- fix bug with init TLS & http2

Other:
- bump dependencies
2024-03-23 15:33:24 +01:00

102 lines
2.9 KiB
Go

/*
* MIT License
*
* Copyright (c) 2023 Nicolas JUHEL
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*
*
*/
package mux
import (
"bufio"
"errors"
"io"
)
var (
ErrInvalidInstance = errors.New("invalid de-multiplexer")
ErrInvalidChannel = errors.New("invalid channel key")
)
type Multiplexer interface {
// NewChannel returns an io.Writer that can be used to mux the given byte slice with other channel into the main writer
//
// key is a rune/byte parameter to identify the channel.
// io.Writer is the return type.
NewChannel(key rune) io.Writer
}
// NewMultiplexer creates a new Multiplexer with the given io.Writer and delimiter.
//
// w: io.Writer to write to.
// delim: byte delimiter to use.
// Returns a Multiplexer.
func NewMultiplexer(w io.Writer, delim byte) Multiplexer {
return &mux{
w: w,
d: delim,
}
}
type DeMultiplexer interface {
io.Reader
// Copy launch a continuously reading from the main io.Reader and writing to the correct channel io.Writer
// A good use case is to use it in a goroutine.
//
// returns any error.
Copy() error
// NewChannel registers a new channel to the given io.Writer for the given key as discriminant
//
// Parameters:
// key is a rune/byte parameter to identify the channel.
// w io.Writer the io.writer to write to.
NewChannel(key rune, w io.Writer)
}
// NewDeMultiplexer creates a new DeMultiplexer using the given io.Reader, delimiter byte, and optional buffer size.
// If the buffer size is 0, a default buffer size of 4096 will be used.
//
// Parameters:
//
// r io.Reader - the input reader
// delim byte - the delimiter byte used to identify each block of data
// size int - the buffer size
//
// Return type: DeMultiplexer
func NewDeMultiplexer(r io.Reader, delim byte, size int) DeMultiplexer {
var rb *bufio.Reader
if size > 0 {
rb = bufio.NewReaderSize(r, size)
} else {
rb = bufio.NewReader(r)
}
return &dmux{
r: rb,
d: delim,
m: make(map[rune]io.Writer),
}
}