Modules implicitly exposing exceptions from other modules

Fred L. Drake, Jr. fdrake at
Mon Feb 14 20:15:36 CET 2000

Jason Stokes writes:
 > I notice that the nntplib.NNTP class can throw exceptions from the
 > underlying socket module without documenting them.  What's good practice
 > when your module involves exposing exceptions from an implementation module
 > that client code might not necessarily be aware of?

  Document them if they would not be expected by an experienced
programmer.  In general, all network access can throw socket.error,
and that seems a reasonable expectation.
  If you think specific changes are appropriate to the documentation,
please send a patch (with disclaimers; 
to python-docs at


Fred L. Drake, Jr.	  <fdrake at>
Corporation for National Research Initiatives

More information about the Python-list mailing list