OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 EXTERNALLY-MANAGED	645 bytes	02/04/2025 02:48:35 PM	rw-r--r--
📄 LICENSE.txt	13.61 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 __future__.py	5.1 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 __hello__.py	227 bytes	02/04/2025 02:48:35 PM	rw-r--r--
📁 __phello__	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📁 __pycache__	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 _aix_support.py	3.93 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _collections_abc.py	31.33 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _compat_pickle.py	8.56 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _compression.py	5.55 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _distutils_system_mod.py	5.58 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _markupbase.py	14.31 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _osx_support.py	21.51 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _py_abc.py	6.04 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _pydatetime.py	89.94 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _pydecimal.py	223.85 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _pyio.py	91.4 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _pylong.py	8.83 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _sitebuiltins.py	3.05 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _strptime.py	24.04 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _sysconfigdata__linux_x86_64-linux-gnu.py	48.34 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _sysconfigdata__x86_64-linux-gnu.py	48.34 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _threading_local.py	7.05 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 _weakrefset.py	5.75 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 abc.py	6.38 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 aifc.py	33.41 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 antigravity.py	500 bytes	02/04/2025 02:48:35 PM	rw-r--r--
📄 argparse.py	99.37 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 ast.py	62.75 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 asyncio	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 base64.py	20.12 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 bdb.py	31.7 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 bisect.py	3.34 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 bz2.py	11.57 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 cProfile.py	6.4 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 calendar.py	24.82 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 cgi.py	33.61 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 cgitb.py	12.13 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 chunk.py	5.37 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 cmd.py	14.52 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 code.py	10.44 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 codecs.py	36.01 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 codeop.py	5.77 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 collections	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 colorsys.py	3.97 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 compileall.py	20.12 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 concurrent	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 configparser.py	52.53 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 contextlib.py	26.99 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 contextvars.py	129 bytes	02/04/2025 02:48:35 PM	rw-r--r--
📄 copy.py	8.21 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 copyreg.py	7.44 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 crypt.py	3.82 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 csv.py	16 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 ctypes	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📁 curses	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 dataclasses.py	60.31 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 datetime.py	268 bytes	02/04/2025 02:48:35 PM	rw-r--r--
📁 dbm	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 decimal.py	320 bytes	02/04/2025 02:48:35 PM	rw-r--r--
📄 difflib.py	81.36 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 dis.py	29.5 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 doctest.py	103.98 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 email	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📁 encodings	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 enum.py	79.72 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 filecmp.py	9.95 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 fileinput.py	15.35 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 fnmatch.py	5.86 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 fractions.py	37.17 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 ftplib.py	33.92 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 functools.py	37.23 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 genericpath.py	5.18 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 getopt.py	7.31 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 getpass.py	5.85 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 gettext.py	21.24 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 glob.py	8.53 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 graphlib.py	9.43 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 gzip.py	24.28 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 hashlib.py	9.13 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 heapq.py	22.48 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 hmac.py	7.54 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 html	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📁 http	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 imaplib.py	52.43 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 imghdr.py	4.29 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 importlib	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 inspect.py	122.48 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 io.py	3.5 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 ipaddress.py	76.46 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 json	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 keyword.py	1.05 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 lib-dynload	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 linecache.py	5.52 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 locale.py	76.72 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 logging	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 lzma.py	12.97 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 mailbox.py	77.06 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 mailcap.py	9.11 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 mimetypes.py	22.35 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 modulefinder.py	23.14 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 multiprocessing	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 netrc.py	6.76 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 nntplib.py	40.12 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 ntpath.py	30.75 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 nturl2path.py	2.82 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 numbers.py	11.2 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 opcode.py	12.87 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 operator.py	10.71 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 optparse.py	58.95 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 os.py	38.85 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 pathlib.py	49.95 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 pdb.py	67.83 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 pickle.py	63.38 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 pickletools.py	91.66 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 pipes.py	8.77 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 pkgutil.py	17.85 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 platform.py	42.32 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 plistlib.py	27.68 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 poplib.py	13.83 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 posixpath.py	17.15 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 pprint.py	23.59 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 profile.py	22.55 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 pstats.py	28.6 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 pty.py	5.99 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 py_compile.py	7.69 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 pyclbr.py	11.13 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 pydoc.py	110.44 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📁 pydoc_data	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 queue.py	11.23 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 quopri.py	7.01 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 random.py	33.87 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 re	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 reprlib.py	6.42 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 rlcompleter.py	7.64 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 runpy.py	12.6 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 sched.py	6.2 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 secrets.py	1.94 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 selectors.py	19.21 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 shelve.py	8.36 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 shlex.py	13.04 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 shutil.py	56.76 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 signal.py	2.44 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 site.py	23.34 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 sitecustomize.py	0 bytes	01/01/1970 12:00:00 AM	---------
📄 smtplib.py	42.51 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 sndhdr.py	7.27 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 socket.py	36.53 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 socketserver.py	27.2 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 sqlite3	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 sre_compile.py	231 bytes	02/04/2025 02:48:35 PM	rw-r--r--
📄 sre_constants.py	232 bytes	02/04/2025 02:48:35 PM	rw-r--r--
📄 sre_parse.py	229 bytes	02/04/2025 02:48:35 PM	rw-r--r--
📄 ssl.py	49.63 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 stat.py	5.36 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 statistics.py	49.05 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 string.py	11.51 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 stringprep.py	12.61 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 struct.py	257 bytes	02/04/2025 02:48:35 PM	rw-r--r--
📄 subprocess.py	86.65 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 sunau.py	18.04 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 symtable.py	10.5 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 sysconfig.py	32 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 tabnanny.py	11.26 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 tarfile.py	105.93 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 telnetlib.py	22.75 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 tempfile.py	36.46 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 test	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 textwrap.py	19.26 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 this.py	1003 bytes	02/04/2025 02:48:35 PM	rw-r--r--
📄 threading.py	58.71 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 timeit.py	13.15 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 token.py	2.42 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 tokenize.py	20.72 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 tomllib	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 trace.py	28.5 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 traceback.py	45.24 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 tracemalloc.py	17.62 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 tty.py	1.99 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 turtle.py	142.93 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 types.py	10.74 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 typing.py	114.68 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 unittest	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📁 urllib	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 uu.py	7.19 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📄 uuid.py	28.96 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 venv	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 warnings.py	21.25 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 wave.py	22.24 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 weakref.py	21.01 KB	02/04/2025 02:48:35 PM	rw-r--r--
📄 webbrowser.py	23.07 KB	02/04/2025 02:48:35 PM	rwxr-xr-x
📁 wsgiref	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 xdrlib.py	5.8 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 xml	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📁 xmlrpc	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 zipapp.py	7.37 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 zipfile	-	03/18/2025 08:12:15 AM	rwxr-xr-x
📄 zipimport.py	27.47 KB	02/04/2025 02:48:35 PM	rw-r--r--
📁 zoneinfo	-	03/18/2025 08:12:15 AM	rwxr-xr-x

Editing: poplib.py

"""A POP3 client class.

Based on the J. Myers POP3 draft, Jan. 96
"""

# Author: David Ascher <david_ascher@brown.edu>
#         [heavily stealing from nntplib.py]
# Updated: Piers Lauder <piers@cs.su.oz.au> [Jul '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 <urtubia@mrbook.org> 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__ = ["POP3","error_proto"]

# 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'\r'
LF = b'\n'
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:

"""This class supports both the minimal and optional command sets.
    Arguments can be strings or integers (where appropriate)
    (e.g.: retr(1) and retr('1') 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: 'error_proto'.

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's available on your mail server, use IMAP4
            instead, it doesn't suffer from the two problems
            above.
    """

encoding = 'UTF-8'

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

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

def _putline(self, line):
        if self._debugging > 1: print('*put*', repr(line))
        sys.audit("poplib.putline", self, line)
        self.sock.sendall(line + CRLF)

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

def _putcmd(self, line):
        if self._debugging: print('*cmd*', 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('-ERR EOF') if the connection is closed.

def _getline(self):
        line = self.file.readline(_MAXLINE + 1)
        if len(line) > _MAXLINE:
            raise error_proto('line too long')

if self._debugging > 1: print('*get*', repr(line))
        if not line: raise error_proto('-ERR EOF')
        octets = len(line)
        # server can send any combination of CR & LF
        # however, 'readline()' 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 'error_proto' if the response doesn't start with '+'.

def _getresp(self):
        resp, o = self._getline()
        if self._debugging > 1: print('*resp*', repr(resp))
        if not resp.startswith(b'+'):
            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'.':
            if line.startswith(b'..'):
                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):
        """Send user name, return response

(should indicate password required).
        """
        return self._shortcmd('USER %s' % user)

def pass_(self, pswd):
        """Send password, return response

(response includes message count, mailbox size).

NB: mailbox is locked by server from here to 'quit()'
        """
        return self._shortcmd('PASS %s' % pswd)

def stat(self):
        """Get mailbox status.

Result is tuple of 2 ints (message count, mailbox size)
        """
        retval = self._shortcmd('STAT')
        rets = retval.split()
        if self._debugging: print('*stat*', repr(rets))
        numMessages = int(rets[1])
        sizeMessages = int(rets[2])
        return (numMessages, sizeMessages)

def list(self, which=None):
        """Request listing, return result.

Result without a message number argument is in form
        ['response', ['mesg_num octets', ...], octets].

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

def retr(self, which):
        """Retrieve whole message number 'which'.

Result is in form ['response', ['line', ...], octets].
        """
        return self._longcmd('RETR %s' % which)

def dele(self, which):
        """Delete message number 'which'.

Result is 'response'.
        """
        return self._shortcmd('DELE %s' % which)

def noop(self):
        """Does nothing.

One supposes the response indicates the server is alive.
        """
        return self._shortcmd('NOOP')

def rset(self):
        """Unmark all messages marked for deletion."""
        return self._shortcmd('RSET')

def quit(self):
        """Signoff: commit changes on server, unlock mailbox, close connection."""
        resp = self._shortcmd('QUIT')
        self.close()
        return resp

def close(self):
        """Close the connection without assuming anything about it."""
        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, 'winerror', 0) != 10022):
                        raise
                finally:
                    sock.close()

#__del__ = quit

# optional commands:

def rpop(self, user):
        """Not sure what this does."""
        return self._shortcmd('RPOP %s' % user)

timestamp = re.compile(br'\+OK.[^<]*(<.*>)')

def apop(self, user, password):
        """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 'quit()'
        """
        secret = bytes(password, self.encoding)
        m = self.timestamp.match(self.welcome)
        if not m:
            raise error_proto('-ERR APOP not supported by server')
        import hashlib
        digest = m.group(1)+secret
        digest = hashlib.md5(digest).hexdigest()
        return self._shortcmd('APOP %s %s' % (user, digest))

def top(self, which, howmuch):
        """Retrieve message header of message number 'which'
        and first 'howmuch' lines of message body.

Result is in form ['response', ['line', ...], octets].
        """
        return self._longcmd('TOP %s %s' % (which, howmuch))

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

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

def utf8(self):
        """Try to enter UTF-8 mode (see RFC 6856). Returns server response.
        """
        return self._shortcmd('UTF8')

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

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

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

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

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

if HAVE_SSL:

class POP3_SSL(POP3):
        """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.
        """

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):
            """The method unconditionally raises an exception since the
            STLS command doesn't make any sense on an already established
            SSL/TLS session.
            """
            raise error_proto('-ERR TLS session already established')

__all__.append("POP3_SSL")

if __name__ == "__main__":
    import sys
    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("Message %d:" % i)
        for line in msg:
            print('   ' + line)
        print('-----------------------')
    a.quit()