"Carry exception state when a session blows up."
    def __init__(self, msg):
        Exception.__init__(self)
        self.msg = msg

class FreecodeSession:
    "Encapsulate the state of a Freecode API session."
    server = "https://freecode.com/"

    def __init__(self, auth=None, verbose=0, emit_enable=True):
        "Initialize Freecode session credentials."
        self.auth = auth
        self.verbose = verbose
        self.emit_enable = emit_enable
        self.project = None
        self.permalink = None
        self.id = None
        self.project_data = None
        # If user didn't supply credentials, fetch from ~/.netrc
        if not self.auth:
            try:
                credentials = netrc.netrc()
            except netrc.NetrcParseError, e:
                raise FreecodeSessionException("ill-formed .netrc: %s:%s %s" \
                                               % (e.filename, e.lineno, e.msg))
            except IOError, e:
                raise FreecodeSessionException(("missing .netrc file %s" % \
                                                 str(e).split()[-1]))
            ret = credentials.authenticators("freecode")
            if not ret:
                raise FreecodeSessionException("no credentials for Freecode")
            _login, self.auth, _password = ret

    def on_project(self, name):
        "Select project by Freecode shortname."
        if self.verbose:
            print "Selecting project: %s" % name
        self.project = name

        if self.verbose:
            print "URL list update for %s is: %s" % (self.project, urlassoc)
        # First, get permalinks for all existing URLs
        uquery = FreecodeSession.server + "projects/%s/urls.json?auth_code=%s" \
                % (self.permalink, self.auth)
        handle = urllib2.urlopen(uquery)
        content = json.loads(handle.read())
        permadict = {}
        for item in content:
            inner = item['url']
            permadict[inner['label']] = inner['permalink']
        # OK, now run through the update list...
        for (label, url) in urlassoc:
            if label in permadict:
                # updating where we need to
                self.edit_request("projects/%s/urls/%s.json"
                                  % (self.permalink, permadict[label]),
                                  "PUT",
                                  {"url" : {"label": label, "location" : url}})
            else:
                # and adding where we don't.
                self.edit_request("projects/%s/urls.json"
                                  % (self.permalink,),
                                  "POST",
                                  {"url" : {"label": label, "location" : url}})
        # Delete URLs that weren't in the update list
        remove = set(permadict.keys()) - set(map(lambda x: x[0], urlassoc))
        for label in remove:
            self.edit_request("projects/%s/urls/%s.json?auth_code=%s"
                                  % (self.permalink, permadict[label], self.auth),
                                  "DELETE", {})
class FreecodeMetadataFactory:
    "Factory class for producing Freecode records in JSON."
    freecode_field_map = (
        ("Project",          "P", "name"),                   # Project
        ("Summary",          "S", "oneliner"),               # Project
        ("Description",      "D", "description"),            # Project
        ("License-List",     "L", "license_list"),           # Project