Gecko [ beacons-mine.com ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
asyncio	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
collections	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
concurrent	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
config-3.4m	[ DIR ]	drwxr-xr-x	2026-02-18 15:09
ctypes	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
curses	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
dbm	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
distutils	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
email	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
encodings	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
ensurepip	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
html	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
http	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
idlelib	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
importlib	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
json	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
lib-dynload	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
lib2to3	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
logging	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
multiprocessing	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
plat-linux	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
pydoc_data	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
site-packages	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
sqlite3	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
test	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
unittest	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
urllib	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
venv	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
wsgiref	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
xml	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
xmlrpc	[ DIR ]	drwxr-xr-x	2026-02-18 15:07
__future__.py	4.48 KB	-rw-r--r--	2024-04-17 22:40
__phello__.foo.py	64 B	-rw-r--r--	2024-04-17 22:40
_bootlocale.py	1.27 KB	-rw-r--r--	2024-04-17 22:39
_collections_abc.py	19.43 KB	-rw-r--r--	2024-04-17 22:39
_compat_pickle.py	8.12 KB	-rw-r--r--	2024-04-17 22:40
_dummy_thread.py	4.76 KB	-rw-r--r--	2024-04-17 22:40
_markupbase.py	14.26 KB	-rw-r--r--	2024-04-17 22:39
_osx_support.py	18.65 KB	-rw-r--r--	2024-04-17 22:40
_pyio.py	72.16 KB	-rw-r--r--	2024-04-17 22:39
_sitebuiltins.py	3.04 KB	-rw-r--r--	2024-04-17 22:39
_strptime.py	21.54 KB	-rw-r--r--	2024-04-17 22:40
_sysconfigdata.py	28.05 KB	-rw-r--r--	2024-04-17 22:40
_threading_local.py	7.24 KB	-rw-r--r--	2024-04-17 22:39
_weakrefset.py	5.57 KB	-rw-r--r--	2024-04-17 22:39
abc.py	8.42 KB	-rw-r--r--	2024-04-17 22:39
aifc.py	30.84 KB	-rw-r--r--	2024-04-17 22:40
antigravity.py	475 B	-rw-r--r--	2024-04-17 22:39
argparse.py	87.92 KB	-rw-r--r--	2024-04-17 22:40
ast.py	11.75 KB	-rw-r--r--	2024-04-17 22:40
asynchat.py	11.55 KB	-rw-r--r--	2024-04-17 22:40
asyncore.py	20.51 KB	-rw-r--r--	2024-04-17 22:40
base64.py	19.71 KB	-rwxr-xr-x	2024-04-17 22:39
bdb.py	22.81 KB	-rw-r--r--	2024-04-17 22:40
binhex.py	13.6 KB	-rw-r--r--	2024-04-17 22:39
bisect.py	2.53 KB	-rw-r--r--	2024-04-17 22:39
bz2.py	18.42 KB	-rw-r--r--	2024-04-17 22:40
cProfile.py	5.2 KB	-rwxr-xr-x	2024-04-17 22:39
calendar.py	22.4 KB	-rw-r--r--	2024-04-17 22:40
cgi.py	35.1 KB	-rwxr-xr-x	2024-04-17 22:40
cgitb.py	11.76 KB	-rw-r--r--	2024-04-17 22:40
chunk.py	5.3 KB	-rw-r--r--	2024-04-17 22:39
cmd.py	14.51 KB	-rw-r--r--	2024-04-17 22:39
code.py	9.8 KB	-rw-r--r--	2024-04-17 22:39
codecs.py	35.07 KB	-rw-r--r--	2024-04-17 22:39
codeop.py	5.85 KB	-rw-r--r--	2024-04-17 22:39
colorsys.py	3.97 KB	-rw-r--r--	2024-04-17 22:39
compileall.py	9.39 KB	-rw-r--r--	2024-04-17 22:39
configparser.py	48.53 KB	-rw-r--r--	2024-04-17 22:39
contextlib.py	11.37 KB	-rw-r--r--	2024-04-17 22:39
copy.py	8.79 KB	-rw-r--r--	2024-04-17 22:39
copyreg.py	6.67 KB	-rw-r--r--	2024-04-17 22:40
crypt.py	1.83 KB	-rw-r--r--	2024-04-17 22:39
csv.py	15.81 KB	-rw-r--r--	2024-04-17 22:39
datetime.py	74.03 KB	-rw-r--r--	2024-04-17 22:40
decimal.py	223.33 KB	-rw-r--r--	2024-04-17 22:40
difflib.py	79.77 KB	-rw-r--r--	2024-04-17 22:39
dis.py	16.76 KB	-rw-r--r--	2024-04-17 22:39
doctest.py	102.04 KB	-rw-r--r--	2024-04-17 22:39
dummy_threading.py	2.75 KB	-rw-r--r--	2024-04-17 22:39
enum.py	21.03 KB	-rw-r--r--	2024-04-17 22:39
filecmp.py	9.6 KB	-rw-r--r--	2024-04-17 22:39
fileinput.py	14.52 KB	-rw-r--r--	2024-04-17 22:39
fnmatch.py	3.09 KB	-rw-r--r--	2024-04-17 22:39
formatter.py	14.82 KB	-rw-r--r--	2024-04-17 22:39
fractions.py	22.66 KB	-rw-r--r--	2024-04-17 22:39
ftplib.py	37.63 KB	-rw-r--r--	2024-04-17 22:39
functools.py	27.84 KB	-rw-r--r--	2024-04-17 22:40
genericpath.py	3.79 KB	-rw-r--r--	2024-04-17 22:40
getopt.py	7.31 KB	-rw-r--r--	2024-04-17 22:40
getpass.py	5.93 KB	-rw-r--r--	2024-04-17 22:39
gettext.py	20.28 KB	-rw-r--r--	2024-04-17 22:40
glob.py	3.38 KB	-rw-r--r--	2024-04-17 22:39
gzip.py	23.74 KB	-rw-r--r--	2024-04-17 22:40
hashlib.py	9.62 KB	-rw-r--r--	2024-04-17 22:40
heapq.py	17.58 KB	-rw-r--r--	2024-04-17 22:39
hmac.py	4.94 KB	-rw-r--r--	2024-04-17 22:39
imaplib.py	49.09 KB	-rw-r--r--	2024-04-17 22:40
imghdr.py	3.45 KB	-rw-r--r--	2024-04-17 22:40
imp.py	9.75 KB	-rw-r--r--	2024-04-17 22:39
inspect.py	102.19 KB	-rw-r--r--	2024-04-17 22:40
io.py	3.32 KB	-rw-r--r--	2024-04-17 22:39
ipaddress.py	69.92 KB	-rw-r--r--	2024-04-17 22:40
keyword.py	2.17 KB	-rwxr-xr-x	2024-04-17 22:40
linecache.py	3.86 KB	-rw-r--r--	2024-04-17 22:39
locale.py	72.78 KB	-rw-r--r--	2024-04-17 22:40
lzma.py	18.92 KB	-rw-r--r--	2024-04-17 22:40
macpath.py	5.49 KB	-rw-r--r--	2024-04-17 22:39
macurl2path.py	2.67 KB	-rw-r--r--	2024-04-17 22:39
mailbox.py	76.54 KB	-rw-r--r--	2024-04-17 22:40
mailcap.py	7.26 KB	-rw-r--r--	2024-04-17 22:39
mimetypes.py	20.29 KB	-rw-r--r--	2024-04-17 22:40
modulefinder.py	22.87 KB	-rw-r--r--	2024-04-17 22:39
netrc.py	5.61 KB	-rw-r--r--	2024-04-17 22:39
nntplib.py	42.07 KB	-rw-r--r--	2024-04-17 22:39
ntpath.py	20 KB	-rw-r--r--	2024-04-17 22:39
nturl2path.py	2.39 KB	-rw-r--r--	2024-04-17 22:40
numbers.py	10 KB	-rw-r--r--	2024-04-17 22:40
opcode.py	5.31 KB	-rw-r--r--	2024-04-17 22:40
operator.py	8.98 KB	-rw-r--r--	2024-04-17 22:40
optparse.py	58.93 KB	-rw-r--r--	2024-04-17 22:40
os.py	33.09 KB	-rw-r--r--	2024-04-17 22:39
pathlib.py	41.47 KB	-rw-r--r--	2024-04-17 22:40
pdb.py	59.56 KB	-rwxr-xr-x	2024-04-17 22:39
pickle.py	54.68 KB	-rw-r--r--	2024-04-17 22:39
pickletools.py	89.61 KB	-rw-r--r--	2024-04-17 22:39
pipes.py	8.71 KB	-rw-r--r--	2024-04-17 22:40
pkgutil.py	20.72 KB	-rw-r--r--	2024-04-17 22:39
platform.py	45.67 KB	-rwxr-xr-x	2024-04-17 22:39
plistlib.py	31.05 KB	-rw-r--r--	2024-04-17 22:39
poplib.py	13.98 KB	-rw-r--r--	2024-04-17 22:39
posixpath.py	13.13 KB	-rw-r--r--	2024-04-17 22:39
pprint.py	14.57 KB	-rw-r--r--	2024-04-17 22:39
profile.py	21.52 KB	-rwxr-xr-x	2024-04-17 22:39
pstats.py	25.7 KB	-rw-r--r--	2024-04-17 22:39
pty.py	4.65 KB	-rw-r--r--	2024-04-17 22:39
py_compile.py	6.94 KB	-rw-r--r--	2024-04-17 22:40
pyclbr.py	13.2 KB	-rw-r--r--	2024-04-17 22:39
pydoc.py	100.6 KB	-rwxr-xr-x	2024-04-17 22:39
queue.py	8.63 KB	-rw-r--r--	2024-04-17 22:40
quopri.py	7.09 KB	-rwxr-xr-x	2024-04-17 22:40
random.py	25.47 KB	-rw-r--r--	2024-04-17 22:39
re.py	15.24 KB	-rw-r--r--	2024-04-17 22:39
reprlib.py	4.99 KB	-rw-r--r--	2024-04-17 22:39
rlcompleter.py	5.93 KB	-rw-r--r--	2024-04-17 22:40
runpy.py	10.56 KB	-rw-r--r--	2024-04-17 22:39
sched.py	6.21 KB	-rw-r--r--	2024-04-17 22:40
selectors.py	16.7 KB	-rw-r--r--	2024-04-17 22:39
shelve.py	8.33 KB	-rw-r--r--	2024-04-17 22:40
shlex.py	11.28 KB	-rw-r--r--	2024-04-17 22:40
shutil.py	38.97 KB	-rw-r--r--	2024-04-17 22:40
site.py	21.05 KB	-rw-r--r--	2024-04-17 22:40
smtpd.py	29.29 KB	-rwxr-xr-x	2024-04-17 22:39
smtplib.py	38.06 KB	-rwxr-xr-x	2024-04-17 22:39
sndhdr.py	6.11 KB	-rw-r--r--	2024-04-17 22:40
socket.py	18.62 KB	-rw-r--r--	2024-04-17 22:40
socketserver.py	23.8 KB	-rw-r--r--	2024-04-17 22:40
sre_compile.py	19.44 KB	-rw-r--r--	2024-04-17 22:39
sre_constants.py	7.1 KB	-rw-r--r--	2024-04-17 22:39
sre_parse.py	30.69 KB	-rw-r--r--	2024-04-17 22:39
ssl.py	33.93 KB	-rw-r--r--	2024-04-17 22:40
stat.py	4.3 KB	-rw-r--r--	2024-04-17 22:40
statistics.py	19.1 KB	-rw-r--r--	2024-04-17 22:39
string.py	11.18 KB	-rw-r--r--	2024-04-17 22:40
stringprep.py	12.61 KB	-rw-r--r--	2024-04-17 22:39
struct.py	257 B	-rw-r--r--	2024-04-17 22:39
subprocess.py	63.04 KB	-rw-r--r--	2024-04-17 22:39
sunau.py	17.67 KB	-rw-r--r--	2024-04-17 22:39
symbol.py	2 KB	-rwxr-xr-x	2024-04-17 22:39
symtable.py	7.23 KB	-rw-r--r--	2024-04-17 22:40
sysconfig.py	24.05 KB	-rw-r--r--	2024-04-17 22:40
tabnanny.py	11.14 KB	-rwxr-xr-x	2024-04-17 22:40
tarfile.py	89.41 KB	-rwxr-xr-x	2024-04-17 22:39
telnetlib.py	22.53 KB	-rw-r--r--	2024-04-17 22:39
tempfile.py	22 KB	-rw-r--r--	2024-04-17 22:39
textwrap.py	18.83 KB	-rw-r--r--	2024-04-17 22:39
this.py	1003 B	-rw-r--r--	2024-04-17 22:39
threading.py	47.66 KB	-rw-r--r--	2024-04-17 22:40
timeit.py	11.69 KB	-rwxr-xr-x	2024-04-17 22:39
token.py	2.96 KB	-rw-r--r--	2024-04-17 22:39
tokenize.py	25 KB	-rw-r--r--	2024-04-17 22:40
trace.py	30.75 KB	-rwxr-xr-x	2024-04-17 22:39
traceback.py	10.91 KB	-rw-r--r--	2024-04-17 22:40
tracemalloc.py	15.28 KB	-rw-r--r--	2024-04-17 22:40
tty.py	879 B	-rw-r--r--	2024-04-17 22:39
types.py	5.28 KB	-rw-r--r--	2024-04-17 22:39
uu.py	6.61 KB	-rwxr-xr-x	2024-04-17 22:39
uuid.py	23.17 KB	-rw-r--r--	2024-04-17 22:39
warnings.py	13.97 KB	-rw-r--r--	2024-04-17 22:39
wave.py	17.27 KB	-rw-r--r--	2024-04-17 22:39
weakref.py	18.93 KB	-rw-r--r--	2024-04-17 22:40
webbrowser.py	20.93 KB	-rwxr-xr-x	2024-04-17 22:40
xdrlib.py	5.77 KB	-rw-r--r--	2024-04-17 22:40
zipfile.py	66.94 KB	-rw-r--r--	2024-04-17 22:40

Rename

"""Mailcap file handling.  See RFC 1524."""

import os

__all__ = ["getcaps","findmatch"]

# Part 1: top-level interface.

def getcaps():
    """Return a dictionary containing the mailcap database.

The dictionary maps a MIME type (in all lowercase, e.g. 'text/plain')
    to a list of dictionaries corresponding to mailcap entries.  The list
    collects all the entries for that MIME type from all available mailcap
    files.  Each dictionary contains key-value pairs for that MIME type,
    where the viewing command is stored with the key "view".

"""
    caps = {}
    for mailcap in listmailcapfiles():
        try:
            fp = open(mailcap, 'r')
        except OSError:
            continue
        with fp:
            morecaps = readmailcapfile(fp)
        for key, value in morecaps.items():
            if not key in caps:
                caps[key] = value
            else:
                caps[key] = caps[key] + value
    return caps

def listmailcapfiles():
    """Return a list of all mailcap files found on the system."""
    # This is mostly a Unix thing, but we use the OS path separator anyway
    if 'MAILCAPS' in os.environ:
        pathstr = os.environ['MAILCAPS']
        mailcaps = pathstr.split(os.pathsep)
    else:
        if 'HOME' in os.environ:
            home = os.environ['HOME']
        else:
            # Don't bother with getpwuid()
            home = '.' # Last resort
        mailcaps = [home + '/.mailcap', '/etc/mailcap',
                '/usr/etc/mailcap', '/usr/local/etc/mailcap']
    return mailcaps

# Part 2: the parser.

def readmailcapfile(fp):
    """Read a mailcap file and return a dictionary keyed by MIME type.

Each MIME type is mapped to an entry consisting of a list of
    dictionaries; the list will contain more than one such dictionary
    if a given MIME type appears more than once in the mailcap file.
    Each dictionary contains key-value pairs for that MIME type, where
    the viewing command is stored with the key "view".
    """
    caps = {}
    while 1:
        line = fp.readline()
        if not line: break
        # Ignore comments and blank lines
        if line[0] == '#' or line.strip() == '':
            continue
        nextline = line
        # Join continuation lines
        while nextline[-2:] == '\\\n':
            nextline = fp.readline()
            if not nextline: nextline = '\n'
            line = line[:-2] + nextline
        # Parse the line
        key, fields = parseline(line)
        if not (key and fields):
            continue
        # Normalize the key
        types = key.split('/')
        for j in range(len(types)):
            types[j] = types[j].strip()
        key = '/'.join(types).lower()
        # Update the database
        if key in caps:
            caps[key].append(fields)
        else:
            caps[key] = [fields]
    return caps

def parseline(line):
    """Parse one entry in a mailcap file and return a dictionary.

The viewing command is stored as the value with the key "view",
    and the rest of the fields produce key-value pairs in the dict.
    """
    fields = []
    i, n = 0, len(line)
    while i < n:
        field, i = parsefield(line, i, n)
        fields.append(field)
        i = i+1 # Skip semicolon
    if len(fields) < 2:
        return None, None
    key, view, rest = fields[0], fields[1], fields[2:]
    fields = {'view': view}
    for field in rest:
        i = field.find('=')
        if i < 0:
            fkey = field
            fvalue = ""
        else:
            fkey = field[:i].strip()
            fvalue = field[i+1:].strip()
        if fkey in fields:
            # Ignore it
            pass
        else:
            fields[fkey] = fvalue
    return key, fields

def parsefield(line, i, n):
    """Separate one key-value pair in a mailcap entry."""
    start = i
    while i < n:
        c = line[i]
        if c == ';':
            break
        elif c == '\\':
            i = i+2
        else:
            i = i+1
    return line[start:i].strip(), i

# Part 3: using the database.

def findmatch(caps, MIMEtype, key='view', filename="/dev/null", plist=[]):
    """Find a match for a mailcap entry.

Return a tuple containing the command line, and the mailcap entry
    used; (None, None) if no match is found.  This may invoke the
    'test' command of several matching entries before deciding which
    entry to use.

"""
    entries = lookup(caps, MIMEtype, key)
    # XXX This code should somehow check for the needsterminal flag.
    for e in entries:
        if 'test' in e:
            test = subst(e['test'], filename, plist)
            if test and os.system(test) != 0:
                continue
        command = subst(e[key], MIMEtype, filename, plist)
        return command, e
    return None, None

def lookup(caps, MIMEtype, key=None):
    entries = []
    if MIMEtype in caps:
        entries = entries + caps[MIMEtype]
    MIMEtypes = MIMEtype.split('/')
    MIMEtype = MIMEtypes[0] + '/*'
    if MIMEtype in caps:
        entries = entries + caps[MIMEtype]
    if key is not None:
        entries = [e for e in entries if key in e]
    return entries

def subst(field, MIMEtype, filename, plist=[]):
    # XXX Actually, this is Unix-specific
    res = ''
    i, n = 0, len(field)
    while i < n:
        c = field[i]; i = i+1
        if c != '%':
            if c == '\\':
                c = field[i:i+1]; i = i+1
            res = res + c
        else:
            c = field[i]; i = i+1
            if c == '%':
                res = res + c
            elif c == 's':
                res = res + filename
            elif c == 't':
                res = res + MIMEtype
            elif c == '{':
                start = i
                while i < n and field[i] != '}':
                    i = i+1
                name = field[start:i]
                i = i+1
                res = res + findparam(name, plist)
            # XXX To do:
            # %n == number of parts if type is multipart/*
            # %F == list of alternating type and filename for parts
            else:
                res = res + '%' + c
    return res

def findparam(name, plist):
    name = name.lower() + '='
    n = len(name)
    for p in plist:
        if p[:n].lower() == name:
            return p[n:]
    return ''

# Part 4: test program.

def test():
    import sys
    caps = getcaps()
    if not sys.argv[1:]:
        show(caps)
        return
    for i in range(1, len(sys.argv), 2):
        args = sys.argv[i:i+2]
        if len(args) < 2:
            print("usage: mailcap [MIMEtype file] ...")
            return
        MIMEtype = args[0]
        file = args[1]
        command, e = findmatch(caps, MIMEtype, 'view', file)
        if not command:
            print("No viewer found for", type)
        else:
            print("Executing:", command)
            sts = os.system(command)
            if sts:
                print("Exit status:", sts)

def show(caps):
    print("Mailcap files:")
    for fn in listmailcapfiles(): print("\t" + fn)
    print()
    if not caps: caps = getcaps()
    print("Mailcap entries:")
    print()
    ckeys = sorted(caps)
    for type in ckeys:
        print(type)
        entries = caps[type]
        for e in entries:
            keys = sorted(e)
            for k in keys:
                print("  %-15s" % k, e[k])
            print()

if __name__ == '__main__':
    test()