Author Arfrever
Recipients Arfrever, Denis.Bilenko, alex, barry, benjamin.peterson, christian.heimes, dstufft, giampaolo.rodola, janssen, lemburg, pitrou
Date 2014-11-07.10:52:28
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1415357549.56.0.574675000878.issue22438@psf.upfronthosting.co.za>
In-reply-to
Content
> No, the use of the underscore in _ssl is per convention that C
> implementation part of stdlib modules are moved into modules that
> start with an underscore. This doesn't mean that the APIs in
> those modules are private, otherwise many C implementations we have
> in the stdlib would be private :-)

The non-private C-implemented modules are these:

$ cd /usr/lib64/python2.7/lib-dynload ; echo [^_]*.so
array.so audioop.so binascii.so bz2.so cmath.so cPickle.so crypt.so cStringIO.so datetime.so dbm.so fcntl.so future_builtins.so gdbm.so grp.so itertools.so linuxaudiodev.so math.so mmap.so nis.so operator.so ossaudiodev.so parser.so pyexpat.so readline.so resource.so select.so spwd.so strop.so syslog.so termios.so time.so unicodedata.so zlib.so

_[^_]-prefixed, undocumented modules (amongst whom are both _[^_].py and _[^_].so) should be treated as private modules for usage only by public modules in standard library.

(_winreg is the only _[^_]-prefixed, documented module in CPython 2.7.)
History
Date User Action Args
2014-11-07 10:52:29Arfreversetrecipients: + Arfrever, lemburg, barry, janssen, pitrou, giampaolo.rodola, christian.heimes, benjamin.peterson, alex, Denis.Bilenko, dstufft
2014-11-07 10:52:29Arfreversetmessageid: <1415357549.56.0.574675000878.issue22438@psf.upfronthosting.co.za>
2014-11-07 10:52:29Arfreverlinkissue22438 messages
2014-11-07 10:52:28Arfrevercreate