__init__.pyโข3.63 kB
#!/usr/bin/env python3
"""
Utilities Package
Provides logging, helper functions, and common utilities.
"""
from .logging import (
LoggingConfig,
JsonFormatter,
ContextualLogger,
PerformanceLogger,
LoggingContext,
AuditLogger,
setup_logging,
setup_default_logging,
get_logger,
get_audit_logger,
log_operation,
)
from .helpers import (
# String utilities
slugify,
truncate_text,
extract_domain,
is_valid_url,
normalize_url,
# Hash utilities
generate_hash,
generate_id,
generate_api_key,
# File utilities
ensure_directory,
get_file_size,
get_file_extension,
is_text_file,
read_file_safe,
write_file_safe,
# JSON utilities
load_json_safe,
save_json_safe,
serialize_dataclass,
# Date/time utilities
utc_now,
format_datetime,
parse_datetime,
timestamp_to_datetime,
# Validation utilities
validate_email,
validate_username,
sanitize_filename,
# Async utilities
run_sync,
run_with_timeout,
# Decorators
retry,
async_retry,
cache_result,
# Data structures
LRUCache,
# Environment utilities
get_env_bool,
get_env_int,
get_env_float,
get_env_list,
# Memory utilities
get_memory_usage,
format_bytes,
)
from .error_handler import (
# Error classes
AnyDocsError,
ValidationError,
AuthenticationError,
AuthorizationError,
NetworkError,
DatabaseError,
ConfigurationError,
AdapterError,
MCPProtocolError,
# Error handling
ErrorHandler,
ErrorContext,
ErrorSeverity,
ErrorCategory,
# Error utilities
get_error_handler,
handle_error,
safe_execute,
error_handler_decorator,
retry_on_error,
)
__all__ = [
# Logging
'LoggingConfig',
'JsonFormatter',
'ContextualLogger',
'PerformanceLogger',
'LoggingContext',
'AuditLogger',
'setup_logging',
'setup_default_logging',
'get_logger',
'get_audit_logger',
'log_operation',
# String utilities
'slugify',
'truncate_text',
'extract_domain',
'is_valid_url',
'normalize_url',
# Hash utilities
'generate_hash',
'generate_id',
'generate_api_key',
# File utilities
'ensure_directory',
'get_file_size',
'get_file_extension',
'is_text_file',
'read_file_safe',
'write_file_safe',
# JSON utilities
'load_json_safe',
'save_json_safe',
'serialize_dataclass',
# Date/time utilities
'utc_now',
'format_datetime',
'parse_datetime',
'timestamp_to_datetime',
# Validation utilities
'validate_email',
'validate_username',
'sanitize_filename',
# Async utilities
'run_sync',
'run_with_timeout',
# Decorators
'retry',
'async_retry',
'cache_result',
# Data structures
'LRUCache',
# Environment utilities
'get_env_bool',
'get_env_int',
'get_env_float',
'get_env_list',
# Memory utilities
'get_memory_usage',
'format_bytes',
# Error handling
'AnyDocsError',
'ValidationError',
'AuthenticationError',
'AuthorizationError',
'NetworkError',
'DatabaseError',
'ConfigurationError',
'AdapterError',
'MCPProtocolError',
'ErrorHandler',
'ErrorContext',
'ErrorSeverity',
'ErrorCategory',
'get_error_handler',
'handle_error',
'safe_execute',
'error_handler_decorator',
'retry_on_error',
]