This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author paul.j3
Recipients Bernhard10, paul.j3, terry.reedy
Date 2017-12-06.18:21:37
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1512584498.0.0.213398074469.issue32123@psf.upfronthosting.co.za>
In-reply-to
Content
A difficulty with writing a public API is that useful changes can occur at almost any level of the class.

The existing subclasses modify small, but deep methods, ones that handle things like line wrapping.

On the other hand, most of the issues you cite deal with higher level issues, either the top most method of the formatter, or alternatives to parser.format_help or parser._get_formatter (which create and populate a formatter object).

I've also responded to issues dealing with intermediate levels things, like the need for a more robust usage formatting, and changing how help lines are constructed.

The argparse documentation is a mix of how-to and formal API.  Mostly it describes how to perform common parsing tasks.  Even though argparse consists of classes, the documentation does not formally describe the classes, and their subclassing and all methods.  It's not a reference API.
History
Date User Action Args
2017-12-06 18:21:38paul.j3setrecipients: + paul.j3, terry.reedy, Bernhard10
2017-12-06 18:21:38paul.j3setmessageid: <1512584498.0.0.213398074469.issue32123@psf.upfronthosting.co.za>
2017-12-06 18:21:37paul.j3linkissue32123 messages
2017-12-06 18:21:37paul.j3create