• Home
  • History
  • Annotate
  • Raw
  • Download

Lines Matching +full:where +full:- +full:object

1 :mod:`nntplib` --- NNTP protocol client
13 --------------
27 >>> resp, overviews = s.over((last - 9, last))
59 Return a new :class:`NNTP` object, representing a connection
69 reader-specific commands, such as ``group``. If you get unexpected
91 Return a new :class:`NNTP_SSL` object, representing an encrypted
95 *ssl_context* is also optional, and is a :class:`~ssl.SSLContext` object.
96 Please read :ref:`ssl-security` for best practices.
99 Note that SSL-on-563 is discouraged per :rfc:`4642`, in favor of
118 The response of the server if available, as a :class:`str` object.
128 Exception raised when a response code in the range 400--499 is received.
133 Exception raised when a response code in the range 500--599 is received.
139 with a digit in the range 1--5.
147 .. _nntp-objects:
150 ------------
177 all methods is the server's response: a string beginning with a three-digit
181 Many of the following methods take an optional keyword-only argument *file*.
182 When the *file* argument is supplied, it must be either a :term:`file object`
183 opened for binary writing, or the name of an on-disk file to be written to.
196 called, no other methods of the NNTP object should be called.
227 :class:`NNTP` object initialization and separately calling this function
229 *user* or *password* when creating the object, and must set *usenetrc* to
239 :class:`ssl.SSLContext` object. Please read :ref:`ssl-security` for best
244 :class:`NNTP` object initialization. See :meth:`NNTP.login` for information
257 :class:`datetime.date` or :class:`datetime.datetime` object.
258 Return a pair ``(response, groups)`` where *groups* is a list representing
263 >>> resp, groups = s.newgroups(date.today() - timedelta(days=3))
274 ``(response, articles)`` where *articles* is a list of message ids.
282 ``(response, list)`` where *list* is a list of tuples representing all
285 ``(group, last, first, flag)``, where *group* is a group name, *last*
309 Send a ``LIST NEWSGROUPS`` command, where *grouppattern* is a wildmat string as
311 strings). Return a pair ``(response, descriptions)``, where *descriptions*
333 Send a ``GROUP`` command, where *name* is the group name. The group is
335 ``(response, count, first, last, name)`` where *count* is the (estimated)
354 message headers (the key is then the lower-cased header name) or metadata
358 * the ``subject``, ``from``, ``date``, ``message-id`` and ``references``
367 values when they may contain non-ASCII characters::
375 ['xref', 'from', ':lines', ':bytes', 'references', 'date', 'message-id', 'subject']
377 '=?UTF-8?B?Ik1hcnRpbiB2LiBMw7Z3aXMi?= <martin@v.loewis.de>'
386 Send a ``HELP`` command. Return a pair ``(response, list)`` where *list* is a
392 Send a ``STAT`` command, where *message_spec* is either a message id
396 where *number* is the article number and *id* is the message id.
416 Send an ``ARTICLE`` command, where *message_spec* has the same meaning as
417 for :meth:`.stat`. Return a tuple ``(response, info)`` where *info*
432 b'Path: main.gmane.org!not-for-mail'
435 >>> info.lines[-3:]
456 a :term:`file object` opened for binary reading, or any iterable of bytes
458 represent a well-formed news article, including the required headers. The
476 object containing the current date and time of the server.
501 ``'subject'``. The *str* argument should have the form ``'first-last'``
502 where *first* and *last* are the first and last article numbers to search.
503 Return a pair ``(response, list)``, where *list* is a list of pairs ``(id,
504 text)``, where *id* is an article number (as a string) and *text* is the text of
508 If *file* is a :term:`file object`, then it will start calling :meth:`write` on
524 Return a pair ``(resp, path)``, where *path* is the directory path to the
536 Process an ``XGTITLE`` command, returning a pair ``(response, list)``, where
540 to it then close it. If *file* is a :term:`file object`, then it will start
550 -----------------
557 Decode a header value, un-escaping any escaped non-ASCII characters.
558 *header_str* must be a :class:`str` object. The unescaped value is
564 >>> decode_header("=?ISO-8859-15?Q?D=E9buter_en_Python?=")
566 >>> decode_header("Re: =?UTF-8?B?cHJvYmzDqG1lIGRlIG1hdHJpY2U=?=")