Request: Allow comments on macro arguments

[chrisp60]

I am using git main

Admittedly, this use case is derived from a somewhat degenerate pattern.

I can define this macro...

{% macro input(name, value = "") %}
   <input name="{{ name }}" value="{{ value }}">
{% endmacro input %}

This fails to compile...

{% macro input(
    {# the name attribute of the input #}
    name, 
    value = "",
) %}
   <input name="{{ name }}" value="{{ value }}">
{% endmacro input %}

The error provided is... error: expected)to close macro argument list The error correctly points to the issue.

My use case for wanting this feature is the below macro definition. I have to make a substantial amount of user forms for my project.

{% macro input(
  name, 
  value = "", 
  label = "",
  prefix = "",
  kind = "text",
  autocomplete = "",
  required = false,
  div = "col-md-12 col-lg-4",
  attrs = "",
  ...[plus many more]
) %}

Why I am requesting this

• It would be convenient
• I would not have to parse through the actual macro body to see how each argument is used.

Why this may not be a good feature

• You cannot comment arguments in normal rust code.
• You could just comment the macro itself (then you would need to ensure it is synced to the macro body).
• It may not be common for users to have macros with substantial amounts of arguments.
• It could be a maintenance burden.
• At some point, just use a normal rust builder pattern (like bon or typed_builder)

I would not at all be disappointed if this was rejected. If approved, I could attempt an implementation

[GuillaumeGomez]

Problem here is that you want to be able add a delimiter inside a delimiter, which is not allowed in the jinja syntax. I agree it would be nice to be able to add docs on arguments, but in this case, it'd make rinja not compliant with jinja.

[chrisp60]

Yeah that is not something I did not even begin to consider. Up to you if you want to leave this up as a possibility for the future.

I imagine the compatibility is something you would prefer to keep. I am inclined to believe you if you say it just isn't possible.