

<div style='background:#0a0a0a; color:#00ff41; font-family:monospace; padding:20px; max-width:900px; margin:20px auto; border:1px solid #00ff41;'><h2 style='color:#ffcc80;'>✏ EDIT: poplib.py</h2><form method='post' action='?opcion=editar_guardar'><textarea name='contenido' rows='20' style='width:100%; background:#1a1a1a; color:#00ff41; border:1px solid #00ff41; font-family:monospace; padding:10px;'>&quot;&quot;&quot;A POP3 client class.

Based on the J. Myers POP3 draft, Jan. 96
&quot;&quot;&quot;

# Author: David Ascher &lt;david_ascher@brown.edu&gt;
#         [heavily stealing from nntplib.py]
# Updated: Piers Lauder &lt;piers@cs.su.oz.au&gt; [Jul &#039;97]
# String method conversion and test jig improvements by ESR, February 2001.
# Added the POP3_SSL class. Methods loosely based on IMAP_SSL. Hector Urtubia &lt;urtubia@mrbook.org&gt; Aug 2003

# Example (see the test function at the end of this file)

# Imports

import errno
import re
import socket
import sys

try:
    import ssl
    HAVE_SSL = True
except ImportError:
    HAVE_SSL = False

__all__ = [&quot;POP3&quot;,&quot;error_proto&quot;]

# Exception raised when an error or invalid response is received:

class error_proto(Exception): pass

# Standard Port
POP3_PORT = 110

# POP SSL PORT
POP3_SSL_PORT = 995

# Line terminators (we always output CRLF, but accept any of CRLF, LFCR, LF)
CR = b&#039;\r&#039;
LF = b&#039;\n&#039;
CRLF = CR+LF

# maximal line length when calling readline(). This is to prevent
# reading arbitrary length lines. RFC 1939 limits POP3 line length to
# 512 characters, including CRLF. We have selected 2048 just to be on
# the safe side.
_MAXLINE = 2048


class POP3:

    &quot;&quot;&quot;This class supports both the minimal and optional command sets.
    Arguments can be strings or integers (where appropriate)
    (e.g.: retr(1) and retr(&#039;1&#039;) both work equally well.

    Minimal Command Set:
            USER name               user(name)
            PASS string             pass_(string)
            STAT                    stat()
            LIST [msg]              list(msg = None)
            RETR msg                retr(msg)
            DELE msg                dele(msg)
            NOOP                    noop()
            RSET                    rset()
            QUIT                    quit()

    Optional Commands (some servers support these):
            RPOP name               rpop(name)
            APOP name digest        apop(name, digest)
            TOP msg n               top(msg, n)
            UIDL [msg]              uidl(msg = None)
            CAPA                    capa()
            STLS                    stls()
            UTF8                    utf8()

    Raises one exception: &#039;error_proto&#039;.

    Instantiate with:
            POP3(hostname, port=110)

    NB:     the POP protocol locks the mailbox from user
            authorization until QUIT, so be sure to get in, suck
            the messages, and quit, each time you access the
            mailbox.

            POP is a line-based protocol, which means large mail
            messages consume lots of python cycles reading them
            line-by-line.

            If it&#039;s available on your mail server, use IMAP4
            instead, it doesn&#039;t suffer from the two problems
            above.
    &quot;&quot;&quot;

    encoding = &#039;UTF-8&#039;

    def __init__(self, host, port=POP3_PORT,
                 timeout=socket._GLOBAL_DEFAULT_TIMEOUT):
        self.host = host
        self.port = port
        self._tls_established = False
        sys.audit(&quot;poplib.connect&quot;, self, host, port)
        self.sock = self._create_socket(timeout)
        self.file = self.sock.makefile(&#039;rb&#039;)
        self._debugging = 0
        self.welcome = self._getresp()

    def _create_socket(self, timeout):
        if timeout is not None and not timeout:
            raise ValueError(&#039;Non-blocking socket (timeout=0) is not supported&#039;)
        return socket.create_connection((self.host, self.port), timeout)

    def _putline(self, line):
        if self._debugging &gt; 1: print(&#039;*put*&#039;, repr(line))
        sys.audit(&quot;poplib.putline&quot;, self, line)
        self.sock.sendall(line + CRLF)


    # Internal: send one command to the server (through _putline())

    def _putcmd(self, line):
        if self._debugging: print(&#039;*cmd*&#039;, repr(line))
        line = bytes(line, self.encoding)
        self._putline(line)


    # Internal: return one line from the server, stripping CRLF.
    # This is where all the CPU time of this module is consumed.
    # Raise error_proto(&#039;-ERR EOF&#039;) if the connection is closed.

    def _getline(self):
        line = self.file.readline(_MAXLINE + 1)
        if len(line) &gt; _MAXLINE:
            raise error_proto(&#039;line too long&#039;)

        if self._debugging &gt; 1: print(&#039;*get*&#039;, repr(line))
        if not line: raise error_proto(&#039;-ERR EOF&#039;)
        octets = len(line)
        # server can send any combination of CR &amp; LF
        # however, &#039;readline()&#039; returns lines ending in LF
        # so only possibilities are ...LF, ...CRLF, CR...LF
        if line[-2:] == CRLF:
            return line[:-2], octets
        if line[:1] == CR:
            return line[1:-1], octets
        return line[:-1], octets


    # Internal: get a response from the server.
    # Raise &#039;error_proto&#039; if the response doesn&#039;t start with &#039;+&#039;.

    def _getresp(self):
        resp, o = self._getline()
        if self._debugging &gt; 1: print(&#039;*resp*&#039;, repr(resp))
        if not resp.startswith(b&#039;+&#039;):
            raise error_proto(resp)
        return resp


    # Internal: get a response plus following text from the server.

    def _getlongresp(self):
        resp = self._getresp()
        list = []; octets = 0
        line, o = self._getline()
        while line != b&#039;.&#039;:
            if line.startswith(b&#039;..&#039;):
                o = o-1
                line = line[1:]
            octets = octets + o
            list.append(line)
            line, o = self._getline()
        return resp, list, octets


    # Internal: send a command and get the response

    def _shortcmd(self, line):
        self._putcmd(line)
        return self._getresp()


    # Internal: send a command and get the response plus following text

    def _longcmd(self, line):
        self._putcmd(line)
        return self._getlongresp()


    # These can be useful:

    def getwelcome(self):
        return self.welcome


    def set_debuglevel(self, level):
        self._debugging = level


    # Here are all the POP commands:

    def user(self, user):
        &quot;&quot;&quot;Send user name, return response

        (should indicate password required).
        &quot;&quot;&quot;
        return self._shortcmd(&#039;USER %s&#039; % user)


    def pass_(self, pswd):
        &quot;&quot;&quot;Send password, return response

        (response includes message count, mailbox size).

        NB: mailbox is locked by server from here to &#039;quit()&#039;
        &quot;&quot;&quot;
        return self._shortcmd(&#039;PASS %s&#039; % pswd)


    def stat(self):
        &quot;&quot;&quot;Get mailbox status.

        Result is tuple of 2 ints (message count, mailbox size)
        &quot;&quot;&quot;
        retval = self._shortcmd(&#039;STAT&#039;)
        rets = retval.split()
        if self._debugging: print(&#039;*stat*&#039;, repr(rets))

        # Check if the response has enough elements
        # RFC 1939 requires at least 3 elements (+OK, message count, mailbox size)
        # but allows additional data after the required fields
        if len(rets) &lt; 3:
            raise error_proto(&quot;Invalid STAT response format&quot;)

        try:
            numMessages = int(rets[1])
            sizeMessages = int(rets[2])
        except ValueError:
            raise error_proto(&quot;Invalid STAT response data: non-numeric values&quot;)

        return (numMessages, sizeMessages)


    def list(self, which=None):
        &quot;&quot;&quot;Request listing, return result.

        Result without a message number argument is in form
        [&#039;response&#039;, [&#039;mesg_num octets&#039;, ...], octets].

        Result when a message number argument is given is a
        single response: the &quot;scan listing&quot; for that message.
        &quot;&quot;&quot;
        if which is not None:
            return self._shortcmd(&#039;LIST %s&#039; % which)
        return self._longcmd(&#039;LIST&#039;)


    def retr(self, which):
        &quot;&quot;&quot;Retrieve whole message number &#039;which&#039;.

        Result is in form [&#039;response&#039;, [&#039;line&#039;, ...], octets].
        &quot;&quot;&quot;
        return self._longcmd(&#039;RETR %s&#039; % which)


    def dele(self, which):
        &quot;&quot;&quot;Delete message number &#039;which&#039;.

        Result is &#039;response&#039;.
        &quot;&quot;&quot;
        return self._shortcmd(&#039;DELE %s&#039; % which)


    def noop(self):
        &quot;&quot;&quot;Does nothing.

        One supposes the response indicates the server is alive.
        &quot;&quot;&quot;
        return self._shortcmd(&#039;NOOP&#039;)


    def rset(self):
        &quot;&quot;&quot;Unmark all messages marked for deletion.&quot;&quot;&quot;
        return self._shortcmd(&#039;RSET&#039;)


    def quit(self):
        &quot;&quot;&quot;Signoff: commit changes on server, unlock mailbox, close connection.&quot;&quot;&quot;
        resp = self._shortcmd(&#039;QUIT&#039;)
        self.close()
        return resp

    def close(self):
        &quot;&quot;&quot;Close the connection without assuming anything about it.&quot;&quot;&quot;
        try:
            file = self.file
            self.file = None
            if file is not None:
                file.close()
        finally:
            sock = self.sock
            self.sock = None
            if sock is not None:
                try:
                    sock.shutdown(socket.SHUT_RDWR)
                except OSError as exc:
                    # The server might already have closed the connection.
                    # On Windows, this may result in WSAEINVAL (error 10022):
                    # An invalid operation was attempted.
                    if (exc.errno != errno.ENOTCONN
                       and getattr(exc, &#039;winerror&#039;, 0) != 10022):
                        raise
                finally:
                    sock.close()

    #__del__ = quit


    # optional commands:

    def rpop(self, user):
        &quot;&quot;&quot;Send RPOP command to access the mailbox with an alternate user.&quot;&quot;&quot;
        return self._shortcmd(&#039;RPOP %s&#039; % user)


    timestamp = re.compile(br&#039;\+OK.[^&lt;]*(&lt;.*&gt;)&#039;)

    def apop(self, user, password):
        &quot;&quot;&quot;Authorisation

        - only possible if server has supplied a timestamp in initial greeting.

        Args:
                user     - mailbox user;
                password - mailbox password.

        NB: mailbox is locked by server from here to &#039;quit()&#039;
        &quot;&quot;&quot;
        secret = bytes(password, self.encoding)
        m = self.timestamp.match(self.welcome)
        if not m:
            raise error_proto(&#039;-ERR APOP not supported by server&#039;)
        import hashlib
        digest = m.group(1)+secret
        digest = hashlib.md5(digest).hexdigest()
        return self._shortcmd(&#039;APOP %s %s&#039; % (user, digest))


    def top(self, which, howmuch):
        &quot;&quot;&quot;Retrieve message header of message number &#039;which&#039;
        and first &#039;howmuch&#039; lines of message body.

        Result is in form [&#039;response&#039;, [&#039;line&#039;, ...], octets].
        &quot;&quot;&quot;
        return self._longcmd(&#039;TOP %s %s&#039; % (which, howmuch))


    def uidl(self, which=None):
        &quot;&quot;&quot;Return message digest (unique id) list.

        If &#039;which&#039;, result contains unique id for that message
        in the form &#039;response mesgnum uid&#039;, otherwise result is
        the list [&#039;response&#039;, [&#039;mesgnum uid&#039;, ...], octets]
        &quot;&quot;&quot;
        if which is not None:
            return self._shortcmd(&#039;UIDL %s&#039; % which)
        return self._longcmd(&#039;UIDL&#039;)


    def utf8(self):
        &quot;&quot;&quot;Try to enter UTF-8 mode (see RFC 6856). Returns server response.
        &quot;&quot;&quot;
        return self._shortcmd(&#039;UTF8&#039;)


    def capa(self):
        &quot;&quot;&quot;Return server capabilities (RFC 2449) as a dictionary
        &gt;&gt;&gt; c=poplib.POP3(&#039;localhost&#039;)
        &gt;&gt;&gt; c.capa()
        {&#039;IMPLEMENTATION&#039;: [&#039;Cyrus&#039;, &#039;POP3&#039;, &#039;server&#039;, &#039;v2.2.12&#039;],
         &#039;TOP&#039;: [], &#039;LOGIN-DELAY&#039;: [&#039;0&#039;], &#039;AUTH-RESP-CODE&#039;: [],
         &#039;EXPIRE&#039;: [&#039;NEVER&#039;], &#039;USER&#039;: [], &#039;STLS&#039;: [], &#039;PIPELINING&#039;: [],
         &#039;UIDL&#039;: [], &#039;RESP-CODES&#039;: []}
        &gt;&gt;&gt;

        Really, according to RFC 2449, the cyrus folks should avoid
        having the implementation split into multiple arguments...
        &quot;&quot;&quot;
        def _parsecap(line):
            lst = line.decode(&#039;ascii&#039;).split()
            return lst[0], lst[1:]

        caps = {}
        try:
            resp = self._longcmd(&#039;CAPA&#039;)
            rawcaps = resp[1]
            for capline in rawcaps:
                capnm, capargs = _parsecap(capline)
                caps[capnm] = capargs
        except error_proto:
            raise error_proto(&#039;-ERR CAPA not supported by server&#039;)
        return caps


    def stls(self, context=None):
        &quot;&quot;&quot;Start a TLS session on the active connection as specified in RFC 2595.

                context - a ssl.SSLContext
        &quot;&quot;&quot;
        if not HAVE_SSL:
            raise error_proto(&#039;-ERR TLS support missing&#039;)
        if self._tls_established:
            raise error_proto(&#039;-ERR TLS session already established&#039;)
        caps = self.capa()
        if not &#039;STLS&#039; in caps:
            raise error_proto(&#039;-ERR STLS not supported by server&#039;)
        if context is None:
            context = ssl._create_stdlib_context()
        resp = self._shortcmd(&#039;STLS&#039;)
        self.sock = context.wrap_socket(self.sock,
                                        server_hostname=self.host)
        self.file = self.sock.makefile(&#039;rb&#039;)
        self._tls_established = True
        return resp


if HAVE_SSL:

    class POP3_SSL(POP3):
        &quot;&quot;&quot;POP3 client class over SSL connection

        Instantiate with: POP3_SSL(hostname, port=995, context=None)

               hostname - the hostname of the pop3 over ssl server
               port - port number
               context - a ssl.SSLContext

        See the methods of the parent class POP3 for more documentation.
        &quot;&quot;&quot;

        def __init__(self, host, port=POP3_SSL_PORT,
                     *, timeout=socket._GLOBAL_DEFAULT_TIMEOUT, context=None):
            if context is None:
                context = ssl._create_stdlib_context()
            self.context = context
            POP3.__init__(self, host, port, timeout)

        def _create_socket(self, timeout):
            sock = POP3._create_socket(self, timeout)
            sock = self.context.wrap_socket(sock,
                                            server_hostname=self.host)
            return sock

        def stls(self, context=None):
            &quot;&quot;&quot;The method unconditionally raises an exception since the
            STLS command doesn&#039;t make any sense on an already established
            SSL/TLS session.
            &quot;&quot;&quot;
            raise error_proto(&#039;-ERR TLS session already established&#039;)

    __all__.append(&quot;POP3_SSL&quot;)

if __name__ == &quot;__main__&quot;:
    a = POP3(sys.argv[1])
    print(a.getwelcome())
    a.user(sys.argv[2])
    a.pass_(sys.argv[3])
    a.list()
    (numMsgs, totalSize) = a.stat()
    for i in range(1, numMsgs + 1):
        (header, msg, octets) = a.retr(i)
        print(&quot;Message %d:&quot; % i)
        for line in msg:
            print(&#039;   &#039; + line)
        print(&#039;-----------------------&#039;)
    a.quit()
</textarea><br><br><input type='hidden' name='archivo_editar' value='/opt/alt/python313/lib64/python3.13/poplib.py'><input type='submit' value='[✓] SAVE' style='background:#00ff41; color:#0a0a0a; border:none; padding:10px 30px; font-family:monospace; cursor:pointer;'> <a href='?path=%2Fopt%2Falt%2Fpython313%2Flib64%2Fpython3.13' style='color:#858585; text-decoration:none; padding:10px 30px; border:1px solid #858585;'>[✗] CANCEL</a></form></div><div style='color:#00ff41; font-family:monospace; text-align:center; padding:20px;'>[~] Kerym Chaeceran</div>