src-tauri/src/utils/mod.rs

pub mod autostart;
pub mod dirs;
pub mod format;
pub mod help;
pub mod i18n;
pub mod init;
pub mod logging;
pub mod network;
pub mod notification;
pub mod resolve;
pub mod server;
pub mod singleton;
pub mod tmpl;
pub mod window_manager;
feat: autolaunch via Startup folder on windows 2025-04-19 13:51:11 +08:00			`pub mod autostart;`
refactor: impl structs methods 2022-01-07 23:29:20 +08:00			`pub mod dirs;`
feat: migrate logs API from REST to IPC streaming (#4277) * feat: migrate logs API from REST to IPC streaming - Replace REST API `/logs` calls with IPC streaming implementation - Add new `src-tauri/src/ipc/logs.rs` with `LogsMonitor` for real-time log streaming - Implement duplicate stream prevention with level tracking - Add frontend-backend communication via Tauri commands for log management - Remove WebSocket compatibility, maintain IPC-only mode - Fix duplicate monitoring task startup when toggling log service - Add proper task lifecycle management with JoinHandle cleanup * refactor: remove dead code from logs.rs to fix clippy warnings - Remove unused `timestamp` field from LogItem struct - Remove unused `client` field from LogsMonitor struct - Remove unused methods: `is_fresh`, `get_current_monitoring_level`, `get_current_logs` - Simplify LogsMonitor initialization by removing client dependency - All clippy warnings with -D warnings now resolved * refactor: extract duplicate fmt_bytes function to utils module - Create new utils/format.rs module with fmt_bytes function - Remove duplicate fmt_bytes implementations from traffic.rs and memory.rs - Update imports to use shared utils::format::fmt_bytes - Add comprehensive unit tests for fmt_bytes function - Ensure DRY principle compliance and code maintainability 2025-07-30 23:11:21 +08:00			`pub mod format;`
refactor: profile config 2022-03-01 08:58:47 +08:00			`pub mod help;`
chore: git hooks for linter and formatter 2025-03-13 12:51:20 +08:00			`pub mod i18n;`
refactor: adjust dirs structure 2021-12-14 16:07:15 +08:00			`pub mod init;`
feat: add logging module and update running mode terminology 2025-03-25 23:05:09 +08:00			`pub mod logging;`
feat: add network manager to optimize network request handling 2025-04-30 21:30:28 +08:00			`pub mod network;`
feat: add notification system with hotkey events and permission handling (#3867) * feat: add notification system with hotkey events and permission handling * Add macOS-specific handling for AppHidden notification Introduces conditional support for the AppHidden notification event, enabling macOS-specific behavior. Updates the enum and notification logic to include this platform-specific feature. Improves macOS user experience by accommodating system-level application hiding events. * Implement feature X to enhance user experience and fix bug Y in module Z * refactor(notification): update notification keys for consistency and clarity * chore(deps): update dependencies to latest versions 2025-06-26 23:09:07 +08:00			`pub mod notification;`
feat: enhance system proxy setting 2021-12-27 02:29:28 +08:00			`pub mod resolve;`
feat: implement a simple singleton process 2021-12-23 01:35:17 +08:00			`pub mod server;`
refactor: optimize singleton macro usage with Default trait implementations (#4279) * refactor: implement DRY principle improvements across backend Major DRY violations identified and addressed: 1. IPC Stream Monitor Pattern: - Created `utils/ipc_monitor.rs` with generic `IpcStreamMonitor` trait - Added `IpcMonitorManager` for common async task management patterns - Eliminates duplication across traffic.rs, memory.rs, and logs.rs 2. Singleton Pattern Duplication: - Created `utils/singleton.rs` with `singleton\!` and `singleton_with_logging\!` macros - Replaces 16+ duplicate singleton implementations across codebase - Provides consistent, tested patterns for global instances 3. macOS Activation Policy Refactoring: - Consolidated 3 duplicate methods into single parameterized `set_activation_policy()` - Eliminated code duplication while maintaining backward compatibility - Reduced maintenance burden for macOS-specific functionality These improvements enhance maintainability, reduce bug potential, and ensure consistent patterns across the backend codebase. * fix: resolve test failures and clippy warnings - Fix doctest in singleton.rs by using rust,ignore syntax and proper code examples - Remove unused time::Instant import from ipc_monitor.rs - Add #[allow(dead_code)] attributes to future-use utility modules - All 11 unit tests now pass successfully - All clippy checks pass with -D warnings strict mode - Documentation tests properly ignore example code that requires full context * refactor: migrate code to use new utility tools (partial) Progress on systematic migration to use created utility tools: 1. Reorganized IPC Monitor: - Moved ipc_monitor.rs to src-tauri/src/ipc/monitor.rs for better organization - Updated module structure to emphasize IPC relationship 2. IpcManager Singleton Migration: - Replaced manual OnceLock singleton pattern with singleton_with_logging\! macro - Simplified initialization code and added consistent logging - Removed unused imports (OnceLock, logging::Type) 3. ProxyRequestCache Singleton Migration: - Migrated from once_cell::sync::OnceCell to singleton\! macro - Cleaner, more maintainable singleton pattern - Consistent with project-wide singleton approach These migrations demonstrate the utility and effectiveness of the created tools: - Less boilerplate code - Consistent patterns across codebase - Easier maintenance and debugging * feat: complete migration to new utility tools - phase 1 Successfully migrated core components to use the created utility tools: - Moved `ipc_monitor.rs` to `src-tauri/src/ipc/monitor.rs` - Better organization emphasizing IPC relationship - Updated module exports and imports - IpcManager: Migrated to `singleton_with_logging\!` macro - ProxyRequestCache: Migrated to `singleton\!` macro - Eliminated ~30 lines of boilerplate singleton code - Consistent logging and initialization patterns - Removed unused imports (OnceLock, once_cell, logging::Type) - Cleaner, more maintainable code structure - All 11 unit tests pass successfully - Zero compilation warnings - Lines of code reduced: ~50+ lines of boilerplate - Consistency improved: Unified singleton patterns - Maintainability enhanced: Centralized utility functions - Test coverage maintained: 100% test pass rate Remaining complex monitors (traffic, memory, logs) will be migrated to use the shared IPC monitoring patterns in the next phase, which requires careful refactoring of their streaming logic. * refactor: complete singleton pattern migration to utility macros Migrate remaining singleton patterns across the backend to use standardized utility macros, achieving significant code reduction and consistency improvements. - LogsMonitor (ipc/logs.rs): `OnceLock` → `singleton_with_logging\!` - Sysopt (core/sysopt.rs): `OnceCell` → `singleton_lazy\!` - Tray (core/tray/mod.rs): Complex `OnceCell` → `singleton_lazy\!` - Handle (core/handle.rs): `OnceCell` → `singleton\!` - CoreManager (core/core.rs): `OnceCell` → `singleton_lazy\!` - TrafficMonitor (ipc/traffic.rs): `OnceLock` → `singleton_lazy_with_logging\!` - MemoryMonitor (ipc/memory.rs): `OnceLock` → `singleton_lazy_with_logging\!` - `singleton_lazy\!` - For complex initialization patterns - `singleton_lazy_with_logging\!` - For complex initialization with logging - Code Reduction: -33 lines of boilerplate singleton code - DRY Compliance: Eliminated duplicate initialization patterns - Consistency: Unified singleton approach across codebase - Maintainability: Centralized singleton logic in utility macros - Zero Breaking Changes: All existing APIs remain compatible All tests pass and clippy warnings resolved. * refactor: optimize singleton macros using Default trait implementation Simplify singleton macro usage by implementing Default trait for complex initialization patterns, significantly improving code readability and maintainability. - MemoryMonitor: Move IPC client initialization to Default impl - TrafficMonitor: Move IPC client initialization to Default impl - Sysopt: Move Arc<Mutex> initialization to Default impl - Tray: Move struct field initialization to Default impl - CoreManager: Move Arc<Mutex> initialization to Default impl ```rust singleton_lazy_with_logging\!(MemoryMonitor, INSTANCE, "MemoryMonitor", \|\| { let ipc_path_buf = ipc_path().unwrap(); let ipc_path = ipc_path_buf.to_str().unwrap_or_default(); let client = IpcStreamClient::new(ipc_path).unwrap(); MemoryMonitor::new(client) }); ``` ```rust impl Default for MemoryMonitor { /* initialization logic / } singleton_lazy_with_logging\!(MemoryMonitor, INSTANCE, "MemoryMonitor", MemoryMonitor::default); ``` - Code Reduction: -17 lines of macro closure code (80%+ simplification) - Separation of Concerns: Initialization logic moved to proper Default impl - Readability: Single-line macro calls vs multi-line closures - Testability: Default implementations can be tested independently - Rust Idioms: Using standard Default trait pattern - Performance: Function calls more efficient than closures All tests pass and clippy warnings resolved. refactor: implement MonitorData and StreamingParser traits for IPC monitors * refactor: add timeout and retry_interval fields to IpcStreamMonitor; update TrafficMonitorState to derive Default * refactor: migrate AppHandleManager to unified singleton control - Replace manual singleton implementation with singleton_with_logging\! macro - Remove std::sync::Once dependency in favor of OnceLock-based pattern - Improve error handling for macOS activation policy methods - Maintain thread safety with parking_lot::Mutex for AppHandle storage - Add proper initialization check to prevent duplicate handle assignment - Enhance logging consistency across AppHandleManager operations * refactor: improve hotkey management with enum-based operations - Add HotkeyFunction enum for type-safe function selection - Add SystemHotkey enum for predefined system shortcuts - Implement Display and FromStr traits for type conversions - Replace string-based hotkey registration with enum methods - Add register_system_hotkey() and unregister_system_hotkey() methods - Maintain backward compatibility with string-based register() method - Migrate singleton pattern to use singleton_with_logging\! macro - Extract hotkey function execution logic into centralized execute_function() - Update lib.rs to use new enum-based SystemHotkey operations - Improve type safety and reduce string manipulation errors Benefits: - Type safety prevents invalid hotkey function names - Centralized function execution reduces code duplication - Enum-based API provides better IDE autocomplete support - Maintains full backward compatibility with existing configurations * fix: resolve LightWeightState initialization order panic - Modify with_lightweight_status() to safely handle unmanaged state using try_state() - Return Option<R> instead of R to gracefully handle state unavailability - Update is_in_lightweight_mode() to use unwrap_or(false) for safe defaults - Add state availability check in auto_lightweight_mode_init() before access - Maintain singleton check priority while preventing early state access panics - Fix clippy warnings for redundant pattern matching Resolves runtime panic: "state() called before manage() for LightWeightState" * refactor: add unreachable patterns for non-macOS in hotkey handling * refactor: simplify SystemHotkey enum by removing redundant cfg attributes * refactor: add macOS conditional compilation for system hotkey registration methods * refactor: streamline hotkey unregistration and error logging for macOS 2025-07-31 14:35:13 +08:00			`pub mod singleton;`
feat: inline config file template 2022-02-18 23:57:13 +08:00			`pub mod tmpl;`
feat: unify window manager and optimize window show/hide logic 2025-06-17 13:02:47 +08:00			`pub mod window_manager;`