NNTP Class Reference

Public Member Functions
def	__init__
def	getwelcome
def	set_debuglevel
def	putline
def	putcmd
def	getline
def	getresp
def	getlongresp
def	shortcmd
def	longcmd
def	newgroups
def	newnews
def	list
def	group
def	help
def	statparse
def	statcmd
def	stat
def	next
def	last
def	artcmd
def	head
def	body
def	article
def	slave
def	xhdr
def	xover
def	xgtitle
def	xpath
def	date
def	post
def	ihave
def	quit

Data Fields
	host
	port
	sock
	file
	debugging
	welcome

Static Public Attributes
	debug = set_debuglevel

Detailed Description

Definition at line 94 of file nntplib.py.

Constructor & Destructor Documentation

def __init__	(		self,
			host,
			port = NNTP_PORT,
			user = None,
			password = None,
			readermode = None
	)

Initialize an instance.  Arguments:
- host: hostname to connect to
- port: port to connect to (default the standard NNTP port)
- user: username to authenticate with
- password: password to use with username
- readermode: if true, send 'mode reader' command after
      connecting.

readermode is sometimes necessary if you are connecting to an
NNTP server on the local machine and intend to call
reader-specific comamnds, such as `group'.  If you get
unexpected NNTPPermanentErrors, you might need to set
readermode.

Definition at line 96 of file nntplib.py.

                 readermode=None):
        """Initialize an instance.  Arguments:
        - host: hostname to connect to
        - port: port to connect to (default the standard NNTP port)
        - user: username to authenticate with
        - password: password to use with username
        - readermode: if true, send 'mode reader' command after
                      connecting.

        readermode is sometimes necessary if you are connecting to an
        NNTP server on the local machine and intend to call
        reader-specific comamnds, such as `group'.  If you get
        unexpected NNTPPermanentErrors, you might need to set
        readermode.
        """
        self.host = host
        self.port = port
        self.sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
        self.sock.connect((self.host, self.port))
        self.file = self.sock.makefile('rb')
        self.debugging = 0
        self.welcome = self.getresp()

        # 'mode reader' is sometimes necessary to enable 'reader' mode.
        # However, the order in which 'mode reader' and 'authinfo' need to
        # arrive differs between some NNTP servers. Try to send
        # 'mode reader', and if it fails with an authorization failed
        # error, try again after sending authinfo.
        readermode_afterauth = 0
        if readermode:
            try:
                self.welcome = self.shortcmd('mode reader')
            except NNTPPermanentError:
                # error 500, probably 'not implemented'
                pass
            except NNTPTemporaryError, e:
                if user and e.response[:3] == '480':
                    # Need authorization before 'mode reader'
                    readermode_afterauth = 1
                else:
                    raise
        if user:
            resp = self.shortcmd('authinfo user '+user)
            if resp[:3] == '381':
                if not password:
                    raise NNTPReplyError(resp)
                else:
                    resp = self.shortcmd(
                            'authinfo pass '+password)
                    if resp[:3] != '281':
                        raise NNTPPermanentError(resp)
            if readermode_afterauth:
                try:
                    self.welcome = self.shortcmd('mode reader')
                except NNTPPermanentError:
                    # error 500, probably 'not implemented'
                    pass