mirror of
https://github.com/nabbar/golib.git
synced 2025-12-24 11:51:02 +08:00
3837f0b2bb
[file/bandwidth] - ADD documentation: add enhanced README and TESTING guidelines - ADD tests: complete test suites with benchmarks, concurrency, and edge cases [file/perm] - ADD documentation: add enhanced README and TESTING guidelines - ADD tests: complete test suites with benchmarks, concurrency, and edge cases - ADD function to parse form "rwx-wxr-x" or "-rwx-w-r-x" - ADD function to ParseFileMode to convert os.FileMode to file.Perm [file/progress] - ADD documentation: add enhanced README and TESTING guidelines - ADD tests: complete test suites with benchmarks, concurrency, and edge cases [ioutils/...] - UPDATE documentation: update enhanced README and TESTING guidelines - UPDATE tests: complete test suites with benchmarks, concurrency, and edge cases [logger/...] - UPDATE documentation: update enhanced README and TESTING guidelines - ADD documentation: add enhanced README and TESTING guidelines for sub packages - UPDATE tests: complete test suites with benchmarks, concurrency, and edge cases - UPDATE config: remove FileBufferSize from OptionFile (rework hookfile) - UPDATE fields: expose Store function in interface - REWORK hookfile: rework package, use aggregator to allow multi write and single file - FIX hookstderr: fix bug with NonColorable - FIX hookstdout: fix bug with NonColorable - FIX hookwriter: fix bug with NonColorable [network/protocol] - ADD function IsTCP, IsUDP, IsUnixLike to check type of protocol [runner] - FIX typo [socket] - UPDATE documentation: update enhanced README and TESTING guidelines - ADD documentation: add enhanced README and TESTING guidelines for sub packages - UPDATE tests: complete test suites with benchmarks, concurrency, and edge cases - REWORK server: use context compatible io.reader, io.writer, io.closer instead of reader / writer - REWORK server: simplify, optimize server - REMOVE reader, writer type - ADD context: add new interface in root socket interface to expose context interface that extend context, io reader/writer/closer, dediacted function to server (IsConnected, ...)
68 lines
2.6 KiB
Go
68 lines
2.6 KiB
Go
/*
|
|
* MIT License
|
|
*
|
|
* Copyright (c) 2025 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 multi
|
|
|
|
// DiscardCloser is an io.ReadWriteCloser that performs no-op operations.
|
|
//
|
|
// It implements:
|
|
// - io.Reader: Read always returns (0, nil) without reading any data
|
|
// - io.Writer: Write returns (len(p), nil) without writing any data
|
|
// - io.Closer: Close always returns nil
|
|
//
|
|
// DiscardCloser is used as a safe default input source in Multi instances
|
|
// to prevent nil pointer panics. It's similar to io.Discard but also
|
|
// implements io.ReadCloser.
|
|
//
|
|
// This type is exported for advanced use cases where a no-op ReadWriteCloser
|
|
// is needed, though most users should not need to instantiate it directly.
|
|
type DiscardCloser struct{}
|
|
|
|
// Read implements io.Reader by returning zero bytes without error.
|
|
// This allows DiscardCloser to satisfy the io.Reader interface while
|
|
// performing no actual read operation.
|
|
//
|
|
// The buffer p is not modified. This method always returns (0, nil).
|
|
func (d DiscardCloser) Read(p []byte) (n int, err error) {
|
|
return 0, nil
|
|
}
|
|
|
|
// Write implements io.Writer by accepting and discarding all data.
|
|
// It returns len(p) to indicate that all bytes were "written", but
|
|
// no data is actually stored or processed.
|
|
//
|
|
// This method always returns (len(p), nil).
|
|
func (d DiscardCloser) Write(p []byte) (n int, err error) {
|
|
return len(p), nil
|
|
}
|
|
|
|
// Close implements io.Closer with a no-op operation.
|
|
// Since DiscardCloser maintains no state and allocates no resources,
|
|
// Close simply returns nil without doing anything.
|
|
func (d DiscardCloser) Close() error {
|
|
return nil
|
|
}
|