paramInfos = funcInfo.getParameterList();
+ int nparams = paramInfos.size();
+ Optional kwargs;
+ if (nparams > 0 && paramInfos.get(nparams - 1).getRole() == PARAM_ROLE_KWARGS) {
+ kwargs = Optional.of(new Param(paramInfos.get(nparams - 1), anchorPrefix));
+ nparams--;
+ } else {
+ kwargs = Optional.empty();
+ }
+ Optional varargs;
+ if (nparams > 0 && paramInfos.get(nparams - 1).getRole() == PARAM_ROLE_VARARGS) {
+ varargs = Optional.of(new Param(paramInfos.get(nparams - 1), anchorPrefix));
+ nparams--;
+ } else {
+ varargs = Optional.empty();
+ }
+ // Invariant: nparams is now the number of non-residual parameters.
+
+ ImmutableList.Builder paramsBuilder = new ImmutableList.Builder();
+ int numKwonly = 0;
+ // Add ordinary or positional-only params
+ for (int i = 0; i < nparams; i++) {
+ FunctionParamInfo paramInfo = paramInfos.get(i);
+ if (paramInfo.getRole() == PARAM_ROLE_KEYWORD_ONLY) {
+ numKwonly = nparams - i;
+ break;
+ }
+ paramsBuilder.add(new Param(paramInfo, anchorPrefix));
+ }
+ // Add *args or (if needed) the "*" separator
+ if (varargs.isPresent() || numKwonly > 0) {
+ paramsBuilder.add(varargs.orElse(Param.STAR_SEPARATOR));
+ }
+ // Add kwonly params (if any)
+ for (int i = nparams - numKwonly; i < nparams; i++) {
+ paramsBuilder.add(new Param(paramInfos.get(i), anchorPrefix));
}
+ // Add **kwargs
+ kwargs.ifPresent(paramsBuilder::add);
+ return paramsBuilder.build();
}
/**
diff --git a/stardoc/proto/stardoc_output.proto b/stardoc/proto/stardoc_output.proto
index 82c97e85..ee6082fb 100644
--- a/stardoc/proto/stardoc_output.proto
+++ b/stardoc/proto/stardoc_output.proto
@@ -13,7 +13,8 @@
// limitations under the License.
//
// Vendored from src/main/protobuf/stardoc_output.proto
-// in the Bazel source tree at commit f4cfc846dbdf5f6c19d0a716fccd2ddcdae0d609n
+// in the Bazel source tree at commit bd1c3af2ea14e81268e940d2b8ba5ad00c3f08d7n
+
//
// Protos for Stardoc data.
//
@@ -193,7 +194,16 @@ message StarlarkFunctionInfo {
// "foo.frobnicate".
string function_name = 1;
- // The parameters for the function.
+ // The parameters for the function, in the following order:
+ // - positional parameters
+ // - keyword-only parameters
+ // - residual varargs parameter (`*args`)
+ // - residual keyword arguments parameter (`**kwargs`)
+ // This order differs from the order in which parameters are listed in the
+ // function's declaration (where positional parameters and keyword-only
+ // parameters are separated either by `*` or `*args`). The declaration order
+ // can be recovered by looking for the transition from ordinary/positional to
+ // keyword-only.
repeated FunctionParamInfo parameter = 2;
// The documented description of the function (if specified in the function's
@@ -213,9 +223,28 @@ message StarlarkFunctionInfo {
OriginKey origin_key = 6;
}
+// Representation of the syntactic role of a given function parameter.
+enum FunctionParamRole {
+ PARAM_ROLE_UNSPECIFIED = 0;
+ // An ordinary parameter which may be used as a positional or by keyword.
+ PARAM_ROLE_ORDINARY = 1;
+ // A positional-only parameter; such parameters cannot be defined in pure
+ // Starlark code, but exist in some natively-defined functions.
+ PARAM_ROLE_POSITIONAL_ONLY = 2;
+ // A keyword-only parameter, i.e. a non-vararg/kwarg parameter that follows
+ // `*` or `*args` in the function's declaration.
+ PARAM_ROLE_KEYWORD_ONLY = 3;
+ // Residual varargs, typically `*args` in the function's declaration.
+ PARAM_ROLE_VARARGS = 4;
+ // Residual keyword arguments, typically `**kwargs` in the function's
+ // declaration.
+ PARAM_ROLE_KWARGS = 5;
+}
+
// Representation of a Starlark function parameter definition.
message FunctionParamInfo {
- // The name of the parameter.
+ // The name of the parameter. This does *not* include the `*` or `**` prefix
+ // for varargs or residual keyword argument parameters.
string name = 1;
// The documented description of the parameter (if specified in the function's
@@ -230,6 +259,9 @@ message FunctionParamInfo {
// parameter. This might be false even if defaultValue is empty in the case of
// special parameter such as *args and **kwargs"
bool mandatory = 4;
+
+ // The parameter's syntactic role.
+ FunctionParamRole role = 5;
}
message FunctionReturnInfo {
diff --git a/test/BUILD b/test/BUILD
index 4e8e8f27..3c5bc9ec 100644
--- a/test/BUILD
+++ b/test/BUILD
@@ -13,6 +13,11 @@ self_gen_test(
name = "stardoc_self_gen_test",
golden_file = "//stardoc:stardoc_doc.md",
stardoc_doc = "//:stardoc_rule_doc",
+ # stardoc_doc.md output was generated with Bazel HEAD on 2024-06-12 and may differ in other versions
+ tags = [
+ "bazel_8",
+ "manual",
+ ],
)
exports_files(["testdata/fakedeps/dep.bzl"])
@@ -199,10 +204,26 @@ stardoc_test(
],
)
+stardoc_test(
+ name = "macro_kwargs_legacy_test",
+ golden_file = "testdata/macro_kwargs_test/legacy_golden.md",
+ input_file = "testdata/macro_kwargs_test/input.bzl",
+ # Golden output was generated with Bazel 7.1 and may differ in other versions
+ tags = [
+ "bazel_7_1",
+ "manual",
+ ],
+)
+
stardoc_test(
name = "macro_kwargs_test",
golden_file = "testdata/macro_kwargs_test/golden.md",
input_file = "testdata/macro_kwargs_test/input.bzl",
+ # Golden output was generated with Bazel HEAD on 2024-06-12 and may differ in other versions
+ tags = [
+ "bazel_8",
+ "manual",
+ ],
)
stardoc_test(
diff --git a/test/testdata/macro_kwargs_test/golden.md b/test/testdata/macro_kwargs_test/golden.md
index 1a9df5bf..c4e95cde 100644
--- a/test/testdata/macro_kwargs_test/golden.md
+++ b/test/testdata/macro_kwargs_test/golden.md
@@ -7,7 +7,7 @@ Tests for functions which use *args or **kwargs
## macro_with_args
-macro_with_args(name, args)
+macro_with_args(name, *args)
My args macro is OK.
@@ -25,12 +25,92 @@ My args macro is OK.
An empty list.
+
+
+## macro_with_args_and_kwonly
+
+
+macro_with_args_and_kwonly(*args, name)
+
+
+*args and a keyword-only param
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| args | Positional arguments | none |
+
+
+
+
+## macro_with_args_and_kwonlys
+
+
+macro_with_args_and_kwonlys(*args, name, number)
+
+
+*args and several keyword-only params
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| args | Positional arguments | none |
+
+
+
+
+## macro_with_args_kwonly_and_kwargs
+
+
+macro_with_args_kwonly_and_kwargs(*args, name, **kwargs)
+
+
+*args, a keyword-only param, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| args | Positional arguments | none |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_args_kwonlys_and_kwargs
+
+
+macro_with_args_kwonlys_and_kwargs(*args, name, number, **kwargs)
+
+
+*args, several keyword-only params, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| args | Positional arguments | none |
+| kwargs | Other named arguments | none |
+
+
## macro_with_both
-macro_with_both(name, number, args, kwargs)
+macro_with_both(name, number, *args, **kwargs)
Oh wow this macro has both.
@@ -58,7 +138,7 @@ An empty list.
## macro_with_kwargs
-macro_with_kwargs(name, config, deps, kwargs)
+macro_with_kwargs(name, config, deps, **kwargs)
My kwargs macro is the best.
@@ -85,3 +165,302 @@ vel mollis eros pellentesque.
An empty list.
+
+
+## macro_with_kwonly
+
+
+macro_with_kwonly(*, name)
+
+
+One keyword-only param
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+
+
+
+
+## macro_with_kwonly_and_kwargs
+
+
+macro_with_kwonly_and_kwargs(*, name, **kwargs)
+
+
+One keyword-only param and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_kwonlys
+
+
+macro_with_kwonlys(*, name, number)
+
+
+Several keyword-only params
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+
+
+
+
+## macro_with_kwonlys_and_kwargs
+
+
+macro_with_kwonlys_and_kwargs(*, name, number, **kwargs)
+
+
+Several keyword-only params and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_only_args
+
+
+macro_with_only_args(*args)
+
+
+Macro only taking *args
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| args | Positional arguments | none |
+
+
+
+
+## macro_with_only_args_and_kwargs
+
+
+macro_with_only_args_and_kwargs(*args, **kwargs)
+
+
+Macro only taking *args and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| args | Positional arguments | none |
+| kwargs | Named arguments | none |
+
+
+
+
+## macro_with_only_kwargs
+
+
+macro_with_only_kwargs(**kwargs)
+
+
+Macro only taking **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| kwargs | Named arguments | none |
+
+
+
+
+## macro_with_ordinary_param_and_kwonlys
+
+
+macro_with_ordinary_param_and_kwonlys(name, *, number, config)
+
+
+One ordinary param and several keyword-only params
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | none |
+| config | Configuration | none |
+
+
+
+
+## macro_with_ordinary_param_args_and_kwonlys
+
+
+macro_with_ordinary_param_args_and_kwonlys(name, *args, number, config)
+
+
+One ordinary param, *args, and several keyword-only params
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | none |
+| config | Configuration | none |
+| args | Positional arguments | none |
+
+
+
+
+## macro_with_ordinary_param_args_kwonlys_and_kwargs
+
+
+macro_with_ordinary_param_args_kwonlys_and_kwargs(name, *args, number, config, **kwargs)
+
+
+One ordinary param, *args, several keyword-only params, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | none |
+| config | Configuration | none |
+| args | Other positional arguments | none |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_ordinary_param_kwonlys_and_kwargs
+
+
+macro_with_ordinary_param_kwonlys_and_kwargs(name, *, number, config, **kwargs)
+
+
+One ordinary param, several keyword-only params, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | none |
+| config | Configuration | none |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_ordinary_params_and_kwonly
+
+
+macro_with_ordinary_params_and_kwonly(name, number, *, config)
+
+
+Several ordinary params and a keyword-only param
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| config | Configuration | none |
+
+
+
+
+## macro_with_ordinary_params_args_and_kwonly
+
+
+macro_with_ordinary_params_args_and_kwonly(name, number, *args, config)
+
+
+Several ordinary params, *args, and a keyword-only param
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| config | Configuration | none |
+| args | Positional arguments | none |
+
+
+
+
+## macro_with_ordinary_params_args_kwonly_and_kwargs
+
+
+macro_with_ordinary_params_args_kwonly_and_kwargs(name, number, *args, config, **kwargs)
+
+
+Several ordinary params, *args, one keyword-only param, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| config | Configuration | none |
+| args | Other positional arguments | none |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_ordinary_params_kwonly_and_kwargs
+
+
+macro_with_ordinary_params_kwonly_and_kwargs(name, number, *, config, **kwargs)
+
+
+Several ordinary params, a keyword-only param, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| config | Configuration | none |
+| kwargs | Other named arguments | none |
+
+
diff --git a/test/testdata/macro_kwargs_test/input.bzl b/test/testdata/macro_kwargs_test/input.bzl
index 8de782e2..844899d9 100644
--- a/test/testdata/macro_kwargs_test/input.bzl
+++ b/test/testdata/macro_kwargs_test/input.bzl
@@ -50,3 +50,211 @@ def macro_with_both(name, number = 3, *args, **kwargs):
"""
_ignore = [name, number, args, kwargs] # @unused
return []
+
+# buildifier: disable=unused-variable
+def macro_with_only_args(*args):
+ """Macro only taking *args
+
+ Args:
+ *args: Positional arguments
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_only_kwargs(**kwargs):
+ """Macro only taking **kwargs
+
+ Args:
+ **kwargs: Named arguments
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_only_args_and_kwargs(*args, **kwargs):
+ """Macro only taking *args and **kwargs
+
+ Args:
+ *args: Positional arguments
+ **kwargs: Named arguments
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_kwonly(*, name):
+ """One keyword-only param
+
+ Args:
+ name: The name
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_kwonlys(*, name, number = 3):
+ """Several keyword-only params
+
+ Args:
+ name: The name
+ number: The number
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_kwonly_and_kwargs(*, name, **kwargs):
+ """One keyword-only param and **kwargs
+
+ Args:
+ name: The name
+ **kwargs: Other named arguments
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_kwonlys_and_kwargs(*, name, number = 3, **kwargs):
+ """Several keyword-only params and **kwargs
+
+ Args:
+ name: The name
+ number: The number
+ **kwargs: Other named arguments
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_ordinary_params_and_kwonly(name, number = 3, *, config):
+ """Several ordinary params and a keyword-only param
+
+ Args:
+ name: The name
+ number: The number
+ config: Configuration
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_ordinary_param_and_kwonlys(name, *, number, config):
+ """One ordinary param and several keyword-only params
+
+ Args:
+ name: The name
+ number: The number
+ config: Configuration
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_ordinary_param_kwonlys_and_kwargs(name, *, number, config, **kwargs):
+ """One ordinary param, several keyword-only params, and **kwargs
+
+ Args:
+ name: The name
+ number: The number
+ config: Configuration
+ **kwargs: Other named arguments
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_ordinary_params_kwonly_and_kwargs(name, number = 3, *, config, **kwargs):
+ """Several ordinary params, a keyword-only param, and **kwargs
+
+ Args:
+ name: The name
+ number: The number
+ config: Configuration
+ **kwargs: Other named arguments
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_args_and_kwonly(*args, name):
+ """*args and a keyword-only param
+
+ Args:
+ *args: Positional arguments
+ name: The name
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_args_and_kwonlys(*args, name, number = 3):
+ """*args and several keyword-only params
+
+ Args:
+ *args: Positional arguments
+ name: The name
+ number: The number
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_args_kwonly_and_kwargs(*args, name, **kwargs):
+ """*args, a keyword-only param, and **kwargs
+
+ Args:
+ *args: Positional arguments
+ name: The name
+ **kwargs: Other named arguments
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_args_kwonlys_and_kwargs(*args, name, number = 3, **kwargs):
+ """*args, several keyword-only params, and **kwargs
+
+ Args:
+ *args: Positional arguments
+ name: The name
+ number: The number
+ **kwargs: Other named arguments
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_ordinary_params_args_and_kwonly(name, number = 3, *args, config):
+ """Several ordinary params, *args, and a keyword-only param
+
+ Args:
+ name: The name
+ number: The number
+ *args: Positional arguments
+ config: Configuration
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_ordinary_param_args_and_kwonlys(name, *args, number, config):
+ """One ordinary param, *args, and several keyword-only params
+
+ Args:
+ name: The name
+ *args: Positional arguments
+ number: The number
+ config: Configuration
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_ordinary_param_args_kwonlys_and_kwargs(name, *args, number, config, **kwargs):
+ """One ordinary param, *args, several keyword-only params, and **kwargs
+
+ Args:
+ name: The name
+ *args: Other positional arguments
+ number: The number
+ config: Configuration
+ **kwargs: Other named arguments
+ """
+ pass
+
+# buildifier: disable=unused-variable
+def macro_with_ordinary_params_args_kwonly_and_kwargs(name, number = 3, *args, config, **kwargs):
+ """Several ordinary params, *args, one keyword-only param, and **kwargs
+
+ Args:
+ name: The name
+ number: The number
+ *args: Other positional arguments
+ config: Configuration
+ **kwargs: Other named arguments
+ """
+ pass
diff --git a/test/testdata/macro_kwargs_test/legacy_golden.md b/test/testdata/macro_kwargs_test/legacy_golden.md
new file mode 100644
index 00000000..0b1f0403
--- /dev/null
+++ b/test/testdata/macro_kwargs_test/legacy_golden.md
@@ -0,0 +1,466 @@
+
+
+Tests for functions which use *args or **kwargs
+
+
+
+## macro_with_args
+
+
+macro_with_args(name, args)
+
+
+My args macro is OK.
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name of the test rule. | none |
+| args | Other arguments to include | none |
+
+**RETURNS**
+
+An empty list.
+
+
+
+
+## macro_with_args_and_kwonly
+
+
+macro_with_args_and_kwonly(name, args)
+
+
+*args and a keyword-only param
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| args | Positional arguments | none |
+
+
+
+
+## macro_with_args_and_kwonlys
+
+
+macro_with_args_and_kwonlys(name, number, args)
+
+
+*args and several keyword-only params
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| args | Positional arguments | none |
+
+
+
+
+## macro_with_args_kwonly_and_kwargs
+
+
+macro_with_args_kwonly_and_kwargs(name, args, kwargs)
+
+
+*args, a keyword-only param, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| args | Positional arguments | none |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_args_kwonlys_and_kwargs
+
+
+macro_with_args_kwonlys_and_kwargs(name, number, args, kwargs)
+
+
+*args, several keyword-only params, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| args | Positional arguments | none |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_both
+
+
+macro_with_both(name, number, args, kwargs)
+
+
+Oh wow this macro has both.
+
+Not much else to say.
+
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name of the test rule. | none |
+| number | Some number used for important things | `3` |
+| args | Other arguments to include | none |
+| kwargs | Other attributes to include | none |
+
+**RETURNS**
+
+An empty list.
+
+
+
+
+## macro_with_kwargs
+
+
+macro_with_kwargs(name, config, deps, kwargs)
+
+
+My kwargs macro is the best.
+
+This is a long multi-line doc string.
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer
+elementum, diam vitae tincidunt pulvinar, nunc tortor volutpat dui,
+vitae facilisis odio ligula a tortor. Donec ullamcorper odio eget ipsum tincidunt,
+vel mollis eros pellentesque.
+
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name of the test rule. | none |
+| config | Config to use for my macro | none |
+| deps | List of my macro's dependencies | `[]` |
+| kwargs | Other attributes to include | none |
+
+**RETURNS**
+
+An empty list.
+
+
+
+
+## macro_with_kwonly
+
+
+macro_with_kwonly(name)
+
+
+One keyword-only param
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+
+
+
+
+## macro_with_kwonly_and_kwargs
+
+
+macro_with_kwonly_and_kwargs(name, kwargs)
+
+
+One keyword-only param and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_kwonlys
+
+
+macro_with_kwonlys(name, number)
+
+
+Several keyword-only params
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+
+
+
+
+## macro_with_kwonlys_and_kwargs
+
+
+macro_with_kwonlys_and_kwargs(name, number, kwargs)
+
+
+Several keyword-only params and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_only_args
+
+
+macro_with_only_args(args)
+
+
+Macro only taking *args
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| args | Positional arguments | none |
+
+
+
+
+## macro_with_only_args_and_kwargs
+
+
+macro_with_only_args_and_kwargs(args, kwargs)
+
+
+Macro only taking *args and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| args | Positional arguments | none |
+| kwargs | Named arguments | none |
+
+
+
+
+## macro_with_only_kwargs
+
+
+macro_with_only_kwargs(kwargs)
+
+
+Macro only taking **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| kwargs | Named arguments | none |
+
+
+
+
+## macro_with_ordinary_param_and_kwonlys
+
+
+macro_with_ordinary_param_and_kwonlys(name, number, config)
+
+
+One ordinary param and several keyword-only params
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | none |
+| config | Configuration | none |
+
+
+
+
+## macro_with_ordinary_param_args_and_kwonlys
+
+
+macro_with_ordinary_param_args_and_kwonlys(name, number, config, args)
+
+
+One ordinary param, *args, and several keyword-only params
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | none |
+| config | Configuration | none |
+| args | Positional arguments | none |
+
+
+
+
+## macro_with_ordinary_param_args_kwonlys_and_kwargs
+
+
+macro_with_ordinary_param_args_kwonlys_and_kwargs(name, number, config, args, kwargs)
+
+
+One ordinary param, *args, several keyword-only params, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | none |
+| config | Configuration | none |
+| args | Other positional arguments | none |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_ordinary_param_kwonlys_and_kwargs
+
+
+macro_with_ordinary_param_kwonlys_and_kwargs(name, number, config, kwargs)
+
+
+One ordinary param, several keyword-only params, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | none |
+| config | Configuration | none |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_ordinary_params_and_kwonly
+
+
+macro_with_ordinary_params_and_kwonly(name, number, config)
+
+
+Several ordinary params and a keyword-only param
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| config | Configuration | none |
+
+
+
+
+## macro_with_ordinary_params_args_and_kwonly
+
+
+macro_with_ordinary_params_args_and_kwonly(name, number, config, args)
+
+
+Several ordinary params, *args, and a keyword-only param
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| config | Configuration | none |
+| args | Positional arguments | none |
+
+
+
+
+## macro_with_ordinary_params_args_kwonly_and_kwargs
+
+
+macro_with_ordinary_params_args_kwonly_and_kwargs(name, number, config, args, kwargs)
+
+
+Several ordinary params, *args, one keyword-only param, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| config | Configuration | none |
+| args | Other positional arguments | none |
+| kwargs | Other named arguments | none |
+
+
+
+
+## macro_with_ordinary_params_kwonly_and_kwargs
+
+
+macro_with_ordinary_params_kwonly_and_kwargs(name, number, config, kwargs)
+
+
+Several ordinary params, a keyword-only param, and **kwargs
+
+**PARAMETERS**
+
+
+| Name | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| name | The name | none |
+| number | The number | `3` |
+| config | Configuration | none |
+| kwargs | Other named arguments | none |
+
+
diff --git a/update-stardoc-tests.sh b/update-stardoc-tests.sh
index dca9b181..c79f50b1 100755
--- a/update-stardoc-tests.sh
+++ b/update-stardoc-tests.sh
@@ -37,7 +37,7 @@ function run_buildozer () {
# Some tests cannot be automatically regenerated using this script, as they don't fall under the normal
# golden test pattern or require a specific Bazel version
-EXCLUDED_TESTS="namespace_test_with_allowlist|multi_level_namespace_test_with_allowlist|local_repository_test|stamping_with_stamping_off"
+EXCLUDED_TESTS="namespace_test_with_allowlist|multi_level_namespace_test_with_allowlist|local_repository_test|stamping_with_stamping_off|macro_kwargs"
echo "** Querying for tests..."
regen_targets=$(${BAZEL} query //test:all | grep regenerate_ | grep -vE "_golden\.extract|$EXCLUDED_TESTS")