mirror of
https://github.com/nabbar/golib.git
synced 2025-12-24 11:51:02 +08:00
Global Repos / Workflow - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - UPDATE workflow: split old workflow into multiple files - UPDATE .gitignore: added cluster.old.tar.gz and build artifacts - UPDATE .golangci.yml: enhanced linter rules and disabled deprecated linters [archive] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - FIX extract: recursive decompression for nested archives (e.g., .tar.gz handling) - FIX extract: ZIP archive support now properly uses ReaderAt interface with seek reset - ADD extract: proper symlink and hard link handling in archives - UPDATE tar/writer: improved error handling and file mode preservation - UPDATE zip/writer: enhanced validation and error messages - UPDATE compress/interface: added support for additional compression formats - UPDATE helper/compressor: fixed typo in error handling [artifact] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE artifact: improved error handling and context management - UPDATE client/interface: enhanced API with better type safety and context propagation - UPDATE client/model: refactored for better maintainability - UPDATE github: removed unused error codes, improved model validation - UPDATE gitlab: enhanced API pagination and error handling - UPDATE jfrog: improved artifactory API compatibility - UPDATE s3aws: enhanced S3 bucket operations and error messages [atomic] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE cast: improved type conversion with better error handling - UPDATE interface: enhanced atomic operations with generics support - UPDATE synmap: fixed race conditions in concurrent access patterns - UPDATE value: improved atomic value operations with better memory ordering [aws] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE bucket: enhanced ACL and CORS configuration with validation - UPDATE configAws/models: improved credential handling and region configuration - UPDATE configCustom/interface: added support for custom endpoints - UPDATE http/request: improved retry logic and timeout handling - UPDATE interface: enhanced AWS client with context propagation - UPDATE model: refactored for AWS SDK v2 compatibility - UPDATE multipart/interface: improved chunk handling for large uploads - UPDATE pusher: optimized hash calculation and upload progress tracking - UPDATE resolver: enhanced endpoint resolution with custom DNS - DELETE test files: removed bucket_test.go, group_test.go, object_test.go, policy_test.go, role_test.go, user_test.go [cache] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - ADD context: context-aware cache lifecycle management - UPDATE interface: complete rewrite with Go generics for type-safe key-value operations - ADD item package: generic cache item with expiration tracking (interface and model) - UPDATE model: refactored to use generics (Cache[K comparable, V any]) - REFACTOR: split item.go into modelAny.go for better code organization [certificates] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE auth/encode: improved PEM encoding with better error messages - UPDATE auth/interface: enhanced authentication certificate handling - UPDATE ca: improved CA certificate generation and validation - UPDATE certs: enhanced certificate configuration with SAN support - UPDATE cipher: improved cipher suite selection and validation - UPDATE curves: enhanced elliptic curve handling with additional curves - ADD deprecated.go: marked deprecated TLS versions and cipher suites - UPDATE interface: enhanced certificate interface with context support - UPDATE model: improved certificate model with better validation - UPDATE rootca: enhanced root CA pool management - UPDATE tlsversion: added TLS 1.3 support with proper validation - UPDATE tools: improved certificate utility functions [cobra] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE completion: improved shell completion generation (bash, zsh, fish, powershell) - UPDATE configure: enhanced configuration file handling - UPDATE printError: improved error formatting with color support - UPDATE interface: enhanced cobra interface with context support - UPDATE model: improved cobra model with better validation [config] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE components: improved component lifecycle management - UPDATE const/const: improved constant definitions - UPDATE context: enhanced context handling with better propagation - UPDATE errors: improved error definitions - UPDATE events: enhanced event management - UPDATE manage: improved configuration management with validation - UPDATE model: refactored config model - UPDATE shell: enhanced shell integration for interactive configuration - UPDATE types: improved component and componentList types [console] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - ADD buff.go: BuffPrintf function for colored output to io.Writer (moved from ioutils/multiplexer) - DELETE color.go: removed legacy color file (consolidated functionality) - UPDATE error: improved error definitions with better messages - ADD interface: console interface for abstraction - ADD model: console model for state management - UPDATE padding: enhanced string padding with Unicode support - UPDATE prompt: improved interactive prompt handling [context] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - DELETE config.go: removed deprecated configuration (replaced by Config[T] interface) - UPDATE context: improved context handling with better cancellation support - UPDATE gin/interface: enhanced Gin context integration with type safety - ADD helper: context helper functions for common operations - ADD interface: generic Config[T comparable] interface for type-safe context storage - ADD map: MapManage[T] interface for concurrent-safe map operations - ADD model: thread-safe context model implementation with sync.Map [database] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE gorm/config: improved database configuration - UPDATE gorm/driver: enhanced database driver with better connection pooling - UPDATE gorm/driver_darwin: macOS-specific database optimizations - UPDATE gorm/interface: improved GORM interface with context support - UPDATE gorm/model: refactored model for better maintainability - UPDATE gorm/monitor: enhanced monitoring for database connections - UPDATE kvtypes: improved types for key-value store (compare, driver, item, table) [duration] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE big: enhanced big.Duration for large time spans with arithmetic operations - UPDATE encode: improved marshaling for JSON, YAML, TOML, Text, CBOR - UPDATE format: enhanced human-readable formatting (ns, μs, ms, s, m, h, d, w) - UPDATE interface: improved duration interface with arithmetic methods - UPDATE model: refactored Duration type - UPDATE operation: enhanced arithmetic operations (Add, Sub, Mul, Div) - UPDATE parse: improved parsing with multiple format support - UPDATE truncate: enhanced truncation for rounding durations [encoding] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE aes: improved AES encryption with reader/writer interfaces - UPDATE hexa: enhanced hexadecimal encoding with better error handling - UPDATE mux: improved multiplexer/demultiplexer for stream handling - UPDATE randRead: enhanced random data generation - UPDATE sha256 package: SHA-256 hashing with reader/writer interfaces [errors] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - ADD pool package: thread-safe error pool for collecting multiple errors with concurrent access - UPDATE code: improved error code definition and lookup - UPDATE errors: enhanced error creation with better stack trace - UPDATE interface: improved error interface with more methods - UPDATE mode: enhanced error mode handling (production vs development) - UPDATE return: improved error return handling with context - UPDATE trace: enhanced error tracing with file and line information [file] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE bandwidth: improved bandwidth tracking with concurrency tests - UPDATE perm: enhanced file permission handling with Unix/Windows support - UPDATE perm/encode: improved marshaling for JSON, YAML, TOML - UPDATE perm/format: enhanced permission formatting (e.g., "rwxr-xr-x") - UPDATE perm/parse: improved parsing of permission strings and octal values - UPDATE progress: enhanced progress tracking for file I/O operations - UPDATE progress/io*: improved reader, writer, seeker, closer interfaces with progress callbacks [ftpclient] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE config: improved FTP configuration with TLS support - UPDATE errors: enhanced error definitions - UPDATE interface: improved FTP client interface - UPDATE model: refactored FTP client model [httpcli] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE cli: improved HTTP client with retry logic and timeout handling - UPDATE dns-mapper: enhanced DNS mapping for custom resolution - UPDATE dns-mapper/config: improved DNS mapper configuration - UPDATE dns-mapper/errors: enhanced error handling - UPDATE dns-mapper/interface: improved DNS mapper interface - UPDATE dns-mapper/transport: enhanced HTTP transport with DNS override - UPDATE errors: improved error definitions - UPDATE options: enhanced client options with context support [httpserver] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE config: improved server configuration with TLS and middleware support - UPDATE handler: enhanced request handler with better error handling - UPDATE interface: improved server interface with context support and monitoring integration - UPDATE model: refactored server model with better validation - UPDATE monitor: enhanced monitoring integration with status tracking - UPDATE pool: improved server pool management (config, interface, list, model) - UPDATE run: enhanced server runtime with graceful shutdown - UPDATE server: improved core server implementation with better lifecycle - ADD testhelpers/certs.go: certificate generation utilities for testing - UPDATE types: improved const, fields, and handler types [ioutils] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE bufferReadCloser: improved buffered reader/writer with closer - UPDATE fileDescriptor: enhanced file descriptor limit management (platform-specific for Linux/macOS/Windows) - UPDATE ioprogress: improved progress tracking for I/O operations - UPDATE iowrapper: enhanced I/O wrapper with custom interfaces - UPDATE mapCloser: improved map of closers for resource management - UPDATE maxstdio: enhanced C implementation for max stdio file descriptor retrieval - DELETE multiplexer/model.go: removed legacy multiplexer (functionality moved to console/buff.go and retro/) - UPDATE nopwritecloser: improved no-op write closer - UPDATE tools: enhanced I/O utility functions [ldap] - UPDATE ldap: improved LDAP client with better connection handling and search operations [logger] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE config: improved default values, file options, and syslog configuration - UPDATE entry/interface: enhanced log entry with context support - UPDATE fields: improved field handling with JSON cloning - UPDATE gorm/interface: enhanced GORM logger with trace ID support - UPDATE hashicorp/interface: improved HashiCorp logger integration - FIX hookfile/system: use os.OpenRoot for secure file operations (prevents path traversal) - FIX hookfile/system: fixed import path from libsrv "golib/server" to "golib/runner" - ADD hookfile: IsRunning() method to track file hook state - UPDATE hookstderr/interface: enhanced stderr hook with better buffering - UPDATE hookstdout/interface: enhanced stdout hook with better buffering - UPDATE hooksyslog: improved syslog integration with channel and priority handling - ADD hookwriter package: generic io.Writer hook for custom output destinations - UPDATE interface: enhanced logger interface with context propagation - UPDATE level: improved log level handling and comparison - UPDATE log: enhanced logging with better formatting - UPDATE manage: improved logger lifecycle management - UPDATE model: refactored logger model for better maintainability [mail] - UPDATE sender: improved mail sender with better MIME handling - UPDATE interface: enhanced interface with monitoring support - UPDATE monitor: added monitoring integration for mail operations [monitor] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - ADD status package: new subpackage for status management with Status type (KO, Warn, OK) - ADD status/encode: marshaling support for JSON, YAML, TOML, Text, CBOR - ADD status/format: human-readable status formatting - ADD status/interface: Status type with Parse and String methods - UPDATE encode: improved encoding with better error handling - UPDATE error: enhanced error definitions - UPDATE info: improved system info collection (CPU, mem, disk, network) - UPDATE interface: enhanced monitor interface with status support and better component integration - UPDATE metrics: improved metrics collection and export - UPDATE middleware: enhanced monitoring middleware for HTTP - UPDATE pool/interface: enhanced pool interface with better monitoring integration - UPDATE pool/metrics: improved metrics collection in pool - UPDATE pool/model: refactored pool model for better maintainability - UPDATE pool/pool: enhanced pool implementation with better lifecycle - UPDATE server: enhanced server monitoring with status tracking - UPDATE types/monitor: improved monitor type definitions [nats] - UPDATE client: improved NATS client with better subscription handling - UPDATE config: enhanced NATS configuration with cluster support - UPDATE monitor: added monitoring integration for NATS operations - UPDATE server: improved NATS server integration with monitoring [network] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE bytes: improved byte size handling for network operations - UPDATE number: enhanced number utilities for network data - UPDATE protocol/encode: improved protocol encoding - ADD protocol/format: protocol formatting utilities - UPDATE protocol/interface: enhanced protocol interface - UPDATE protocol/model: refactored protocol model [password] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE password: improved password utilities with strength validation and secure generation [pidcontroller] - UPDATE interface: improved PID controller interface - UPDATE model: enhanced PID controller model with better tuning parameters [pprof] - UPDATE tools: improved pprof utilities for profiling integration [prometheus] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE bloom/bloom: improved bloom filter with better concurrency handling - UPDATE bloom/collection: enhanced bloom filter collection operations - UPDATE interface: enhanced prometheus interface with better type safety - UPDATE metrics/interface: enhanced metrics interface with better registration - UPDATE metrics/model: refactored metrics model for better maintainability - UPDATE model: refactored prometheus model with better validation - UPDATE pool: enhanced metric pool with concurrent access - UPDATE pool/interface: enhanced pool interface - UPDATE pool/model: refactored pool model - UPDATE route: improved routing for metric endpoints - UPDATE types: enhanced type definitions for metrics - UPDATE webmetrics: improved existing metrics (requestBody, requestIPTotal, requestLatency, requestSlow, requestTotal, requestURITotal, responseBody) - ADD webmetrics/activeConnections: gauge for tracking concurrent HTTP connections - ADD webmetrics/requestErrors: counter for HTTP request errors - ADD webmetrics/responseSizeByEndpoint: histogram for response size distribution by endpoint - ADD webmetrics/statusCodeTotal: counter for HTTP status codes [request] - UPDATE interface: enhanced request interface with better type safety - UPDATE model: refactored request model for better maintainability - UPDATE options: improved request options with better validation - UPDATE url: enhanced URL handling with better parsing [retro] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE encoding: improved encoding utilities with better format support - UPDATE format: enhanced formatting functions for retro compatibility - UPDATE model: refactored retro model with better validation - UPDATE utils: improved utility functions for version handling - UPDATE version: enhanced version utilities for retro compatibility [router] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE auth/interface: enhanced authentication interface with better validation - UPDATE auth/model: improved authentication model - UPDATE authheader/interface: enhanced authentication header interface - UPDATE default: improved default router configuration - UPDATE error: enhanced error definitions for router - UPDATE header/config: improved header configuration - UPDATE header/interface: enhanced header interface - UPDATE header/model: refactored header model - UPDATE interface: improved router interface with better type safety - UPDATE middleware: improved router middleware with better error handling - UPDATE model: refactored router model for better maintainability - UPDATE router: enhanced core router implementation - UPDATE tools: enhanced router utilities for route registration [runner] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE package: move package for lifecycle management of long-running services (moved from server/runner) - ADD interface: Runner interface with Start, Stop, Restart, IsRunning, and Uptime methods - ADD startStop package: service lifecycle with blocking start and graceful stop (interface, model, comprehensive tests) - ADD ticker package: periodic task execution at regular intervals (interface, model, comprehensive tests) - ADD tests: concurrency, construction, errors, lifecycle, and uptime tests for both startStop and ticker - ADD tools: RecoveryCaller for panic recovery in goroutines [semaphore] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - FIX bar/bar: Dec method now properly decrements (was calling Inc64, now calls Dec64 with negative value) - UPDATE bar: improved progress bar with better MPB integration - UPDATE bar/context: enhanced context handling for cancellation - UPDATE bar/interface: added methods for Total() and better progress tracking - UPDATE bar/model: improved model with atomic operations - UPDATE bar tests: enhanced bar_operations_test, edge_cases_test, integration_test, and semaphore_test - UPDATE context: enhanced context propagation - UPDATE interface: improved semaphore interface with weighted operations - UPDATE model: refactored model for better thread safety - UPDATE progress: enhanced progress tracking with multiple bars - UPDATE sem/interface: added IsRunning() method for state tracking - UPDATE sem/ulimit: improved ulimit handling for file descriptors - UPDATE sem/weighted: enhanced weighted semaphore operations - UPDATE types: improved type definitions for bar, progress, and semaphore [server] - REFACTOR: moved runner subpackage to root-level runner package - DELETE: empty package after moved runner subpackage [shell] - UPDATE goprompt: improved interactive prompt handling with better input validation [size] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - ADD arithmetic.go: NEW file with arithmetic operations (Add, Sub, Mul, Div with overflow detection) - UPDATE encode: improved marshaling for JSON, YAML, TOML, Text, CBOR - UPDATE format: enhanced human-readable formatting (B, KB, MB, GB, TB, PB, EB) - UPDATE interface: added arithmetic methods (Mul, MulErr, Div, DivErr, Add, AddErr, Sub, SubErr) - UPDATE model: refactored Size type with better validation - UPDATE parse: improved parsing with unit detection (IEC and SI standards) [smtp] - UPDATE client: improved SMTP client with better error handling - UPDATE config: enhanced configuration with validation - UPDATE config/error: improved error definitions - UPDATE config/interface: enhanced interface with context support - UPDATE config/model: refactored model for better maintainability - UPDATE interface: improved SMTP interface with monitoring support - UPDATE monitor: added monitoring integration for SMTP operations - DELETE network/network.go: removed legacy network handling (consolidated into client) - UPDATE tlsmode/tls: enhanced TLS mode handling (None, TLS, StartTLS) - UPDATE types/interface: improved type interface [socket] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - ADD client/interface_darwin: macOS-specific socket client options - UPDATE client/interface_linux: platform-specific socket options for Linux - UPDATE client/interface_other: platform-specific socket options for other platforms - UPDATE client/tcp/error: improved TCP client error handling - UPDATE client/tcp/interface: enhanced TCP client interface - UPDATE client/tcp/model: improved TCP client model - UPDATE client/udp/error: improved UDP client error handling - UPDATE client/udp/interface: enhanced UDP client interface - UPDATE client/udp/model: improved UDP client model - UPDATE client/unix/error: improved Unix socket client error handling - UPDATE client/unix/ignore: enhanced ignore functionality - UPDATE client/unix/interface: enhanced Unix socket client interface - UPDATE client/unix/model: improved Unix socket client model - UPDATE client/unixgram/error: improved Unix datagram client error handling - UPDATE client/unixgram/ignore: enhanced ignore functionality - UPDATE client/unixgram/interface: enhanced Unix datagram client interface - UPDATE client/unixgram/model: improved Unix datagram client model - UPDATE config/client: improved client configuration - UPDATE config/server: improved server configuration - DELETE delim: moved legacy delimiter to I/O package - UPDATE interface: improved socket interface - UPDATE io: enhanced I/O operations - DELETE multi: moved legacy multi to I/O package - ADD server/interface_darwin: macOS-specific socket server options - UPDATE server/interface_linux: platform-specific server options for Linux - UPDATE server/interface_other: platform-specific server options for other platforms - UPDATE server/tcp/error: improved TCP server error handling - UPDATE server/tcp/interface: enhanced TCP server interface - UPDATE server/tcp/listener: improved TCP server listener - UPDATE server/tcp/model: improved TCP server model - UPDATE server/udp/error: improved UDP server error handling - UPDATE server/udp/interface: enhanced UDP server interface - UPDATE server/udp/listener: improved UDP server listener - UPDATE server/udp/model: improved UDP server model - UPDATE server/unix/error: improved Unix socket server error handling - UPDATE server/unix/ignore: enhanced ignore functionality - UPDATE server/unix/interface: enhanced Unix socket server interface - UPDATE server/unix/listener: improved Unix socket server listener - UPDATE server/unix/model: improved Unix socket server model - UPDATE server/unixgram/error: improved Unix datagram server error handling - UPDATE server/unixgram/ignore: enhanced ignore functionality - UPDATE server/unixgram/interface: enhanced Unix datagram server interface - UPDATE server/unixgram/listener: improved Unix datagram server listener - UPDATE server/unixgram/model: improved Unix datagram server model [static] - UPDATE interface: improved static interface with monitoring support - UPDATE model: refactored static model - UPDATE monitor: added monitoring integration for static file operations [status] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE cache: improved status cache with better synchronization - UPDATE config: improved status configuration - UPDATE control/encode: improved control encoding - UPDATE control/interface: enhanced control interface with status tracking - UPDATE control/model: refactored control model - UPDATE encode: improved status encoding - UPDATE error: enhanced error definitions for status - UPDATE info: improved status info handling - UPDATE interface: enhanced status interface - UPDATE listmandatory/interface: improved list mandatory interface - UPDATE listmandatory/model: refactored list mandatory model - UPDATE mandatory/interface: enhanced mandatory interface - UPDATE mandatory/model: refactored mandatory model - UPDATE model: refactored status model - UPDATE pool: improved status pool - UPDATE route: enhanced status route handling [test] - DELETE: all manual tests are or will be replaced by proper automated test suites in respective packages [version] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE error: improved error definitions for version - UPDATE license: enhanced license handling - UPDATE version: improved version utilities [viper] - ADD/UPDATE documentation: comprehensive documentation with monitoring patterns - ADD/UPDATE tests: enhanced benchmark, config, encoding, example, integration, lifecycle, metrics, security, transitions - UPDATE interface: enhanced viper interface with context support - UPDATE model: refactored viper model for better maintainability
493 lines
12 KiB
Go
493 lines
12 KiB
Go
/*
|
|
* MIT License
|
|
*
|
|
* Copyright (c) 2020 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 aws_test
|
|
|
|
import (
|
|
"bytes"
|
|
"sync"
|
|
"time"
|
|
|
|
libsiz "github.com/nabbar/golib/size"
|
|
. "github.com/onsi/ginkgo/v2"
|
|
. "github.com/onsi/gomega"
|
|
)
|
|
|
|
var _ = Describe("S3 Stress Tests", func() {
|
|
BeforeEach(func() {
|
|
err := cli.Bucket().Check()
|
|
Expect(err).NotTo(HaveOccurred())
|
|
})
|
|
|
|
Describe("Concurrent operations", func() {
|
|
Context("Concurrent uploads", func() {
|
|
It("should handle 10 concurrent small uploads", func() {
|
|
const numUploads = 10
|
|
var wg sync.WaitGroup
|
|
errors := make(chan error, numUploads)
|
|
keys := make([]string, numUploads)
|
|
|
|
wg.Add(numUploads)
|
|
for i := 0; i < numUploads; i++ {
|
|
keys[i] = "concurrent-small-" + GenerateUniqueName("") + ".dat"
|
|
go func(idx int, key string) {
|
|
defer wg.Done()
|
|
defer GinkgoRecover()
|
|
|
|
content := bytes.Repeat([]byte("test"), 1024) // 4KB
|
|
err := cli.Object().Put(key, bytes.NewReader(content))
|
|
if err != nil {
|
|
errors <- err
|
|
}
|
|
}(i, keys[i])
|
|
}
|
|
|
|
wg.Wait()
|
|
close(errors)
|
|
|
|
// Check for errors
|
|
for err := range errors {
|
|
Expect(err).NotTo(HaveOccurred())
|
|
}
|
|
|
|
// Cleanup
|
|
for _, key := range keys {
|
|
_ = cli.Object().Delete(false, key)
|
|
}
|
|
})
|
|
|
|
It("should handle 5 concurrent large uploads", func() {
|
|
const numUploads = 5
|
|
var wg sync.WaitGroup
|
|
errors := make(chan error, numUploads)
|
|
keys := make([]string, numUploads)
|
|
|
|
wg.Add(numUploads)
|
|
for i := 0; i < numUploads; i++ {
|
|
keys[i] = "concurrent-large-" + GenerateUniqueName("") + ".dat"
|
|
go func(idx int, key string) {
|
|
defer wg.Done()
|
|
defer GinkgoRecover()
|
|
|
|
// 20MB each
|
|
err := cli.Object().MultipartPut(key, randContent(20*libsiz.SizeMega))
|
|
if err != nil {
|
|
errors <- err
|
|
}
|
|
}(i, keys[i])
|
|
}
|
|
|
|
wg.Wait()
|
|
close(errors)
|
|
|
|
// Check for errors
|
|
for err := range errors {
|
|
Expect(err).NotTo(HaveOccurred())
|
|
}
|
|
|
|
// Cleanup
|
|
for _, key := range keys {
|
|
_ = cli.Object().Delete(false, key)
|
|
}
|
|
})
|
|
})
|
|
|
|
Context("Concurrent reads", func() {
|
|
var testKey string
|
|
|
|
BeforeEach(func() {
|
|
testKey = "concurrent-read-" + GenerateUniqueName("") + ".dat"
|
|
content := bytes.Repeat([]byte("test-content"), 1024) // ~12KB
|
|
err := cli.Object().Put(testKey, bytes.NewReader(content))
|
|
Expect(err).NotTo(HaveOccurred())
|
|
})
|
|
|
|
AfterEach(func() {
|
|
_ = cli.Object().Delete(false, testKey)
|
|
})
|
|
|
|
It("should handle 20 concurrent reads", func() {
|
|
const numReads = 20
|
|
var wg sync.WaitGroup
|
|
errors := make(chan error, numReads)
|
|
|
|
wg.Add(numReads)
|
|
for i := 0; i < numReads; i++ {
|
|
go func() {
|
|
defer wg.Done()
|
|
defer GinkgoRecover()
|
|
|
|
output, err := cli.Object().Get(testKey)
|
|
if err != nil {
|
|
errors <- err
|
|
return
|
|
}
|
|
if output != nil && output.Body != nil {
|
|
_ = output.Body.Close()
|
|
}
|
|
}()
|
|
}
|
|
|
|
wg.Wait()
|
|
close(errors)
|
|
|
|
// Check for errors
|
|
for err := range errors {
|
|
Expect(err).NotTo(HaveOccurred())
|
|
}
|
|
})
|
|
|
|
It("should handle concurrent Head requests", func() {
|
|
const numRequests = 30
|
|
var wg sync.WaitGroup
|
|
errors := make(chan error, numRequests)
|
|
|
|
wg.Add(numRequests)
|
|
for i := 0; i < numRequests; i++ {
|
|
go func() {
|
|
defer wg.Done()
|
|
defer GinkgoRecover()
|
|
|
|
_, err := cli.Object().Head(testKey)
|
|
if err != nil {
|
|
errors <- err
|
|
}
|
|
}()
|
|
}
|
|
|
|
wg.Wait()
|
|
close(errors)
|
|
|
|
// Check for errors
|
|
for err := range errors {
|
|
Expect(err).NotTo(HaveOccurred())
|
|
}
|
|
})
|
|
})
|
|
|
|
Context("Mixed concurrent operations", func() {
|
|
It("should handle mixed read/write operations", func() {
|
|
const numOps = 15
|
|
var wg sync.WaitGroup
|
|
errors := make(chan error, numOps)
|
|
keys := make([]string, numOps/3)
|
|
|
|
// Upload some objects first
|
|
for i := 0; i < numOps/3; i++ {
|
|
keys[i] = "mixed-ops-" + GenerateUniqueName("") + ".dat"
|
|
err := cli.Object().Put(keys[i], bytes.NewReader([]byte("initial content")))
|
|
Expect(err).NotTo(HaveOccurred())
|
|
}
|
|
|
|
wg.Add(numOps)
|
|
|
|
// Mix of uploads
|
|
for i := 0; i < numOps/3; i++ {
|
|
go func(idx int) {
|
|
defer wg.Done()
|
|
defer GinkgoRecover()
|
|
|
|
key := "mixed-upload-" + GenerateUniqueName("") + ".dat"
|
|
err := cli.Object().Put(key, bytes.NewReader([]byte("concurrent upload")))
|
|
if err != nil {
|
|
errors <- err
|
|
}
|
|
defer func() { _ = cli.Object().Delete(false, key) }()
|
|
}(i)
|
|
}
|
|
|
|
// Mix of reads
|
|
for i := 0; i < numOps/3; i++ {
|
|
go func(idx int) {
|
|
defer wg.Done()
|
|
defer GinkgoRecover()
|
|
|
|
if idx < len(keys) {
|
|
output, err := cli.Object().Get(keys[idx])
|
|
if err != nil {
|
|
errors <- err
|
|
return
|
|
}
|
|
if output != nil && output.Body != nil {
|
|
_ = output.Body.Close()
|
|
}
|
|
}
|
|
}(i)
|
|
}
|
|
|
|
// Mix of Head requests
|
|
for i := 0; i < numOps/3; i++ {
|
|
go func(idx int) {
|
|
defer wg.Done()
|
|
defer GinkgoRecover()
|
|
|
|
if idx < len(keys) {
|
|
_, err := cli.Object().Head(keys[idx])
|
|
if err != nil {
|
|
errors <- err
|
|
}
|
|
}
|
|
}(i)
|
|
}
|
|
|
|
wg.Wait()
|
|
close(errors)
|
|
|
|
// Check for errors
|
|
for err := range errors {
|
|
Expect(err).NotTo(HaveOccurred())
|
|
}
|
|
|
|
// Cleanup
|
|
for _, key := range keys {
|
|
_ = cli.Object().Delete(false, key)
|
|
}
|
|
})
|
|
})
|
|
})
|
|
|
|
Describe("Large file operations", func() {
|
|
Context("Very large files", func() {
|
|
It("should upload 100MB file", func() {
|
|
if minioMode {
|
|
Skip("Skipping large file test in MinIO to save time")
|
|
}
|
|
|
|
key := "large-100mb-" + GenerateUniqueName("") + ".dat"
|
|
|
|
start := time.Now()
|
|
err := cli.Object().MultipartPut(key, randContent(100*libsiz.SizeMega))
|
|
elapsed := time.Since(start)
|
|
|
|
Expect(err).NotTo(HaveOccurred())
|
|
GinkgoWriter.Printf("100MB upload took: %v\n", elapsed)
|
|
|
|
// Verify size
|
|
size, err := cli.Object().Size(key)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
Expect(size).To(Equal(int64(100 * libsiz.SizeMega)))
|
|
|
|
// Cleanup
|
|
defer func() {
|
|
_ = cli.Object().Delete(false, key)
|
|
}()
|
|
})
|
|
|
|
It("should upload 500MB file", func() {
|
|
if minioMode {
|
|
Skip("Skipping very large file test in MinIO to save time")
|
|
}
|
|
|
|
key := "large-500mb-" + GenerateUniqueName("") + ".dat"
|
|
|
|
start := time.Now()
|
|
err := cli.Object().MultipartPut(key, randContent(500*libsiz.SizeMega))
|
|
elapsed := time.Since(start)
|
|
|
|
Expect(err).NotTo(HaveOccurred())
|
|
GinkgoWriter.Printf("500MB upload took: %v\n", elapsed)
|
|
|
|
// Verify size
|
|
size, err := cli.Object().Size(key)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
Expect(size).To(Equal(int64(500 * libsiz.SizeMega)))
|
|
|
|
// Cleanup
|
|
defer func() {
|
|
_ = cli.Object().Delete(false, key)
|
|
}()
|
|
})
|
|
})
|
|
|
|
Context("Custom part sizes", func() {
|
|
It("should upload with small part size (5MB)", func() {
|
|
key := "custom-part-5mb-" + GenerateUniqueName("") + ".dat"
|
|
|
|
err := cli.Object().MultipartPutCustom(5*libsiz.SizeMega, key, randContent(25*libsiz.SizeMega))
|
|
Expect(err).NotTo(HaveOccurred())
|
|
|
|
size, err := cli.Object().Size(key)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
Expect(size).To(Equal(int64(25 * libsiz.SizeMega)))
|
|
|
|
// Cleanup
|
|
defer func() {
|
|
_ = cli.Object().Delete(false, key)
|
|
}()
|
|
})
|
|
|
|
It("should upload with large part size (50MB)", func() {
|
|
if minioMode {
|
|
Skip("Skipping large part size test in MinIO to save time")
|
|
}
|
|
|
|
key := "custom-part-50mb-" + GenerateUniqueName("") + ".dat"
|
|
|
|
err := cli.Object().MultipartPutCustom(50*libsiz.SizeMega, key, randContent(150*libsiz.SizeMega))
|
|
Expect(err).NotTo(HaveOccurred())
|
|
|
|
size, err := cli.Object().Size(key)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
Expect(size).To(Equal(int64(150 * libsiz.SizeMega)))
|
|
|
|
// Cleanup
|
|
defer func() {
|
|
_ = cli.Object().Delete(false, key)
|
|
}()
|
|
})
|
|
})
|
|
})
|
|
|
|
Describe("Performance benchmarks", func() {
|
|
Context("Upload performance", func() {
|
|
It("should measure small file upload speed", func() {
|
|
const numFiles = 10
|
|
const fileSize = 1 * libsiz.SizeMega
|
|
keys := make([]string, numFiles)
|
|
|
|
start := time.Now()
|
|
for i := 0; i < numFiles; i++ {
|
|
keys[i] = "perf-small-" + GenerateUniqueName("") + ".dat"
|
|
err := cli.Object().Put(keys[i], randContent(fileSize))
|
|
Expect(err).NotTo(HaveOccurred())
|
|
}
|
|
elapsed := time.Since(start)
|
|
|
|
totalMB := float64(numFiles*fileSize) / float64(libsiz.SizeMega)
|
|
mbps := totalMB / elapsed.Seconds()
|
|
|
|
GinkgoWriter.Printf("Uploaded %d x 1MB files in %v (%.2f MB/s)\n", numFiles, elapsed, mbps)
|
|
|
|
// Cleanup
|
|
for _, key := range keys {
|
|
_ = cli.Object().Delete(false, key)
|
|
}
|
|
})
|
|
|
|
It("should measure multipart upload speed", func() {
|
|
const fileSize = 50 * libsiz.SizeMega
|
|
key := "perf-multipart-" + GenerateUniqueName("") + ".dat"
|
|
|
|
start := time.Now()
|
|
err := cli.Object().MultipartPut(key, randContent(fileSize))
|
|
elapsed := time.Since(start)
|
|
|
|
Expect(err).NotTo(HaveOccurred())
|
|
|
|
totalMB := float64(fileSize) / float64(libsiz.SizeMega)
|
|
mbps := totalMB / elapsed.Seconds()
|
|
|
|
GinkgoWriter.Printf("Uploaded 50MB file in %v (%.2f MB/s)\n", elapsed, mbps)
|
|
|
|
// Cleanup
|
|
defer func() {
|
|
_ = cli.Object().Delete(false, key)
|
|
}()
|
|
})
|
|
})
|
|
|
|
Context("Download performance", func() {
|
|
var testKey string
|
|
|
|
BeforeEach(func() {
|
|
testKey = "perf-download-" + GenerateUniqueName("") + ".dat"
|
|
err := cli.Object().Put(testKey, randContent(10*libsiz.SizeMega))
|
|
Expect(err).NotTo(HaveOccurred())
|
|
})
|
|
|
|
AfterEach(func() {
|
|
_ = cli.Object().Delete(false, testKey)
|
|
})
|
|
|
|
It("should measure download speed", func() {
|
|
start := time.Now()
|
|
output, err := cli.Object().Get(testKey)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
|
|
if output != nil && output.Body != nil {
|
|
defer output.Body.Close()
|
|
// Read all data
|
|
buf := make([]byte, 4096)
|
|
for {
|
|
_, err := output.Body.Read(buf)
|
|
if err != nil {
|
|
break
|
|
}
|
|
}
|
|
}
|
|
elapsed := time.Since(start)
|
|
|
|
totalMB := 10.0
|
|
mbps := totalMB / elapsed.Seconds()
|
|
|
|
GinkgoWriter.Printf("Downloaded 10MB file in %v (%.2f MB/s)\n", elapsed, mbps)
|
|
})
|
|
})
|
|
})
|
|
|
|
Describe("Batch operations", func() {
|
|
It("should delete multiple objects at once", func() {
|
|
const numObjects = 20
|
|
keys := make([]string, numObjects)
|
|
|
|
// Upload objects
|
|
for i := 0; i < numObjects; i++ {
|
|
keys[i] = "batch-delete-" + GenerateUniqueName("") + ".dat"
|
|
err := cli.Object().Put(keys[i], bytes.NewReader([]byte("content")))
|
|
Expect(err).NotTo(HaveOccurred())
|
|
}
|
|
|
|
// Delete all at once (if supported)
|
|
for _, key := range keys {
|
|
err := cli.Object().Delete(false, key)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
}
|
|
})
|
|
|
|
It("should list many objects efficiently", func() {
|
|
const numObjects = 50
|
|
keys := make([]string, numObjects)
|
|
prefix := "batch-list-" + GenerateUniqueName("")
|
|
|
|
// Upload objects with same prefix
|
|
for i := 0; i < numObjects; i++ {
|
|
keys[i] = prefix + "-" + GenerateUniqueName("") + ".dat"
|
|
err := cli.Object().Put(keys[i], bytes.NewReader([]byte("content")))
|
|
Expect(err).NotTo(HaveOccurred())
|
|
}
|
|
|
|
// List with prefix
|
|
objects, _, _, err := cli.Object().ListPrefix("", prefix)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
Expect(len(objects)).To(BeNumerically(">=", numObjects))
|
|
|
|
// Cleanup
|
|
for _, key := range keys {
|
|
_ = cli.Object().Delete(false, key)
|
|
}
|
|
})
|
|
})
|
|
})
|