proxy.golang.org : github.com/agilira/argus
Package argus provides a comprehensive dynamic configuration management framework for Go applications, combining ultra-fast file monitoring, universal format parsing, and zero-reflection configuration binding in a single, cohesive system. Argus is built on the principle that configuration should be dynamic, type-safe, and ultra-performant. It transforms static configuration files into reactive, real-time configuration sources that adapt to changes without application restarts. Argus consists of six integrated subsystems: Argus automatically detects and parses any configuration format, making it truly universal for modern applications that use diverse configuration sources. Quick start with automatic format detection: Supported formats with zero configuration: The zero-reflection binding system provides type-safe configuration access with unprecedented performance through unsafe.Pointer optimizations. High-performance typed configuration binding: Performance characteristics: At the heart of Argus is BoreasLite, a specialized MPSC ring buffer optimized for configuration file events with adaptive performance strategies. Adaptive optimization strategies: **SingleEvent**: Ultra-low latency for 1-2 files (24ns per event) **SmallBatch**: Balanced performance for 3-20 files **LargeBatch**: High throughput for 20+ files with 4x unrolling **Auto**: Automatically adapts based on file count config := argus.Config{ PollInterval: 5 * time.Second, OptimizationStrategy: argus.OptimizationAuto, BoreasLiteCapacity: 128, } watcher := argus.New(config) Argus uses intelligent polling rather than OS-specific APIs for maximum portability and predictable behavior across all platforms. Advanced file monitoring with caching: Built-in audit logging provides security and compliance capabilities with tamper detection, structured logging, and unified SQLite backend for persistence. Audit events include: Argus implements comprehensive security controls to protect against common attack vectors, making it safe for production environments with untrusted input. Multi-layer path validation prevents directory traversal attacks: DoS protection through resource limits: Environment variable validation prevents injection attacks: Argus supports distributed configuration management with built-in failover, synchronization, and conflict resolution for multi-instance deployments. Remote configuration features: Built-in graceful shutdown ensures clean resource cleanup and prevents data loss during application termination. Shutdown sequence includes: Argus supports pluggable parsers for production environments requiring full specification compliance or advanced features. Register custom parsers at startup: Or manually: Argus is designed for high-performance production environments with security-first optimizations: Argus works identically on all platforms with platform-specific optimizations: Common integration patterns for different use cases: **Microservice Configuration**: **Feature Flags**: **Database Connection Pools**: All Argus components are thread-safe and optimized for concurrent access: Argus provides comprehensive error handling and observability: For detailed examples and documentation: For production deployments, see docs/ARCHITECTURE.md for scaling, performance tuning, and security configuration recommendations. Repository: https://github.com/agilira/argus
Registry
-
Source
- Documentation
- JSON
- codemeta.json
purl: pkg:golang/github.com/agilira/argus
Keywords:
agilira
, audit-trail
, cli
, configuration-management
, dynamic-configuration
, file-watcher
, flash-flags
, go
, hcl
, high-performance
, hot-reload
, ini
, lock-free
, orpheus
, properties
, toml
, xantos-powered
, yaml
License: MPL-2.0
Latest release: about 1 month ago
First release: 3 months ago
Namespace: github.com/agilira
Stars: 70 on GitHub
Forks: 4 on GitHub
See more repository details: repos.ecosyste.ms
Last synced: 6 days ago