• Home
  • Raw
  • Download

Lines Matching refs:NNTP

1 :mod:`nntplib` --- NNTP protocol client
5 :synopsis: NNTP protocol client (requires sockets).
10 pair: NNTP; protocol
15 This module defines the class :class:`NNTP` which implements the client side of
23 >>> s = nntplib.NNTP('news.gmane.org')
47 >>> s = nntplib.NNTP('news.gmane.org')
57 .. class:: NNTP(host, port=119, user=None, password=None, readermode=None, usenetrc=False, [timeout…
59 Return a new :class:`NNTP` object, representing a connection
60 to the NNTP server running on host *host*, listening at port *port*.
68 connecting to an NNTP server on the local machine and intend to call
71 The :class:`NNTP` class supports the :keyword:`with` statement to
72 unconditionally consume :exc:`OSError` exceptions and to close the NNTP
75 >>> from nntplib import NNTP
76 >>> with NNTP('news.gmane.org') as n:
92 connection to the NNTP server running on host *host*, listening at
94 :class:`NNTP` objects. If *port* is omitted, port 563 (NNTPS) is used.
97 All other parameters behave the same as for :class:`NNTP`.
149 NNTP Objects
152 When connected, :class:`NNTP` and :class:`NNTP_SSL` objects support the
158 .. attribute:: NNTP.nntp_version
160 An integer representing the version of the NNTP protocol supported by the
166 .. attribute:: NNTP.nntp_implementation
168 A string describing the software name and version of the NNTP server,
193 .. method:: NNTP.quit()
196 called, no other methods of the NNTP object should be called.
199 .. method:: NNTP.getwelcome()
206 .. method:: NNTP.getcapabilities()
213 >>> s = NNTP('news.gmane.org')
220 .. method:: NNTP.login(user=None, password=None, usenetrc=True)
227 :class:`NNTP` object initialization and separately calling this function
235 .. method:: NNTP.starttls(context=None)
237 Send a ``STARTTLS`` command. This will enable encryption on the NNTP
244 :class:`NNTP` object initialization. See :meth:`NNTP.login` for information
254 .. method:: NNTP.newgroups(date, *, file=None)
270 .. method:: NNTP.newnews(group, date, *, file=None)
276 This command is frequently disabled by NNTP server administrators.
279 .. method:: NNTP.list(group_pattern=None, *, file=None)
283 the groups available from this NNTP server, optionally matching the
307 .. method:: NNTP.descriptions(grouppattern)
321 .. method:: NNTP.description(group)
331 .. method:: NNTP.group(name)
341 .. method:: NNTP.over(message_spec, *, file=None)
356 following items are guaranteed to be present by the NNTP specification:
384 .. method:: NNTP.help(*, file=None)
390 .. method:: NNTP.stat(message_spec=None)
404 .. method:: NNTP.next()
409 .. method:: NNTP.last()
414 .. method:: NNTP.article(message_spec=None, *, file=None)
439 .. method:: NNTP.head(message_spec=None, *, file=None)
446 .. method:: NNTP.body(message_spec=None, *, file=None)
453 .. method:: NNTP.post(data)
466 .. method:: NNTP.ihave(message_id, data)
473 .. method:: NNTP.date()
479 .. method:: NNTP.slave()
484 .. method:: NNTP.set_debuglevel(level)
494 The following are optional NNTP extensions defined in :rfc:`2980`. Some of
498 .. method:: NNTP.xhdr(hdr, str, *, file=None)
513 .. method:: NNTP.xover(start, end, *, file=None)
522 .. method:: NNTP.xpath(id)
526 enabled by NNTP server administrators.
534 .. method:: NNTP.xgtitle(name, *, file=None)
542 is supplied, then the returned *list* is an empty list. This is an optional NNTP