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 brett.cannon
Recipients Saimadhav.Heblikar, brett.cannon, docs@python, eric.snow, ncoghlan
Date 2014-03-31.15:54:08
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1396281249.37.0.865129120199.issue21108@psf.upfronthosting.co.za>
In-reply-to
Content
While I'm totally happy to add examples on usage, it is probably best to put them at the end of the class-level docs instead of trailing after the last method of the class. That way someone reading about what the class does can also see examples of how to use it.

Another point is that SourceFileLoader.load_module() is documented as deprecated as of Python 3.4 and so promoting it in an example is not good. Now that module creation has been broken out separately this "create a module from a file path" approach is becoming more and more difficult. If we care to continue to support this use case we will probably need to come up with a function(s) to make it easier and toss something up on PyPI that is Python 2.7-3.5 compatible.
History
Date User Action Args
2014-03-31 15:54:09brett.cannonsetrecipients: + brett.cannon, ncoghlan, docs@python, eric.snow, Saimadhav.Heblikar
2014-03-31 15:54:09brett.cannonsetmessageid: <1396281249.37.0.865129120199.issue21108@psf.upfronthosting.co.za>
2014-03-31 15:54:09brett.cannonlinkissue21108 messages
2014-03-31 15:54:08brett.cannoncreate