Movatterモバイル変換
[0]ホーム
11.11.1 NNTP Objects
NNTP instances have the following methods. Theresponse that isreturned as the first item in the return tuple of almost all methodsis the server's response: a string beginning with a three-digit code.If the server's response indicates an error, the method raises one ofthe above exceptions.
- getwelcome()
- Return the welcome message sent by the server in reply to the initialconnection. (This message sometimes contains disclaimers or helpinformation that may be relevant to the user.)
- set_debuglevel(level)
- Set the instance's debugging level. This controls the amount ofdebugging output printed. The default,
0, produces no debuggingoutput. A value of1 produces a moderate amount of debuggingoutput, generally a single line per request or response. A value of2 or higher produces the maximum amount of debugging output,logging each line sent and received on the connection (includingmessage text).
- newgroups(date, time)
- Send a "NEWGROUPS" command. Thedate argument should be astring of the form
'yymmdd' indicating thedate, andtime should be a string of the form'hhmmss' indicating the time. Return a pair(response,groups) wheregroups is a list ofgroup names that are new since the given date and time.
- newnews(group, date, time)
- Send a "NEWNEWS" command. Here,group is a group name or
'*', anddate andtime have the same meaning as fornewgroups(). Return a pair(response,articles) wherearticles is a list of article ids.
- list()
- Send a "LIST" command. Return a pair
(response,list) wherelist is a list of tuples. Each tuple has theform(group,last,first,flag), wheregroup is a group name,last andfirst are the lastand first article numbers (as strings), andflag is'y' if posting is allowed,'n' if not, and'm' ifthe newsgroup is moderated. (Note the ordering:last,first.)
- group(name)
- Send a "GROUP" command, wherename is the group name.Return a tuple
(response,count,first,last,name) wherecount is the (estimated) numberof articles in the group,first is the first article number inthe group,last is the last article number in the group, andname is the group name. The numbers are returned as strings.
- help()
- Send a "HELP" command. Return a pair
(response,list) wherelist is a list of help strings.
- stat(id)
- Send a "STAT" command, whereid is the message id (enclosedin "<" and ">") or an article number (as a string).Return a triple
(response,number,id) wherenumber is the article number (as a string) andid is thearticle id (enclosed in "<" and ">").
- next()
- Send a "NEXT" command. Return as forstat().
- last()
- Send a "LAST" command. Return as forstat().
- head(id)
- Send a "HEAD" command, whereid has the same meaning as forstat(). Return a tuple
(response,number,id,list)where the first three are the same as forstat(),andlist is a list of the article's headers (an uninterpretedlist of lines, without trailing newlines).
- body(id,[file])
- Send a "BODY" command, whereid has the same meaning as forstat(). If thefile parameter is supplied, thenthe body is stored in a file. Iffile is a string, thenthe method will open a file object with that name, write to it then close it.Iffile is a file object, then it will start callingwrite() on it to store the lines of the body.Return as forhead(). Iffile is supplied. Thenthe returnedlist is an empty list.
- article(id)
- Send an "ARTICLE" command, whereid has the same meaning asforstat(). Return as forhead().
- slave()
- Send a "SLAVE" command. Return the server'sresponse.
- xhdr(header, string)
- Send an "XHDR" command. This command is not defined in the RFCbut is a common extension. Theheader argument is a headerkeyword, e.g.
'subject'. Thestring argument should havethe form'first-last' wherefirst andlast are the first and last article numbers to search. Return apair(response,list), wherelist is a list ofpairs(id,text), whereid is an article id(as a string) andtext is the text of the requested header forthat article.
- post(file)
- Post an article using the "POST" command. Thefileargument is an open file object which is read until EOF using itsreadline() method. It should be a well-formed news article,including the required headers. Thepost() methodautomatically escapes lines beginning with ".".
- ihave(id, file)
- Send an "IHAVE" command. If the response is not an error, treatfile exactly as for thepost() method.
- date()
- Return a triple
(response,date,time),containing the current date and time in a form suitable for thenewnews() andnewgroups() methods.This is an optional NNTP extension, and may not be supported by allservers.
- xgtitle(name)
- Process an "XGTITLE" command, returning a pair
(response,list), wherelist is a list of tuples containing(name,title).This is an optional NNTP extension, and may not be supported by allservers.
- xover(start, end)
- Return a pair
(resp,list).list is a listof tuples, one for each article in the range delimited by thestartandend 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 allservers.
- xpath(id)
- Return a pair
(resp,path), wherepath is thedirectory path to the article with message IDid. This is anoptional NNTP extension, and may not be supported by all servers.
- quit()
- Send a "QUIT" command and close the connection. Once this methodhas been called, no other methods of the NNTP object should be called.
SeeAbout this document... for information on suggesting changes.
[8]ページ先頭
