🐷

This doesn't feel like a totally correct use of "unquote" to me... Maybe the parameter could be calledremove_annotation_quotes instead ofunquote_annotation...? I think that might also reflect slightly better the fact that not all annotations will necessarily be quoted at all.

We use "unquote" in various other places (e.g.,https://docs.python.org/3.13/library/csv.html#csv.QUOTE_NOTNULL); I feel it's more clear and concise

"unquoted" is used inhttps://docs.python.org/3.13/library/csv.html#csv.QUOTE_NOTNULL as an adjective rather than a verb. I think it makes sense to talk about something being "unquoted" but less sense to talk about "unquoting" something.

"dequote"?

If I'm reading the code correctly, if this is false (the default) we userepr on annotation values that are strings, and if it's true we skiprepr only for strings. So this is a passive operation--if the value is true, wedon't do something, and when it's false wedo do something. I think that's why this is awkward.

I suggest the clearest way to express this is to flip it. Negate the boolean and rename itquote_annotations=True. If it's true (the default) we quote annotations, and if it's false we don't. I might even go with the wordierquote_annotation_strings=True, as we're only allowing the user to control quoting or not-quoting the annotations when they're strings. But I don't have a strong opinion about that.

Good idea, changing that.

It's a minor thing, but:globals,locals, andeval_str are passed in to parameters with the same name when callingget_annotations. Butannotation_format is passed in to a parameter with a different name (justformat). It might be nice to explicitly tell that to the user.

I realize the documentation doesn't explicitly detail where these parameters go, so this would be all-new text. And when I try it in my head it always comes across as clumsy. So... should we even bother to try? Would anybody be confused if we didn't bother to explain it?

Good point, I will add a separate sentence about theannotation_format parameter.

If I'm reading the code correctly, if this is false (the default) we userepr on annotation values that are strings, and if it's true we skiprepr only for strings. So this is a passive operation--if the value is true, wedon't do something, and when it's false wedo do something. I think that's why this is awkward.

I suggest the clearest way to express this is to flip it. Negate the boolean and rename itquote_annotations=True. If it's true (the default) we quote annotations, and if it's false we don't. I might even go with the wordierquote_annotation_strings=True, as we're only allowing the user to control quoting or not-quoting the annotations when they're strings. But I don't have a strong opinion about that.