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:

symbex/README.md

Lines 103 to 105 in ced957d

	- `--public` - functions/classes that are public - don't have a `_name` prefix (or are `__*__` methods)
	- `--private` - functions/classes that are private - have a `_name` prefix and are not `__*__`
	- `--dunder` - functions matching `__*__` - this should usually be used with `*.*` to find all dunder methods