root/python/utility/mutt_save_attachment.py

#!/usr/bin/env python
"""
Attachment-saver for mutt

Saves attached files in world-readable form and displays a URL for clicking.
Once you've used your web browser to download or view the file, you can delete
it or make it private.

My .mailcap file looks something like this:

    text/html; links -dump %s; copiousoutput;
    application/*; mutt_save_attachment.py %s
    image/*; mutt_save_attachment.py %s

This script technically creates a race condition -- if somebody knows
the MUTT_TEMP_WWW_URL where files are being saved, and knows filenames
to probe for, and probes between the time you invoke this script and
the time you choose 'delete' or 'private', they can see files. If that
is a concern, add webserver-based auth to MUTT_TEMP_WWW_DIR. (Via
`htpasswd` when using Apache, for example.)
"""

__author__ = "Paul Bissex <pb@e-scribe.com>"
__license__ = "MIT"

import sys
import shutil
import os
from cgi import escape

def rename(filepath):
    """Prompt user to rename the file"""
    newpath = raw_input("New path: ")
    if newpath:
        os.rename(filepath, newpath)
    else:
        print "Rename cancelled"

def delete(filepath):
    """Remove the file"""
    os.remove(filepath)

def private(filepath):
    """Change file's permissions to owner-read-write only"""
    os.chmod(filepath, 0600)

def showit(filepath, www_dir, www_url):
    """Make file at filepath publicly readable in www_dir via www_url"""
    name = os.path.basename(filepath)
    dest = os.path.join(www_dir, name)
    # Note: does not check if file exists at dest!
    shutil.copyfile(filepath, dest)
    os.chmod(dest, 0644)
    print os.path.join(www_url, escape(name))
    action = raw_input("(d)elete, make (p)rivate, (r)ename, return to continue: ")
    cmd_map = { 'd': delete, 'r': rename, 'p': private }

    if action:
        cmd = action.lower()[0]
        if cmd in cmd_map:
            cmd_map[cmd](filepath)


if __name__ == "__main__":
    try:
        www_dir = os.environ['MUTT_TEMP_WWW_DIR']
        www_url = os.environ['MUTT_TEMP_WWW_URL']
    except KeyError:
        print "You must set $MUTT_TEMP_WWW_DIR and $MUTT_TEMP_WWW_URL."
    filepath = sys.argv[1]
    showit(filepath, www_dir, www_url)