NNTP instances have the following methods. The response that is returned as the first item in the return tuple of almost all methods is the server's response: a string beginning with a three-digit code. If the server's response indicates an error, the method raises one of the above exceptions.
0, produces no debugging output. A value of
1produces a moderate amount of debugging output, generally a single line per request or response. A value of
2or higher produces the maximum amount of debugging output, logging each line sent and received on the connection (including message text).
'yymmdd'indicating the date, and time should be a string of the form
'hhmmss'indicating the time. Return a pair
(response, groups)where groups is a list of group names that are new since the given date and time.
'*', and date and time have the same meaning as for newgroups(). Return a pair
(response, articles)where articles is a list of article ids.
(response, list)where list is a list of tuples. Each tuple has the form
(group, last, first, flag), where group is a group name, last and first are the last and first article numbers (as strings), and flag is
'y'if posting is allowed,
'n'if not, and
'm'if the newsgroup is moderated. (Note the ordering: last, first.)
(response, count, first, last, name)where count is the (estimated) number of articles in the group, first is the first article number in the group, last is the last article number in the group, and name is the group name. The numbers are returned as strings.
(response, list)where list is a list of help strings.
(response, number, id)where number is the article number (as a string) and id is the article id (enclosed in "<" and ">").
(response, number, id, list)where the first three are the same as for stat(), and list is a list of the article's headers (an uninterpreted list of lines, without trailing newlines).
'subject'. The string argument should have the form
'first-last'where first and last are the first and last article numbers to search. Return a pair
(response, list), where list is a list of pairs
(id, text), where id is an article id (as a string) and text is the text of the requested header for that article.
(response, date, time), containing the current date and time in a form suitable for the newnews() and newgroups() methods. This is an optional NNTP extension, and may not be supported by all servers.
(response, list), where list is a list of tuples containing
(name, title). This is an optional NNTP extension, and may not be supported by all servers.
(resp, list). list is a list of tuples, one for each article in the range delimited by the start and end article numbers. Each tuple is of the form
(article number, subject, poster, date, id, references, size, lines). This is an optional NNTP extension, and may not be supported by all servers.
(resp, path), where path is the directory path to the article with message ID id. This is an optional NNTP extension, and may not be supported by all servers.