Poplib модулі

Тағыда бір хаттама - POP3 (Post Office Protocol, почталық хаттама) – серверде почталық жәшіктен почта қабылдау үшін қызмет етеді (хаттама RFC 1725 анықталған).

Почталық сервермен жұмыс істеу үшін олармен байланыс орнату керек және, жоғарыда қаралған мысал тәрізді, SMTP-командасының көмегімен талап етілген хабарламаларды алу. POP3 байланыс обьектісімен poplib модуліндегі POP3 конструктор классы арқылы орнатуға болады:

poplib.POP3(host[, port])

Мұндағы host - POP3-серверінің адресі, port - сервердегі порт (үнсіз келісім бойынша 110), pop_obj- POP3-серверімен жұмыс сеансын басқару үшін обьекті.

Келесі мысал POP3-байланысымен жұмыс істеу үшін негізгі әдістерді көрсетеді.

import poplib, email

# Қолданушының есептiк деректерi:

SERVER = "pop.server.com"

USERNAME = "user"

USERPASSWORD = "secretword"

p = poplib.POP3(SERVER)

print p.getwelcome()

# бiрдейлендiрудiң кезеңi

print p.user(USERNAME)

print p.pass_(USERPASSWORD)

# транзакциялау кезеңі

response, lst, octets = p.list()

print response

for msgnum, msgsize in [i.split() for i in lst]:

print "Сообщение %(msgnum)s имеет длину %(msgsize)s" % vars()

print "UIDL =", p.uidl(int(msgnum)).split()[2]

if int(msgsize) > 32000:

(resp, lines, octets) = p.top(msgnum, 0)

else:

(resp, lines, octets) = p.retr(msgnum)

msgtxt = "\n".join(lines)+"\n\n"

msg = email.message_from_string(msgtxt)

print "* От: %(from)s\n* Кому: %(to)s\n* Тема: %(subject)s\n" % msg

# msg содержит заголовки сообщения или все сообщение (если оно небольшое)

# этап обновления

print p.quit()

Ескерту:

Әлбетте, мысал нақты істеу үшін нақты есептік деректерді енгізу керек.

Сценарий орындалу кезде экранға келесідей шығарады:

+OK POP3 pop.server.com server ready

+OK User name accepted, password please

+OK Mailbox open, 68 messages

+OK Mailbox scan listing follows

Сообщение 1 имеет длину 4202

UIDL = 4152a47e00000004

* От: online@kaspersky.com

* Кому: user@server.com

* Тема: KL Online Activation

...

+OK Sayonara

Осы және басқа POP3 классының көшірмелерінің әдістері төменде сипатталған:

Әдіс	POP3 командасы	сипатталуы
getwelcome()		POP3-сервері бойынша s жолын алады.
user(name)	USER name	name қолданушы атымен көрсетілген USER командасын жібереді.
pass_(pwd)	PASS pwd	PASS командасында қолданушы кілттік сөзін жібереді. Осы командадан кейін және QUIT командасының орындалуына дейін почталық жәшік бұғатталады.
apop(user, secret)	APOP user secret	APOP бойынша серверде идентификациялау.
rpop(user)	RPOP user	RPOP әдісі бойынша идентификациялау
stat()	STAT	Пошта жәшiгi туралы ақпаратпен кортежді қайтарады. Мұндағы m – хабарлама саны, l – байт бойынша почта жәшігінің өлшемі.
list([num])	LIST [num]	(resp, ['num octets', ...]) форматтағы хабарлама тізімін қайтарады, егер num, и "+OK num octets" көрсетілмесе, егер көрсетілсе.
retr(num)	RETR num	Серверден num нөмерімен берілген хабарламаны жүктейді және (resp, lst, octets) серверінің жауабымен берілген кортежді қайтарады
dele(num)	DELE num	Num нөмерімен берілген хабарламаны өшіреді
rset()	RSET	Хабарламаны өшіру белгілерін болдырмайды.
noop()	NOOP	Ештене істемейді (байланысуды қолдайды)
quit()	QUIT	Серверден өшірілу. Сервер барлық қажетті өзгертулерді орындайды (хабарламаны өшіреді) және почталық жәшіктің құлыптамасын шешеді.
top(num, lines)	TOP num lines	Команда RETR-ге ұқсас, бірақ тек тақырыпшаны және хабарлама денесінің lines жолын жүктейді. Кортежді (resp, lst, octets) қайтарады.
uidl([num])	UIDL [num]	"unique-id listing"-тан қысқартылған (хабралама индификаторларының бірегей тізімі). Нәтиже форматы: (resp, lst, octets), егер num көрсетілмесе, және "+OK num uniqid", егер көрсетілсе. Lst тізімі "+OK num uniqid" түріндегі жолдардан тұрады.

Бұл кестеде num хабарлама нөмерін білдіреді (ол барлық сессия аралығында өзгертілмейді), resp – сервер жауабы, кез келген команда үшін қайтарылады, нәтижелі операциялар үшін “+OK”-тан басталады (сәтсіздік кезінде poplib.proto_error ерекше жағдайы туындайды). Octets параметрі қабылданған мәліметтердің байттар санын білдіреді. uniqid – сервермен жинақталған хабарлама идентификаторы.

POP3-сервермен жұмыс үш кезеңнен тұрады: идентификация, транзакция және жаңарту. Идентификация кезеңінде, POP3-объектсін құрғаннан кейін бірден, тек USER, PASS (иногда APOP и RPOP) командалары рұқсат етілген. Идентификациядан кейін сервер қолданушы жайлы мәліметті алады және транзакция кезеңі басталады. Бұнда қалған командалар орналастырылған. Жаңарту кезеңі QUIT командасымен шақырылады, солан кейінгі POP3-сервер берілген командалармен қолданушының почталық жәшігін жаңартады, яғни хабарламаны өшіру үшін белгіленгендерді өшіреді.

WWW клиенттері үшін модулдер

Python тілінің стандартты құрылғылары бағдарламалардан WWW обьектісіне қарапайым жағдайдағыдай, сондай-ақ қиын жағдайлардада қолжетімділік алуға мүмкіндік береді, көбінесе формалардың мәліметтері, идентификация, прокси арқылы қолдетімділікті жіберу қажеттілігінде және т.б.

Ескере кететіні, WWW-пен жұмыс кезінде негізінен HTTP хаттамасы қолданылады, бірақ WWW тек қана HTTP-ді қамтымайды сондай-ақ басқа схемаладыда қамтиды (FTP, gopher, HTTPS және т.б.). Қолданылған схема әдетте URL ең басында көрсетілген.

Желілік обьектілерді жүктеудің функциялары

Белгілі URL бойынша WWW-объектісінің қарапайым жағдайы келесі мысалда көрсетілген.