#![feature(let_chains)] #![feature(anonymous_lifetime_in_impl_trait)] pub mod commands; mod flag; mod string; mod token; mod tree; uniffi::include_scaffolding!("commands"); use core::panic; use std::collections::HashMap; use std::fmt::Write; use std::ops::Not; use flag::{Flag, FlagMatchError, FlagValueMatchError}; use smol_str::SmolStr; use string::MatchedFlag; use tree::TreeBranch; pub use commands::Command; pub use token::*; // todo: this should come from the bot probably const MAX_SUGGESTIONS: usize = 7; lazy_static::lazy_static! { pub static ref COMMAND_TREE: TreeBranch = { let mut tree = TreeBranch::empty(); crate::commands::all().into_iter().for_each(|x| tree.register_command(x)); tree }; } #[derive(Debug)] pub enum CommandResult { Ok { command: ParsedCommand }, Err { error: String }, } #[derive(Debug, Clone)] pub enum Parameter { MemberRef { member: String }, SystemRef { system: String }, MemberPrivacyTarget { target: String }, PrivacyLevel { level: String }, OpaqueString { raw: String }, Toggle { toggle: bool }, } #[derive(Debug)] pub struct ParsedCommand { pub command_ref: String, pub params: HashMap, pub flags: HashMap>, } pub fn parse_command(prefix: String, input: String) -> CommandResult { let input: SmolStr = input.into(); let mut local_tree: TreeBranch = COMMAND_TREE.clone(); // end position of all currently matched tokens let mut current_pos: usize = 0; let mut current_token_idx: usize = 0; let mut params: HashMap = HashMap::new(); let mut raw_flags: Vec<(usize, MatchedFlag)> = Vec::new(); loop { println!( "possible: {:?}", local_tree.possible_tokens().collect::>() ); let next = next_token(local_tree.possible_tokens(), &input, current_pos); println!("next: {:?}", next); match next { Some(Ok((found_token, arg, new_pos))) => { current_pos = new_pos; current_token_idx += 1; if let Some(arg) = arg.as_ref() { // insert arg as paramater if this is a parameter if let Some((param_name, param)) = arg.param.as_ref() { params.insert(param_name.to_string(), param.clone()); } } if let Some(next_tree) = local_tree.get_branch(&found_token) { local_tree = next_tree.clone(); } else { panic!("found token could not match tree, at {input}"); } } Some(Err((token, err))) => { let error_msg = match err { TokenMatchError::MissingParameter { name } => { format!("Expected parameter `{name}` in command `{prefix}{input} {token}`.") } TokenMatchError::MissingAny { tokens } => { let mut msg = format!("Expected one of "); for (idx, token) in tokens.iter().enumerate() { write!(&mut msg, "`{token}`").expect("oom"); if idx < tokens.len() - 1 { if tokens.len() > 2 && idx == tokens.len() - 2 { msg.push_str(" or "); } else { msg.push_str(", "); } } } write!(&mut msg, " in command `{prefix}{input} {token}`.").expect("oom"); msg } }; return CommandResult::Err { error: error_msg }; } None => { // if it said command not found on a flag, output better error message let mut error = format!("Unknown command `{prefix}{input}`."); if fmt_possible_commands(&mut error, &prefix, local_tree.possible_commands(2)).not() { error.push_str(" "); } error.push_str( "For a list of all possible commands, see .", ); // todo: check if last token is a common incorrect unquote (multi-member names etc) // todo: check if this is a system name in pk;s command return CommandResult::Err { error }; } } // match flags until there are none left while let Some(matched_flag) = string::next_flag(&input, current_pos) { current_pos = matched_flag.next_pos; println!("flag matched {matched_flag:?}"); raw_flags.push((current_token_idx, matched_flag)); } // if we have a command, stop parsing and return it if let Some(command) = local_tree.command() { // match the flags against this commands flags let mut flags: HashMap> = HashMap::new(); let mut misplaced_flags: Vec = Vec::new(); let mut invalid_flags: Vec = Vec::new(); for (token_idx, matched_flag) in raw_flags { if token_idx != command.parse_flags_before { misplaced_flags.push(matched_flag); continue; } let Some(matched_flag) = match_flag(command.flags.iter(), matched_flag.clone()) else { invalid_flags.push(matched_flag); continue; }; match matched_flag { // a flag was matched Ok((name, value)) => { flags.insert(name.into(), value); } Err((flag, err)) => { match err { FlagMatchError::ValueMatchFailed(FlagValueMatchError::ValueMissing) => { return CommandResult::Err { error: format!( "Flag `-{name}` in command `{prefix}{input}` is missing a value, try passing `-{name}={value}`.", name = flag.name(), value = flag.value().expect("value missing error cant happen without a value"), ), } } } } } } if misplaced_flags.is_empty().not() { let mut error = format!( "Flag{} ", (misplaced_flags.len() > 1).then_some("s").unwrap_or("") ); for (idx, matched_flag) in misplaced_flags.iter().enumerate() { write!(&mut error, "`-{}`", matched_flag.name).expect("oom"); if idx < misplaced_flags.len() - 1 { error.push_str(", "); } } write!( &mut error, " in command `{prefix}{input}` {} misplaced. Try reordering to match the command usage `{prefix}{command}`.", (misplaced_flags.len() > 1).then_some("are").unwrap_or("is") ).expect("oom"); return CommandResult::Err { error }; } if invalid_flags.is_empty().not() { let mut error = format!( "Flag{} ", (misplaced_flags.len() > 1).then_some("s").unwrap_or("") ); for (idx, matched_flag) in invalid_flags.iter().enumerate() { write!(&mut error, "`-{}`", matched_flag.name).expect("oom"); if idx < invalid_flags.len() - 1 { error.push_str(", "); } } write!( &mut error, " {} not applicable in this command (`{prefix}{input}`). Applicable flags are the following:", (invalid_flags.len() > 1).then_some("are").unwrap_or("is") ).expect("oom"); for (idx, flag) in command.flags.iter().enumerate() { write!(&mut error, " `{flag}`").expect("oom"); if idx < command.flags.len() - 1 { error.push_str(", "); } } error.push_str("."); return CommandResult::Err { error }; } println!("{} {flags:?} {params:?}", command.cb); return CommandResult::Ok { command: ParsedCommand { command_ref: command.cb.into(), params, flags, }, }; } } } fn match_flag<'a>( possible_flags: impl Iterator, matched_flag: MatchedFlag<'a>, ) -> Option), (&'a Flag, FlagMatchError)>> { // skip if 0 length (we could just take an array ref here and in next_token aswell but its nice to keep it flexible) if let (_, Some(len)) = possible_flags.size_hint() && len == 0 { return None; } // check for all (possible) flags, see if token matches for flag in possible_flags { println!("matching flag {flag:?}"); match flag.try_match(matched_flag.name, matched_flag.value) { Some(Ok(param)) => return Some(Ok((flag.name().into(), param))), Some(Err(err)) => return Some(Err((flag, err))), None => {} } } None } /// Find the next token from an either raw or partially parsed command string /// /// Returns: /// - nothing (none matched) /// - matched token, to move deeper into the tree /// - matched value (if this command matched an user-provided value such as a member name) /// - end position of matched token /// - error when matching fn next_token<'a>( possible_tokens: impl Iterator, input: &str, current_pos: usize, ) -> Option, usize), (&'a Token, TokenMatchError)>> { // skip if 0 length if let (_, Some(len)) = possible_tokens.size_hint() && len == 0 { return None; } // get next parameter, matching quotes let matched = string::next_param(&input, current_pos); println!("matched: {matched:?}\n---"); // iterate over tokens and run try_match for token in possible_tokens { let is_match_remaining_token = |token: &Token| matches!(token, Token::OpaqueRemainder(_)); // check if this is a token that matches the rest of the input let match_remaining = is_match_remaining_token(token) // check for Any here if it has a "match remainder" token in it // if there is a "match remainder" token in a command there shouldn't be a command descending from that || matches!(token, Token::Any(ref tokens) if tokens.iter().any(is_match_remaining_token)); // either use matched param or rest of the input if matching remaining let input_to_match = matched.as_ref().map(|v| { match_remaining .then_some(&input[current_pos..]) .unwrap_or(v.value) }); match token.try_match(input_to_match) { Some(Ok(value)) => { let next_pos = match matched { // return last possible pos if we matched remaining, Some(_) if match_remaining => input.len(), // otherwise use matched param next pos, Some(param) => param.next_pos, // and if didnt match anything we stay where we are None => current_pos, }; return Some(Ok((token, value, next_pos))); } Some(Err(err)) => { return Some(Err((token, err))); } None => {} // continue matching until we exhaust all tokens } } None } // todo: should probably move this somewhere else /// returns true if wrote possible commands, false if not fn fmt_possible_commands( f: &mut String, prefix: &str, mut possible_commands: impl Iterator, ) -> bool { if let Some(first) = possible_commands.next() { f.push_str(" Perhaps you meant one of the following commands:\n"); for command in std::iter::once(first).chain(possible_commands.take(MAX_SUGGESTIONS - 1)) { if !command.show_in_suggestions { continue; } writeln!(f, "- **{prefix}{command}** - *{}*", command.help).expect("oom"); } return true; } return false; }