feature: option to not show enum values

[Ravencentric]

Is your feature request related to a problem? Please describe.

I have a Enum subclass that behaves identically to a StrEnum and that's all users need to know:

# Category behaves just like a `StrEnum`
>>> cat = Category.ANIME_ENGLISH_TRANSLATED
>>> f"{cat}"
'Anime - English-translated'
>>> cat.value
'Anime - English-translated'
>>> cat.name
'ANIME_ENGLISH_TRANSLATED'
>>>

The fact that internally the value is a tuple is an implementation detail that I don't want showing up in docs:

Describe the solution you'd like

I would love to have an option to not show enum values.

Describe alternatives you've considered

Disable enum members all together.

[pawamoy]

There's a show_attribute_value option that you could set to false when rendering the enum, would that work for you?

[Ravencentric]

That did the trick! Thank you. I've got this right now:

# enums.md
::: pynyaa.Category
    options:
        show_signature: false
        show_attribute_values: false
        show_if_no_docstring: true
        filters: ["!^_", "!^value"]
::: pynyaa.ParentCategory
    options:
        show_signature: false
        show_attribute_values: false
        show_if_no_docstring: true
        filters: ["!^_", "!^value"]
::: pynyaa.SortBy
    options:
        show_signature: false
        show_attribute_values: false
        show_if_no_docstring: true
        filters: ["!^_", "!^value"]
::: pynyaa.Order
    options:
        show_signature: false
        show_attribute_values: false
        show_if_no_docstring: true
        filters: ["!^_", "!^value"]
::: pynyaa.Filter
    options:
        show_signature: false
        show_attribute_values: false
        show_if_no_docstring: true
        filters: ["!^_", "!^value"]

Since these are specific to enums I'm repeating it for each. Can I specify them per file? E.g., on top of enums.md

[Ravencentric]

Also wanted to add that while show_attribute_values: false is better, it still ends up duping each member:

[Ravencentric]

Looks like separate_signature: false takes care of that too:

I'm happy with this! Sorry for bothering you. This could have been resolved if I read the docs more closely. Feel free to close this issue.

[pawamoy]

There's no way to specify options at the top of a file, no 😕

No worries, thanks for the updates and glad you solved your issue 😄