feat(cli): add the ability to specify a custom keybinding/symbols file via the cli

this change is meant to address github issue: #2714

Author: 0x61nas

src/args.rs

@@ -16,6 +16,8 @@ pub struct CliArgs {
 	pub theme: PathBuf,
 	pub repo_path: RepoPath,
 	pub notify_watcher: bool,
+	pub key_bindings_path: Option<PathBuf>,
+	pub key_symbols_path: Option<PathBuf>,
 }
 
 pub fn process_cmdline() -> Result<CliArgs> {
@@ -60,10 +62,20 @@ pub fn process_cmdline() -> Result<CliArgs> {
 	let notify_watcher: bool =
 		*arg_matches.get_one("watcher").unwrap_or(&false);
 
+	let key_bindings_path = arg_matches
+		.get_one::<String>("key_bindings")
+		.map(PathBuf::from);
+
+	let key_symbols_path = arg_matches
+		.get_one::<String>("key_symbols")
+		.map(PathBuf::from);
+
 	Ok(CliArgs {
 		theme,
 		repo_path,
 		notify_watcher,
+		key_bindings_path,
+		key_symbols_path,
 	})
 }
 
@@ -82,6 +94,22 @@ fn app() -> ClapApp {
 
 {all-args}{after-help}
 		",
+		)
+			.arg(
+			Arg::new("key_bindings")
+				.help("Use a custom keybindings file")
+				.short('k')
+				.long("keybindings")
+				.value_name("KEY_LIST_FILENAME")
+				.num_args(1),
+		)
+			.arg(
+			Arg::new("key_symbols")
+				.help("Use a custom symbols file")
+				.short('s')
+				.long("key-symblos")
+				.value_name("KEY_SYMBOLS_FILENAME")
+				.num_args(1),
 		)
 		.arg(
 			Arg::new("theme")

src/keys/key_config.rs

@@ -1,8 +1,11 @@
-use anyhow::Result;
+use anyhow::{anyhow, Result};
 use crossterm::event::{KeyCode, KeyModifiers};
 use std::{fs::canonicalize, path::PathBuf, rc::Rc};
 
-use crate::{args::get_app_config_path, strings::symbol};
+use crate::{
+	args::{get_app_config_path, CliArgs},
+	strings::symbol,
+};
 
 use super::{
 	key_list::{GituiKeyEvent, KeysList},
@@ -34,9 +37,29 @@ impl KeyConfig {
 			.map_or_else(|_| Ok(symbols_file), Ok)
 	}
 
-	pub fn init() -> Result<Self> {
-		let keys = KeysList::init(Self::get_config_file()?);
-		let symbols = KeySymbols::init(Self::get_symbols_file()?);
+	pub fn init(cli_args: &CliArgs) -> Result<Self> {
+		let keys = if let Some(path) = &cli_args.key_bindings_path {
+			if !path.exists() {
+				return Err(anyhow!(
+					"The custom key bindings file dosen't exists"
+				));
+			}
+			KeysList::init(path.to_path_buf())
+		} else {
+			KeysList::init(Self::get_config_file()?)
+		};
+
+		let symbols = if let Some(path) = &cli_args.key_symbols_path {
+			if !path.exists() {
+				return Err(anyhow!(
+					"The custom key symbols file dosen't exists"
+				));
+			}
+			KeySymbols::init(path.to_path_buf())
+		} else {
+			KeySymbols::init(Self::get_symbols_file()?)
+		};
+
 		Ok(Self { keys, symbols })
 	}
 

src/main.rs

@@ -166,7 +166,7 @@ fn main() -> Result<()> {
 	asyncgit::register_tracing_logging();
 	ensure_valid_path(&cliargs.repo_path)?;
 
-	let key_config = KeyConfig::init()
+	let key_config = KeyConfig::init(&cliargs)
 		.map_err(|e| log_eprintln!("KeyConfig loading error: {e}"))
 		.unwrap_or_default();
 	let theme = Theme::init(&cliargs.theme);