add named-parameters setting

Author: Spatenheinz

README.md

@@ -1019,6 +1019,7 @@ foo:
 | `export` | boolean | `false` | Export all variables as environment variables. |
 | `fallback` | boolean | `false` | Search `justfile` in parent directory if the first recipe on the command line is not found. |
 | `ignore-comments` | boolean | `false` | Ignore recipe lines beginning with `#`. |
+| `named-parameters` | boolean | `false` | Using named-parameters feature for all recipes in `justfile`. |
 | `positional-arguments` | boolean | `false` | Pass positional arguments. |
 | `quiet` | boolean | `false` | Disable echoing recipe lines before executing. |
 | `script-interpreter`<sup>1.33.0</sup> | `[COMMAND, ARGS…]` | `['sh', '-eu']` | Set command used to invoke recipes with empty `[script]` attribute. |
@@ -2117,6 +2118,7 @@ change their behavior.
 | `[linux]`<sup>1.8.0</sup> | recipe | Enable recipe on Linux. |
 | `[macos]`<sup>1.8.0</sup> | recipe | Enable recipe on MacOS. |
 | `[metadata(METADATA)]`<sup>1.42.0</sup> | recipe | Attach `METADATA` to recipe. |
+| `[named-parameters]`<sup>1.44.0<sup> | recipe | Turn on [named_parameters](#named_parameters) for this recipe. |
 | `[no-cd]`<sup>1.9.0</sup> | recipe | Don't change directory before executing recipe. |
 | `[no-exit-message]`<sup>1.7.0</sup> | recipe | Don't print an error message if recipe fails. |
 | `[no-quiet]`<sup>1.23.0</sup> | recipe | Override globally quiet recipes and always echo out the recipe. |
@@ -3960,6 +3962,29 @@ This preserves `just`'s ability to catch variable name typos before running,
 for example if you were to write `{{argument}}`, but will not do what you want
 if the value of `argument` contains single quotes.
 
+#### Named Parameters
+
+The `named-arguments` setting enables python like keyword arguments for recipe calls.
+Take for instance the following 
+
+``` just
+set named-parameters
+
+foo default1="changes_often" default2="changes_sometimes" default3="changes_rarely":
+   echo {{ default1 }} {{ default2 }} {{ default3 }}
+```
+
+Calling `just foo default2="x"` would normally result in stdout of 
+`default2=x changes_sometimes changes_rarely`. while with `named-arguments`
+one would get `changes_often x changes_rarely`. Notice it is still possible
+to have positional parameters such as the recipe:
+
+``` just
+foo a b="default" c=b:
+   echo {{ a }} {{ b }} {{ c }}
+```
+
+
 #### Positional Arguments
 
 The `positional-arguments` setting causes all arguments to be passed as

src/justfile.rs

@@ -334,7 +334,8 @@ impl<'src> Justfile<'src> {
 
     let use_named_parameters = recipe
       .attributes
-      .contains(AttributeDiscriminant::NamedParameters);
+      .contains(AttributeDiscriminant::NamedParameters)
+      || module.settings.named_parameters;
 
     let (outer, positional) = Evaluator::evaluate_parameters(
       &context,

src/keyword.rs

@@ -20,6 +20,7 @@ pub(crate) enum Keyword {
   IgnoreComments,
   Import,
   Mod,
+  NamedParameters,
   NoExitMessage,
   PositionalArguments,
   Quiet,

src/node.rs

@@ -308,6 +308,7 @@ impl<'src> Node<'src> for Set<'src> {
       | Setting::Export(value)
       | Setting::Fallback(value)
       | Setting::NoExitMessage(value)
+      | Setting::NamedParameters(value)
       | Setting::PositionalArguments(value)
       | Setting::Quiet(value)
       | Setting::Unstable(value)

src/parser.rs

@@ -1131,6 +1131,9 @@ impl<'run, 'src> Parser<'run, 'src> {
       Keyword::Quiet => Some(Setting::Quiet(self.parse_set_bool()?)),
       Keyword::Unstable => Some(Setting::Unstable(self.parse_set_bool()?)),
       Keyword::WindowsPowershell => Some(Setting::WindowsPowerShell(self.parse_set_bool()?)),
+      Keyword::NamedParameters => {
+        Some(Setting::NamedParameters(self.parse_set_bool()?))
+      }
       _ => None,
     };
 

src/setting.rs

@@ -12,6 +12,7 @@ pub(crate) enum Setting<'src> {
   Export(bool),
   Fallback(bool),
   IgnoreComments(bool),
+  NamedParameters(bool),
   NoExitMessage(bool),
   PositionalArguments(bool),
   Quiet(bool),
@@ -35,6 +36,7 @@ impl Display for Setting<'_> {
       | Self::Export(value)
       | Self::Fallback(value)
       | Self::IgnoreComments(value)
+      | Self::NamedParameters(value)
       | Self::NoExitMessage(value)
       | Self::PositionalArguments(value)
       | Self::Quiet(value)

src/settings.rs

@@ -17,6 +17,7 @@ pub(crate) struct Settings<'src> {
   pub(crate) export: bool,
   pub(crate) fallback: bool,
   pub(crate) ignore_comments: bool,
+  pub(crate) named_parameters: bool,
   pub(crate) no_exit_message: bool,
   pub(crate) positional_arguments: bool,
   pub(crate) quiet: bool,
@@ -66,6 +67,9 @@ impl<'src> Settings<'src> {
         Setting::IgnoreComments(ignore_comments) => {
           settings.ignore_comments = ignore_comments;
         }
+        Setting::NamedParameters(named_parameters) => {
+          settings.named_parameters = named_parameters;
+        }
         Setting::NoExitMessage(no_exit_message) => {
           settings.no_exit_message = no_exit_message;
         }

tests/json.rs

@@ -94,6 +94,7 @@ struct Settings<'a> {
   windows_powershell: bool,
   windows_shell: Option<&'a str>,
   working_directory: Option<&'a str>,
+  named_parameters: bool,
 }
 
 #[track_caller]

tests/named_parameters.rs

@@ -144,3 +144,36 @@ fn fail_on_unknown_named_param() {
     .status(EXIT_FAILURE)
     .run();
 }
+
+#[test]
+fn named_parameters_setting() {
+    Test::new()
+      .arg("foo")
+      .arg("a=1")
+      .arg("c=3")
+      .justfile(
+        r#"
+      set named-parameters
+
+      foo a="a" b="b" c="c":
+        echo {{ a }}
+        echo {{ b }}
+        echo {{ c }}
+    "#,
+      )
+      .stdout(
+        "
+      1
+      b
+      3
+    ",
+      )
+      .stderr(
+        r#"
+      echo 1
+      echo b
+      echo 3
+    "#,
+    )
+    .run();
+}