feat: Sort by visibility

[RagnarGrootKoerkamp]

Thanks for this great tool! It's a great way for me to check what types I'm exporting once a crate is done.

This would be slightly easier to do if it were possible to sort the generate tree output by (decreasing) visibility, so that all pub items come first.

Would you accept a PR to add maybe a --sort-by-visibility flag?

I could also see use for a --pub-only flag that only shows items that are externally visible.

[regexident]

Hi @RagnarGrootKoerkamp, thanks for the feature request!

Both, --sort-by-visibility and --pub-only seem like a well-motivated suggestion to me. However I try to avoid one-off features and/or options to the CLI tool, preferring more generalized approaches.

As such rather than --sort-by-visibility, I would instead prefer adding --sort-by <SORT_KEY> option, which I just did with #218.

As for --pub-only I would prefer something along a more general --filter-by. But this needs a bit more thinking. Please feel free to open a separate feature request for being able to filter the output (e.g. by visibility).

[regexident]

@RagnarGrootKoerkamp version 0.11.0 has just been published with support for sorting the output of the generate tree command via --sort-by <KEY> (where <KEY> is one of name, visibility, or kind) and --sort-reversed CLI options.

[RagnarGrootKoerkamp]

I just tried it and --sort-by visibility looks great, thanks for implementing this!
Good idea to also add --sort-by kind, I was thinking of that as well at some point.

--pub-only seems less necessary now, since sorting public items at the top already gives me a very good overview of exported items anyway.