Author Steve Barnes
Recipients Eric Lafontaine, Steve Barnes, docs@python, gvanrossum, rhettinger, tebeka
Date 2017-08-11.06:53:44
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1502434425.81.0.180402591225.issue28972@psf.upfronthosting.co.za>
In-reply-to
Content
Having done some checks for the practicality of auto documenting library items with a -m command line usage I have to say that it will not be so simple. 

Many of the library items that provide useful functionality, including zipfile & tarfile, are implemented as single .py files, rather than as modules so have no __main__.py to trigger the inclusion in auto-generated documentation. 

I also tried searching for standard library items that use `if __name__ == "__main__":` constructs but, of course, many files simply use that to expose tests rather than useful functionality - so that is out as well. I even thought of trying for a regex that would look for this followed, in the same scope by argparse but of course there is no obligation to use it.

And of course main() does not HAVE to be called main so that is out.

Sorry to scotch the idea Eric!
History
Date User Action Args
2017-08-11 06:53:45Steve Barnessetrecipients: + Steve Barnes, gvanrossum, rhettinger, tebeka, docs@python, Eric Lafontaine
2017-08-11 06:53:45Steve Barnessetmessageid: <1502434425.81.0.180402591225.issue28972@psf.upfronthosting.co.za>
2017-08-11 06:53:45Steve Barneslinkissue28972 messages
2017-08-11 06:53:44Steve Barnescreate