Struct SecureArgParser 

pub struct SecureArgParser;

Secure argument parser

Provides security-first parsing with comprehensive validation.

Implementations

impl SecureArgParser

pub fn parse(args: &[String]) -> Result<AppConfig, ParseError>

Parse command-line arguments securely

Security Validations

1. Count limit check
2. Length validation
3. Dangerous pattern detection
4. Path normalization
5. Protected directory check

Errors

Returns ParseError if any validation fails

pub fn validate_argument(arg: &str) -> Result<(), ParseError>

Validate a single argument for security issues

Errors

• ArgumentTooLong if exceeds max length
• DangerousPattern if contains dangerous patterns

pub fn validate_path(path: &str) -> Result<PathBuf, ParseError>

Validate and normalize a file path

Security Checks

1. Length validation
2. Dangerous pattern detection
3. Path canonicalization
4. Protected directory check

Returns

Canonical absolute path if valid

Errors

Returns ParseError if path fails validation

pub fn validate_optional_path( path: Option<&str>, ) -> Result<Option<PathBuf>, ParseError>

Validate an optional path (may be None)

pub fn validate_number<T>( arg_name: &str, value: &str, min: Option<T>, max: Option<T>, ) -> Result<T, ParseError>

where T: FromStr + PartialOrd + Display,

Validate a number argument