home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / python / pyhtmldoc / n / nntplib < prev    next >
Text File  |  1996-11-14  |  3KB  |  74 lines
  1. <TITLE>nntplib -- Python library reference</TITLE>
  2. Next: <A HREF="../u/urlparse" TYPE="Next">urlparse</A>  
  3. Prev: <A HREF="../g/gopherlib" TYPE="Prev">gopherlib</A>  
  4. Up: <A HREF="../i/internet_and_www" TYPE="Up">Internet and WWW</A>  
  5. Top: <A HREF="../t/top" TYPE="Top">Top</A>  
  6. <H1>10.6. Standard Module <CODE>nntplib</CODE></H1>
  7. This module defines the class <CODE>NNTP</CODE> which implements the client
  8. side of the NNTP protocol.  It can be used to implement a news reader
  9. or poster, or automated news processors.  For more information on NNTP
  10. (Network News Transfer Protocol), see Internet RFC 977.
  11. <P>
  12. Here are two small examples of how it can be used.  To list some
  13. statistics about a newsgroup and print the subjects of the last 10
  14. articles:
  15. <P>
  16. @small{
  17. <UL COMPACT><CODE>>>> s = NNTP('news.cwi.nl')<P>
  18. >>> resp, count, first, last, name = s.group('comp.lang.python')<P>
  19. >>> print 'Group', name, 'has', count, 'articles, range', first, 'to', last<P>
  20. Group comp.lang.python has 59 articles, range 3742 to 3803<P>
  21. >>> resp, subs = s.xhdr('subject', first + '-' + last)<P>
  22. >>> for id, sub in subs[-10:]: print id, sub<P>
  23. ... <P>
  24. 3792 Re: Removing elements from a list while iterating...<P>
  25. 3793 Re: Who likes Info files?<P>
  26. 3794 Emacs and doc strings<P>
  27. 3795 a few questions about the Mac implementation<P>
  28. 3796 Re: executable python scripts<P>
  29. 3797 Re: executable python scripts<P>
  30. 3798 Re: a few questions about the Mac implementation <P>
  31. 3799 Re: PROPOSAL: A Generic Python Object Interface for Python C Modules<P>
  32. 3802 Re: executable python scripts <P>
  33. 3803 Re: POSIX wait and SIGCHLD<P>
  34. >>> s.quit()<P>
  35. '205 news.cwi.nl closing connection.  Goodbye.'<P>
  36. >>> <P>
  37. </CODE></UL>
  38. }
  39. <P>
  40. To post an article from a file (this assumes that the article has
  41. valid headers):
  42. <P>
  43. <UL COMPACT><CODE>>>> s = NNTP('news.cwi.nl')<P>
  44. >>> f = open('/tmp/article')<P>
  45. >>> s.post(f)<P>
  46. '240 Article posted successfully.'<P>
  47. >>> s.quit()<P>
  48. '205 news.cwi.nl closing connection.  Goodbye.'<P>
  49. >>> <P>
  50. </CODE></UL>
  51. The module itself defines the following items:
  52. <P>
  53. <DL><DT><B>NNTP</B> (<VAR>host</VAR>[, <VAR>port</VAR>]) -- function of module nntplib<DD>
  54. Return a new instance of the <CODE>NNTP</CODE> class, representing a
  55. connection to the NNTP server running on host <VAR>host</VAR>, listening at
  56. port <VAR>port</VAR>.  The default <VAR>port</VAR> is 119.
  57. </DL>
  58. <DL><DT><B>error_reply</B> -- exception of module nntplib<DD>
  59. Exception raised when an unexpected reply is received from the server.
  60. </DL>
  61. <DL><DT><B>error_temp</B> -- exception of module nntplib<DD>
  62. Exception raised when an error code in the range 400--499 is received.
  63. </DL>
  64. <DL><DT><B>error_perm</B> -- exception of module nntplib<DD>
  65. Exception raised when an error code in the range 500--599 is received.
  66. </DL>
  67. <DL><DT><B>error_proto</B> -- exception of module nntplib<DD>
  68. Exception raised when a reply is received from the server that does
  69. not begin with a digit in the range 1--5.
  70. </DL>
  71. <H2>Menu</H2><DL COMPACT>
  72. <DT><A HREF="../n/nntp_objects" TYPE=Menu>NNTP Objects</A>
  73. <DD></DL>
  74.