Idea: filters for private (starts with an underscore) functions and methods

[simonw]

Maybe like this:

• --private - only functions and methods with a name that starts with _
• --unprivate (or --public - but --unprivate is more consistent with --undocumented and--untypedand--unasync`) - exclude those private methods and functions
• --dunder - only functions and methods that match are __blah__.

Open question: should --private return __init__ etc? Are dunder methods considered private? I think probably not.

[simonw]

My main use-case for this is a CI check which enforces documentation on everything except for private functions and methods:

symbex --unprivate --undocumented --check

For that example though I do think this might feel more natural:

symbex --public --undocumented --check

[simonw]

I think classes with a leading _ in their name _MyClass should be treated as matching the private filter too.

[simonw]

Docs: https://github.com/simonw/symbex/blob/ced957da0569777efdfbd12a9a828e5816c06c54/README.md?plain=1#L103-L105