def __init__(self, datadir=None, options=None):
        """ Provides the core functionality to configure the used software 
        repositories, the corresponding authentication keys and 
        update automation """
        self.popconfile = "/etc/popularity-contest.conf"

        # FIXME: some saner way is needed here
        if datadir == None:
            datadir = "/usr/share/software-properties/"
        self.datadir = datadir

        self.sourceslist = SourcesList()
        self.distro = aptsources.distro.get_distro()

        self.seen_server = []
        self.modified_sourceslist = False

        self.reload_sourceslist()
        self.backup_sourceslist()

        self.backup_apt_conf()

        # FIXME: we need to store this value in a config option
        #self.custom_mirrors = ["http://adasdwww.de/ubuntu"]
        self.custom_mirrors = []

        # apt-key stuff
        self.apt_key = AptAuth()
  def __init__(self, datadir=None, options=None):
    """ Provides the core functionality to configure the used software 
        repositories, the corresponding authentication keys and 
        update automation """
    self.popconfile = "/etc/popularity-contest.conf"

    # FIXME: some saner way is needed here
    if datadir == None:
      datadir = "/usr/share/software-properties/"
    self.options = options
    self.datadir = datadir

    self.sourceslist = SourcesList()
    self.distro = aptsources.distro.get_distro()
    
    self.seen_server = []
    self.modified_sourceslist = False

    self.reload_sourceslist()
    self.backup_sourceslist()

    self.backup_apt_conf()

    # FIXME: we need to store this value in a config option
    #self.custom_mirrors = ["http://adasdwww.de/ubuntu"]
    self.custom_mirrors= []

    # apt-key stuff
    self.apt_key = AptAuth()

    atexit.register(self.wait_for_threads)
class SoftwareProperties:
    def __init__(self, datadir=None, options=None):
        """ Provides the core functionality to configure the used software 
        repositories, the corresponding authentication keys and 
        update automation """
        self.popconfile = "/etc/popularity-contest.conf"

        # FIXME: some saner way is needed here
        if datadir == None:
            datadir = "/usr/share/software-properties/"
        self.datadir = datadir

        self.sourceslist = SourcesList()
        self.distro = aptsources.distro.get_distro()

        self.seen_server = []
        self.modified_sourceslist = False

        self.reload_sourceslist()
        self.backup_sourceslist()

        self.backup_apt_conf()

        # FIXME: we need to store this value in a config option
        #self.custom_mirrors = ["http://adasdwww.de/ubuntu"]
        self.custom_mirrors = []

        # apt-key stuff
        self.apt_key = AptAuth()

    def backup_apt_conf(self):
        """Backup all apt configuration options"""
        self.apt_conf_backup = {}
        for option in softwareproperties.CONF_MAP.keys():
            value = apt_pkg.Config.FindI(softwareproperties.CONF_MAP[option])
            self.apt_conf_backup[option] = value

    def restore_apt_conf(self):
        """Restore the stored apt configuration"""
        for option in self.apt_conf_backup.keys():
            apt_pkg.Config.Set(softwareproperties.CONF_MAP[option],
                               str(self.apt_conf_backup[option]))
        self.write_config()

    def get_update_automation_level(self):
        """ Parse the apt cron configuration. Try to fit a predefined use case 
        and return it. Special case: if the user made a custom 
        configurtation, that we cannot represent it will return None """
        if apt_pkg.Config.FindI(softwareproperties.CONF_MAP["autoupdate"]) > 0:
            # Autodownload
            if apt_pkg.Config.FindI(softwareproperties.CONF_MAP["unattended"]) == 1\
               and apt_pkg.Config.FindI(softwareproperties.CONF_MAP["autodownload"]) == 1 :
                return softwareproperties.UPDATE_INST_SEC
            elif apt_pkg.Config.FindI(softwareproperties.CONF_MAP["autodownload"]) == 1 and  \
                 apt_pkg.Config.FindI(softwareproperties.CONF_MAP["unattended"]) == 0:
                return softwareproperties.UPDATE_DOWNLOAD
            elif apt_pkg.Config.FindI(softwareproperties.CONF_MAP["unattended"]) == 0 and \
                 apt_pkg.Config.FindI(softwareproperties.CONF_MAP["autodownload"]) == 0:
                return softwareproperties.UPDATE_NOTIFY
            else:
                return None
        elif apt_pkg.Config.FindI(softwareproperties.CONF_MAP["unattended"]) == 0 and \
             apt_pkg.Config.FindI(softwareproperties.CONF_MAP["autodownload"]) == 0:
            return softwareproperties.UPDATE_MANUAL
        else:
            return None

    def set_update_automation_level(self, state):
        """ Set the apt periodic configurtation to the selected 
        update automation level. To synchronize the cache update and the 
        actual upgrading function, the upgrade function, e.g. unattended, 
        will run every day, if enabled. """
        if state == softwareproperties.UPDATE_INST_SEC:
            apt_pkg.Config.Set(softwareproperties.CONF_MAP["unattended"],
                               str(1))
            apt_pkg.Config.Set(softwareproperties.CONF_MAP["autodownload"],
                               str(1))
        elif state == softwareproperties.UPDATE_DOWNLOAD:
            apt_pkg.Config.Set(softwareproperties.CONF_MAP["autodownload"],
                               str(1))
            apt_pkg.Config.Set(softwareproperties.CONF_MAP["unattended"],
                               str(0))
        elif state == softwareproperties.UPDATE_NOTIFY:
            apt_pkg.Config.Set(softwareproperties.CONF_MAP["autodownload"],
                               str(0))
            apt_pkg.Config.Set(softwareproperties.CONF_MAP["unattended"],
                               str(0))
        else:
            apt_pkg.Config.Set(softwareproperties.CONF_MAP["autoupdate"],
                               str(0))
            apt_pkg.Config.Set(softwareproperties.CONF_MAP["unattended"],
                               str(0))
            apt_pkg.Config.Set(softwareproperties.CONF_MAP["autodownload"],
                               str(0))
        self.set_modified_config()

    def set_update_interval(self, days):
        """Set the interval in which we check for available updates"""
        # Only write the key if it has changed
        if not days == apt_pkg.Config.FindI(
                softwareproperties.CONF_MAP["autoupdate"]):
            apt_pkg.Config.Set(softwareproperties.CONF_MAP["autoupdate"],
                               str(days))
            self.set_modified_config()

    def get_update_interval(self):
        """ Returns the interval of the apt periodic cron job """
        return apt_pkg.Config.FindI(softwareproperties.CONF_MAP["autoupdate"])

    def get_popcon_participation(self):
        """ Will return True if the user wants to participate in the popularity 
        contest. Otherwise it will return False. Special case: if no 
        popcon is installed it will return False """
        if os.path.exists(self.popconfile):
            lines = open(self.popconfile).read().split("\n")
            active = False
            for line in lines:
                try:
                    (key, value) = line.split("=")
                    if key == "PARTICIPATE" and value.strip(
                            '"').lower() == "yes":
                        active = True
                except ValueError:
                    continue
            return active
        else:
            return False

    def set_popcon_pariticipation(self, is_helpful):
        """ Enable or disable the participation in the popularity contest """
        if is_helpful == True:
            value = "yes"
        else:
            value = "no"
        if os.path.exists(self.popconfile):
            # read the current config and replace the corresponding settings
            # FIXME: should we check the other values, too?
            lines = map(
                lambda line: re.sub(r'^(PARTICIPATE=)(".+?")', '\\1"%s"' %
                                    value, line),
                open(self.popconfile, "r").readlines())
        else:
            # create a new popcon config file
            m = md5.new()
            m.update(open("/dev/urandom", "r").read(1024))
            id = m.hexdigest()
            lines = []
            lines.append("MY_HOSTID=\"%s\"\n" % id)
            lines.append("PARTICIPATE=\"%s\"\n" % str(value))
            lines.append("USE_HTTP=\"yes\"\n")
        open(self.popconfile, "w").writelines(lines)

    def get_source_code_state(self):
        """Return True if all distro componets are also available as 
       source code. Otherwise return Flase. Special case: If the
       configuration cannot be represented return None"""

        if len(self.distro.source_code_sources) < 1:
            # we don't have any source code sources, so
            # uncheck the button
            self.distro.get_source_code = False
            return False
        else:
            # there are source code sources, so we check the button
            self.distro.get_source_code = True
            # check if there is a corresponding source code source for
            # every binary source. if not set the checkbutton to inconsistent
            templates = {}
            sources = []
            sources.extend(self.distro.main_sources)
            sources.extend(self.distro.child_sources)
            for source in sources:
                if templates.has_key(source.template):
                    for comp in source.comps:
                        templates[source.template].add(comp)
                else:
                    templates[source.template] = set(source.comps)
            # add fake http sources for the cdrom, since the sources
            # for the cdrom are only available in the internet
            if len(self.distro.cdrom_sources) > 0:
                templates[
                    self.distro.source_template] = self.distro.cdrom_comps
            for source in self.distro.source_code_sources:
                if not templates.has_key(source.template) or \
                   (templates.has_key(source.template) and not \
                    (len(set(templates[source.template]) ^ set(source.comps)) == 0\
                     or (len(set(source.comps) ^ self.distro.enabled_comps) == 0))):
                    self.distro.get_source_code = False
                    return None
                    break
        return True

    def print_source_entry(self, source):
        """Print the data of a source entry to the command line"""
        for (label, value) in [("URI:", source.uri), ("Comps:", source.comps),
                               ("Enabled:", not source.disabled),
                               ("Valid:", not source.invalid)]:
            print " %s %s" % (label, value)
        if source.template:
            for (label, value) in [("MatchURI:", source.template.match_uri),
                                   ("BaseURI:", source.template.base_uri)]:
                print " %s %s" % (label, value)
        print "\n"

    def massive_debug_output(self):
        """Print the complete sources.list"""
        print "START SOURCES.LIST:"
        for source in self.sourceslist:
            print source.str()
        print "END SOURCES.LIST\n"

    def enable_component(self, comp):
        """Enable a component of the distro"""
        self.distro.enable_component(comp)
        self.set_modified_sourceslist()

    def disable_component(self, comp):
        """Disable a component of the distro"""
        self.distro.disable_component(comp)
        self.set_modified_sourceslist()

    def disable_child_source(self, template):
        """Enable a child repo of the distribution main repository"""
        for source in self.distro.child_sources:
            if source.template == template:
                self.sourceslist.remove(source)
        for source in self.distro.source_code_sources:
            if source.template == template:
                self.sourceslist.remove(source)
        self.set_modified_sourceslist()

    def enable_child_source(self, template):
        """Enable a child repo of the distribution main repository"""
        # Use the currently selected mirror only if the child source
        # did not override the server
        if template.base_uri == None:
            child_uri = self.distro.default_server
        else:
            child_uri = template.base_uri
        self.distro.add_source(uri=child_uri, dist=template.name)
        self.set_modified_sourceslist()

    def disable_source_code_sources(self):
        """Remove all distro source code sources"""
        sources = []
        sources.extend(self.distro.main_sources)
        sources.extend(self.distro.child_sources)
        # remove all exisiting sources
        for source in self.distro.source_code_sources:
            self.sourceslist.remove(source)
        self.set_modified_sourceslist()

    def enable_source_code_sources(self):
        """Enable source code source for all distro sources"""
        sources = []
        sources.extend(self.distro.main_sources)
        sources.extend(self.distro.child_sources)

        # remove all exisiting sources
        for source in self.distro.source_code_sources:
            self.sourceslist.remove(source)

        for source in sources:
            self.sourceslist.add("deb-src", source.uri, source.dist,
                                 source.comps, "Added by software-properties",
                                 self.sourceslist.list.index(source) + 1,
                                 source.file)
        for source in self.distro.cdrom_sources:
            self.sourceslist.add("deb-src",
                                 self.distro.source_template.base_uri,
                                 self.distro.source_template.name,
                                 source.comps, "Added by software-properties",
                                 self.sourceslist.list.index(source) + 1,
                                 source.file)
        self.set_modified_sourceslist()

    def backup_sourceslist(self):
        """Store a backup of the source.list in memory"""
        self.sourceslist_backup = []
        for source in self.sourceslist.list:
            source_bkp = SourceEntry(line=source.line, file=source.file)
            self.sourceslist_backup.append(source_bkp)

    def toggle_source_use(self, source):
        """Enable or disable the selected channel"""
        #FIXME cdroms need to disable the comps in the childs and sources
        source.disabled = not source.disabled
        self.set_modified_sourceslist()

    def revert(self):
        """Revert all settings to the state when software-properties 
       was launched"""
        #FIXME: GPG keys are still missing
        self.restore_apt_conf()
        self.revert_sourceslist()

    def revert_sourceslist(self):
        """Restore the source list from the startup of the dialog"""
        self.sourceslist.list = []
        for source in self.sourceslist_backup:
            source_reset = SourceEntry(line=source.line, file=source.file)
            self.sourceslist.list.append(source_reset)
        self.save_sourceslist()
        self.reload_sourceslist()

    def set_modified_sourceslist(self):
        """The sources list was changed and now needs to be saved and reloaded"""
        self.modified_sourceslist = True
        if self.options.massive_debug == True:
            self.massive_debug_output()
        self.save_sourceslist()
        self.reload_sourceslist()

    def set_modified_config(self):
        """Write the changed apt configuration to file"""
        self.write_config()

    def render_source(self, source):
        """Render a nice output to show the source in a treeview"""
        if source.template == None:
            if source.comment:
                contents = "<b>%s</b>" % escape(source.comment)
                # Only show the components if there are more than one
                if len(source.comps) > 1:
                    for c in source.comps:
                        contents += " %s" % c
            else:
                contents = "<b>%s %s</b>" % (source.uri, source.dist)
                for c in source.comps:
                    contents += " %s" % c
            if source.type in ("deb-src", "rpm-src"):
                contents += " %s" % _("(Source Code)")
            return contents
        else:
            # try to make use of a corresponding template
            contents = "<b>%s</b>" % source.template.description
            if source.type in ("deb-src", "rpm-src"):
                contents += " (%s)" % _("Source Code")
            if source.comment:
                contents += " %s" % source.comment
            if source.template.child == False:
                for comp in source.comps:
                    if source.template.has_component(comp):
                        # fixme: move something like this into distinfo.Template
                        #        (why not use a dictionary again?)
                        for c in source.template.components:
                            if c.name == comp:
                                contents += "\n%s" % c.description
                    else:
                        contents += "\n%s" % comp
            return contents

    def get_comparable(self, source):
        """extract attributes to sort the sources"""
        cur_sys = 1
        has_template = 1
        has_comment = 1
        is_source = 1
        revert_numbers = string.maketrans("0123456789", "9876543210")
        if source.template:
            has_template = 0
            desc = source.template.description
            if source.template.distribution == self.distro:
                cur_sys = 0
        else:
            desc = "%s %s %s" % (source.uri, source.dist, source.comps)
            if source.comment:
                has_comment = 0
        if source.type.find("src"):
            is_source = 0
        return (cur_sys, has_template, has_comment, is_source,
                desc.translate(revert_numbers))

    def get_isv_sources(self):
        """Return a list of sources that are not part of the distribution"""
        isv_sources = []
        for source in self.sourceslist.list:
            if not source.invalid and\
               (source not in self.distro.main_sources and\
                source not in self.distro.cdrom_sources and\
                source not in self.distro.child_sources and\
                source not in self.distro.disabled_sources) and\
               source not in self.distro.source_code_sources:
                isv_sources.append(source)
        return isv_sources

    def get_cdrom_sources(self):
        """Return the list of CDROM based distro sources"""
        return self.distro.cdrom_sources

    def get_comp_download_state(self, comp):
        """Return a tuple: the first value describes if a component is enabled
       in the Internet repositories. The second value describes if the
       first value is inconsistent."""
        #FIXME: also return a correct inconsistent value
        return (comp.name in self.distro.download_comps, False)

    def get_comp_child_state(self, template):
        """Return a tuple: the first value describes if a component is enabled
       in one of the child source that matcth the given template. 
       The second value describes if the first value is inconsistent."""
        comps = []
        for child in self.distro.child_sources:
            if child.template == template:
                comps.extend(child.comps)
        if len(comps) > 0 and \
            len(self.distro.enabled_comps ^ set(comps)) == 0:
            # All enabled distro components are also enabled for the child source
            return (True, False)
        elif len(comps) > 0 and\
            len(self.distro.enabled_comps ^ set(comps)) != 0:
            # A matching child source does exist but doesn't include all
            # enabled distro components
            return (False, True)
        else:
            # There is no corresponding child source at all
            return (False, False)

    def reload_sourceslist(self):
        self.sourceslist.refresh()
        self.sourceslist_visible = []
        self.distro.get_sources(self.sourceslist)

    def write_config(self):
        """Write the current apt configuration to file"""
        # update the adept file as well if it is there
        conffiles = [
            "/etc/apt/apt.conf.d/10periodic",
            "/etc/apt/apt.conf.d/15adept-periodic-update"
        ]

        # check (beforehand) if one exists, if not create one
        for f in conffiles:
            if os.path.isfile(f):
                break
        else:
            print "No config found, creating one"
            open(conffiles[0], "w")

        # now update them
        for periodic in conffiles:
            # read the old content first
            content = []
            if os.path.isfile(periodic):
                content = open(periodic, "r").readlines()
                cnf = apt_pkg.Config.SubTree("APT::Periodic")

                # then write a new file without the updated keys
                f = open(periodic, "w")
                for line in content:
                    for key in cnf.List():
                        if line.find("APT::Periodic::%s" % (key)) >= 0:
                            break
                    else:
                        f.write(line)

                # and append the updated keys
                for i in cnf.List():
                    f.write("APT::Periodic::%s \"%s\";\n" % (i, cnf.FindI(i)))
                f.close()

    def save_sourceslist(self):
        """Backup the existing sources.list files and write the current 
       configuration"""
        self.sourceslist.backup(".save")
        self.sourceslist.save()

    def add_source_from_line(self, line):
        """Add a source with the given apt line"""
        self.sourceslist.list.append(SourceEntry(line))
        self.set_modified_sourceslist()

    def remove_source(self, source):
        """Remove the given source"""
        self.sourceslist.remove(source)
        self.set_modified_sourceslist()

    def add_key(self, path):
        """Add a gnupg key to the list of trusted software vendors"""
        if not os.path.exists(path):
            return False
        try:
            self.apt_key.add(path)
            return True
        except:
            return False

    def remove_key(self, fingerprint):
        """Remove a gnupg key from the list of trusted software vendors"""
        try:
            self.apt_key.rm(fingerprint)
            return True
        except:
            return False
class SoftwareProperties(object):

  # known (whitelisted) channels
  CHANNEL_PATH="/usr/share/app-install/channels/"

  # release upgrades policy
  RELEASE_UPGRADES_CONF = "/etc/update-manager/release-upgrades"
  #RELEASE_UPGRADES_CONF = "/tmp/release-upgrades"
  (
    RELEASE_UPGRADES_NEVER,
    RELEASE_UPGRADES_NORMAL,
    RELEASE_UPGRADES_LTS
  ) = range(3)
  release_upgrades_policy_map = {
    RELEASE_UPGRADES_NEVER  : 'never',
    RELEASE_UPGRADES_NORMAL : 'normal',
    RELEASE_UPGRADES_LTS    : 'lts',
  }
  
  def __init__(self, datadir=None, options=None):
    """ Provides the core functionality to configure the used software 
        repositories, the corresponding authentication keys and 
        update automation """
    self.popconfile = "/etc/popularity-contest.conf"

    # FIXME: some saner way is needed here
    if datadir == None:
      datadir = "/usr/share/software-properties/"
    self.options = options
    self.datadir = datadir

    self.sourceslist = SourcesList()
    self.distro = aptsources.distro.get_distro()
    
    self.seen_server = []
    self.modified_sourceslist = False

    self.reload_sourceslist()
    self.backup_sourceslist()

    self.backup_apt_conf()

    # FIXME: we need to store this value in a config option
    #self.custom_mirrors = ["http://adasdwww.de/ubuntu"]
    self.custom_mirrors= []

    # apt-key stuff
    self.apt_key = AptAuth()

    atexit.register(self.wait_for_threads)

  def wait_for_threads(self):
    " wait for all running threads (PPA key fetchers) to exit "
    for t in threading.enumerate():
      if t.ident != threading.current_thread().ident:
        t.join()

  def backup_apt_conf(self):
    """Backup all apt configuration options"""
    self.apt_conf_backup = {}
    for option in softwareproperties.CONF_MAP.keys():
        value = apt_pkg.config.find_i(softwareproperties.CONF_MAP[option])
        self.apt_conf_backup[option] = value

  def restore_apt_conf(self):
    """Restore the stored apt configuration"""
    for option in self.apt_conf_backup.keys():
        apt_pkg.config.set(softwareproperties.CONF_MAP[option],
                           str(self.apt_conf_backup[option]))
    self.write_config()

  def get_update_automation_level(self):
    """ Parse the apt cron configuration. Try to fit a predefined use case 
        and return it. Special case: if the user made a custom 
        configurtation, that we cannot represent it will return None """
    if apt_pkg.config.find_i(softwareproperties.CONF_MAP["autoupdate"]) > 0:
        # Autodownload
        if apt_pkg.config.find_i(softwareproperties.CONF_MAP["unattended"]) == 1\
           and apt_pkg.config.find_i(softwareproperties.CONF_MAP["autodownload"]) == 1 :
            return softwareproperties.UPDATE_INST_SEC
        elif apt_pkg.config.find_i(softwareproperties.CONF_MAP["autodownload"]) == 1 and  \
             apt_pkg.config.find_i(softwareproperties.CONF_MAP["unattended"]) == 0:
            return softwareproperties.UPDATE_DOWNLOAD
        elif apt_pkg.config.find_i(softwareproperties.CONF_MAP["unattended"]) == 0 and \
             apt_pkg.config.find_i(softwareproperties.CONF_MAP["autodownload"]) == 0:
            return softwareproperties.UPDATE_NOTIFY
        else:
            return None
    elif apt_pkg.config.find_i(softwareproperties.CONF_MAP["unattended"]) == 0 and \
         apt_pkg.config.find_i(softwareproperties.CONF_MAP["autodownload"]) == 0:
        return softwareproperties.UPDATE_MANUAL
    else:
        return None

  def set_update_automation_level(self, state):
    """ Set the apt periodic configurtation to the selected 
        update automation level. To synchronize the cache update and the 
        actual upgrading function, the upgrade function, e.g. unattended, 
        will run every day, if enabled. """
    if state == softwareproperties.UPDATE_INST_SEC:
        apt_pkg.config.set(softwareproperties.CONF_MAP["unattended"], str(1))
        apt_pkg.config.set(softwareproperties.CONF_MAP["autodownload"], str(1))
    elif state == softwareproperties.UPDATE_DOWNLOAD:
        apt_pkg.config.set(softwareproperties.CONF_MAP["autodownload"], str(1))
        apt_pkg.config.set(softwareproperties.CONF_MAP["unattended"], str(0))
    elif state == softwareproperties.UPDATE_NOTIFY:
        apt_pkg.config.set(softwareproperties.CONF_MAP["autodownload"], str(0))
        apt_pkg.config.set(softwareproperties.CONF_MAP["unattended"], str(0))
    else:
        apt_pkg.config.set(softwareproperties.CONF_MAP["autoupdate"], str(0))
        apt_pkg.config.set(softwareproperties.CONF_MAP["unattended"], str(0))
        apt_pkg.config.set(softwareproperties.CONF_MAP["autodownload"], str(0))
    self.set_modified_config()

  def set_update_interval(self, days):
      """Set the interval in which we check for available updates"""
      # Only write the key if it has changed
      if not days == apt_pkg.config.find_i(softwareproperties.CONF_MAP["autoupdate"]):
          apt_pkg.config.set(softwareproperties.CONF_MAP["autoupdate"], str(days))
          self.set_modified_config()

  def get_update_interval(self):
    """ Returns the interval of the apt periodic cron job """
    return apt_pkg.config.find_i(softwareproperties.CONF_MAP["autoupdate"])

  def get_release_upgrades_policy(self):
    """
    return the release upgrade policy:
     RELASE_UPGRADE_NEVER
     RELASE_UPGRADE_NORMAL
     RELASE_UPGRADE_LTS
    """
    # default (if no option is set) is NORMAL
    if not os.path.exists(self.RELEASE_UPGRADES_CONF):
      return self.RELEASE_UPGRADES_NORMAL
    parser = ConfigParser()
    parser.read(self.RELEASE_UPGRADES_CONF)
    if parser.has_option("DEFAULT","Prompt"):
      type = parser.get("DEFAULT","Prompt").lower()
      for k, v in self.release_upgrades_policy_map.iteritems():
        if v == type:
          return k
    return self.RELEASE_UPGRADES_NORMAL

  def set_release_upgrades_policy(self, i):
    """
    set the release upgrade policy:
     RELASE_UPGRADE_NEVER
     RELASE_UPGRADE_NORMAL
     RELASE_UPGRADE_LTS
     """
    # we are note using ConfigParser.write() as it removes comments
    if not os.path.exists(self.RELEASE_UPGRADES_CONF):
      f = open(self.RELEASE_UPGRADES_CONF,"w")
      f.write("[DEFAULT]\nprompt=%s\n"% self.release_upgrades_policy_map[i])
      return True
    f = open(self.RELEASE_UPGRADES_CONF,"r")
    out = NamedTemporaryFile()
    for line in map(string.strip, f.readlines()):
      if line.lower().startswith("prompt"):
        out.write("prompt=%s\n" % self.release_upgrades_policy_map[i])
      else:
        out.write(line+"\n")
    out.flush()
    shutil.copymode(self.RELEASE_UPGRADES_CONF, out.name)
    shutil.copy(out.name, self.RELEASE_UPGRADES_CONF)
    return True

  def get_popcon_participation(self):
    """ Will return True if the user wants to participate in the popularity 
        contest. Otherwise it will return False. Special case: if no 
        popcon is installed it will return False """
    if os.path.exists(self.popconfile):
        lines = open(self.popconfile).read().split("\n")
        active = False
        for line in lines:
            try:
                (key,value) = line.split("=")
                if key == "PARTICIPATE" and value.strip('"').lower() == "yes":
                    active = True
            except ValueError:
                continue
        return active
    else:
        return False

  def set_popcon_pariticipation(self, is_helpful):
    """ Enable or disable the participation in the popularity contest """
    if is_helpful == True:
        value = "yes"
    else:
        value = "no"
    if os.path.exists(self.popconfile):
        # read the current config and replace the corresponding settings
        # FIXME: should we check the other values, too?
        lines = map(lambda line: re.sub(r'^(PARTICIPATE=)(".+?")',
                                        '\\1"%s"' % value,
                                        line),
                    open(self.popconfile, "r").readlines())
    else:
        # create a new popcon config file
        m = md5()
        m.update(open("/dev/urandom", "r").read(1024))
        id = m.hexdigest()
        lines = []
        lines.append("MY_HOSTID=\"%s\"\n" % id)
        lines.append("PARTICIPATE=\"%s\"\n" % str(value))
        lines.append("USE_HTTP=\"yes\"\n")
    open(self.popconfile, "w").writelines(lines)

  def get_source_code_state(self):
    """Return True if all distro componets are also available as 
       source code. Otherwise return Flase. Special case: If the
       configuration cannot be represented return None"""
  
    if len(self.distro.source_code_sources) < 1:
        # we don't have any source code sources, so
        # uncheck the button
        self.distro.get_source_code = False
        return False
    else:
        # there are source code sources, so we check the button
        self.distro.get_source_code = True
        # check if there is a corresponding source code source for
        # every binary source. if not set the checkbutton to inconsistent
        templates = {}
        sources = []
        sources.extend(self.distro.main_sources)
        sources.extend(self.distro.child_sources)
        for source in sources:
            if templates.has_key(source.template):
                for comp in source.comps:
                    templates[source.template].add(comp)
            else:
                templates[source.template] = set(source.comps)
        # add fake http sources for the cdrom, since the sources
        # for the cdrom are only available in the internet
        if len(self.distro.cdrom_sources) > 0:
            templates[self.distro.source_template] = self.distro.cdrom_comps
        for source in self.distro.source_code_sources:
            if not templates.has_key(source.template) or \
               (templates.has_key(source.template) and not \
                (len(set(templates[source.template]) ^ set(source.comps)) == 0\
                 or (len(set(source.comps) ^ self.distro.enabled_comps) == 0))):
                self.distro.get_source_code = False
                return None
                break
    return True

  def print_source_entry(self, source):
    """Print the data of a source entry to the command line"""
    for (label, value) in [("URI:", source.uri),
                           ("Comps:", source.comps),
                           ("Enabled:", not source.disabled),
                           ("Valid:", not source.invalid)]:
        print " %s %s" % (label, value)
    if source.template:
        for (label, value) in [("MatchURI:", source.template.match_uri),
                               ("BaseURI:", source.template.base_uri)]:
            print " %s %s" % (label, value)
    print "\n"

  def massive_debug_output(self):
    """Print the complete sources.list""" 
    print "START SOURCES.LIST:"
    for source in self.sourceslist:
        print source.str()
    print "END SOURCES.LIST\n"

  def enable_component(self, comp):
    """Enable a component of the distro"""
    self.distro.enable_component(comp) 
    self.set_modified_sourceslist()

  def disable_component(self, comp):
    """Disable a component of the distro"""
    self.distro.disable_component(comp) 
    self.set_modified_sourceslist()

  def disable_child_source(self, template):
    """Enable a child repo of the distribution main repository"""
    for source in self.distro.child_sources:
        if source.template == template:
            self.sourceslist.remove(source)
    for source in self.distro.source_code_sources:
        if source.template == template:
            self.sourceslist.remove(source)
    self.set_modified_sourceslist()

  def enable_child_source(self, template):
    """Enable a child repo of the distribution main repository"""
    # Use the currently selected mirror only if the child source
    # did not override the server
    if template.base_uri == None:
        child_uri = self.distro.default_server
    else:
        child_uri = template.base_uri
    self.distro.add_source(uri=child_uri, dist=template.name)
    self.set_modified_sourceslist()

  def disable_source_code_sources(self):
    """Remove all distro source code sources"""
    sources = []
    sources.extend(self.distro.main_sources)
    sources.extend(self.distro.child_sources)
    # remove all exisiting sources
    for source in self.distro.source_code_sources:
        self.sourceslist.remove(source)
    self.set_modified_sourceslist()
  
  def enable_source_code_sources(self):
    """Enable source code source for all distro sources"""
    sources = []
    sources.extend(self.distro.main_sources)
    sources.extend(self.distro.child_sources)

    # remove all exisiting sources
    for source in self.distro.source_code_sources:
        self.sourceslist.remove(source)

    for source in sources:
        self.sourceslist.add("deb-src",
                             source.uri,
                             source.dist,
                             source.comps,
                             "Added by software-properties",
                             self.sourceslist.list.index(source)+1,
                             source.file)
    for source in self.distro.cdrom_sources:
        self.sourceslist.add("deb-src",
                             self.distro.source_template.base_uri,
                             self.distro.source_template.name,
                             source.comps,
                             "Added by software-properties",
                             self.sourceslist.list.index(source)+1,
                             source.file)
    self.set_modified_sourceslist()

  def backup_sourceslist(self):
    """Store a backup of the source.list in memory"""
    self.sourceslist_backup = []
    for source in self.sourceslist.list:
        source_bkp = SourceEntry(line=source.line,file=source.file)
        self.sourceslist_backup.append(source_bkp)
  
  def toggle_source_use(self, source):
    """Enable or disable the selected channel"""
    #FIXME cdroms need to disable the comps in the childs and sources
    source.disabled = not source.disabled
    self.set_modified_sourceslist()

  def revert(self):
    """Revert all settings to the state when software-properties 
       was launched"""
    #FIXME: GPG keys are still missing
    self.restore_apt_conf()
    self.revert_sourceslist()

  def revert_sourceslist(self):
    """Restore the source list from the startup of the dialog"""
    self.sourceslist.list = []
    for source in self.sourceslist_backup:
        source_reset = SourceEntry(line=source.line,file=source.file)
        self.sourceslist.list.append(source_reset)
    self.save_sourceslist()
    self.reload_sourceslist()

  def set_modified_sourceslist(self):
    """The sources list was changed and now needs to be saved and reloaded"""
    self.modified_sourceslist = True
    if self.options and self.options.massive_debug:
        self.massive_debug_output()
    self.save_sourceslist()
    self.reload_sourceslist()

  def set_modified_config(self):
    """Write the changed apt configuration to file"""
    self.write_config()

  def render_source(self, source):
    """Render a nice output to show the source in a treeview"""
    if source.template == None:
        if source.comment:
            contents = "<b>%s</b> (%s %s" % (escape(source.comment),
                                              source.uri, source.dist)
            # Only show the components if there are more than one
            if len(source.comps) > 1:
                for c in source.comps:
                    contents += " %s" % c
            contents += ")"
        else:
            contents = "<b>%s %s</b>" % (source.uri, source.dist)
            for c in source.comps:
                contents += " %s" % c
        if source.type in ("deb-src", "rpm-src"):
            contents += " %s" % _("(Source Code)")
        return contents
    else:
        # try to make use of a corresponding template
        contents = "<b>%s</b>" % source.template.description
        if source.type in ("deb-src", "rpm-src"):
            contents += " (%s)" % _("Source Code")
        if source.comment:
            contents +=" %s" % source.comment
        if source.template.child == False:
            for comp in source.comps:
                if source.template.has_component(comp):
                    # fixme: move something like this into distinfo.Template
                    #        (why not use a dictionary again?)
                    for c in source.template.components:
                        if c.name == comp:
                            contents += "\n%s" % c.description
                else:
                    contents += "\n%s" % comp
        return contents

  def get_comparable(self, source):
      """extract attributes to sort the sources"""
      cur_sys = 1
      has_template = 1
      has_comment = 1
      is_source = 1
      revert_numbers = string.maketrans("0123456789", "9876543210")
      if source.template:
        has_template = 0
        desc = source.template.description
        if source.template.distribution == self.distro:
            cur_sys = 0
      else:
          desc = "%s %s %s" % (source.uri, source.dist, source.comps)
          if source.comment:
              has_comment = 0
      if source.type.find("src"):
          is_source = 0
      return (cur_sys, has_template, has_comment, is_source,
              desc.translate(revert_numbers))

  def get_isv_sources(self):
    """Return a list of sources that are not part of the distribution"""
    isv_sources = []
    for source in self.sourceslist.list:
        if not source.invalid and\
           (source not in self.distro.main_sources and\
            source not in self.distro.cdrom_sources and\
            source not in self.distro.child_sources and\
            source not in self.distro.disabled_sources) and\
           source not in self.distro.source_code_sources:
            isv_sources.append(source)
    return isv_sources

  def get_cdrom_sources(self):
    """Return the list of CDROM based distro sources"""
    return self.distro.cdrom_sources
      
  def get_comp_download_state(self, comp):
    """Return a tuple: the first value describes if a component is enabled
       in the Internet repositories. The second value describes if the
       first value is inconsistent."""
    #FIXME: also return a correct inconsistent value
    return (comp.name in self.distro.download_comps, False)

  def get_comp_child_state(self, template):
    """Return a tuple: the first value describes if a component is enabled
       in one of the child source that matcth the given template. 
       The second value describes if the first value is inconsistent."""
    comps = []
    for child in self.distro.child_sources:
        if child.template == template:
            comps.extend(child.comps)
    if len(comps) > 0 and \
        len(self.distro.enabled_comps ^ set(comps)) == 0:
        # All enabled distro components are also enabled for the child source
        return (True, False)
    elif len(comps) > 0 and\
        len(self.distro.enabled_comps ^ set(comps)) != 0:
        # A matching child source does exist but doesn't include all 
        # enabled distro components
        return(False, True)
    else:
        # There is no corresponding child source at all
        return (False, False)
  
  def reload_sourceslist(self):
    self.sourceslist.refresh()
    self.sourceslist_visible=[]
    self.distro.get_sources(self.sourceslist)    

  def write_config(self):
    """Write the current apt configuration to file"""
    # update the adept file as well if it is there
    conffiles = ["/etc/apt/apt.conf.d/10periodic",
                 "/etc/apt/apt.conf.d/20auto-upgrades",
                 "/etc/apt/apt.conf.d/15adept-periodic-update"]

    # check (beforehand) if one exists, if not create one
    for f in conffiles:
      if os.path.isfile(f):
        break
    else:
      print "No config found, creating one"
      open(conffiles[0], "w")

    # ensure /etc/cron.daily/apt is executable
    ac = "/etc/cron.daily/apt"
    if os.path.exists(ac):
      perm = os.stat(ac)[stat.ST_MODE]
      if not (perm & stat.S_IXUSR):
        print "file '%s' not executable, fixing" % ac
        os.chmod(ac, 0755)

    # now update them
    for periodic in conffiles:
      # read the old content first
      content = []
      if os.path.isfile(periodic):
        content = open(periodic, "r").readlines()
        cnf = apt_pkg.config.subtree("APT::Periodic")

        # then write a new file without the updated keys
        f = open(periodic, "w")
        for line in content:
          for key in cnf.list():
            if line.find("APT::Periodic::%s" % (key)) >= 0:
              break
          else:
            f.write(line)

        # and append the updated keys
        for i in cnf.list():
          f.write("APT::Periodic::%s \"%s\";\n" % (i, cnf.find_i(i)))
        f.close()    

  def save_sourceslist(self):
    """Backup the existing sources.list files and write the current 
       configuration"""
    self.sourceslist.backup(".save")
    self.sourceslist.save()

  def _is_line_in_whitelisted_channel(self, srcline):
    """
    helper that checks if a given line is in the source list
    return the channel name or None if not found
    """
    srcentry = SourceEntry(srcline)    
    if os.path.exists(self.CHANNEL_PATH):
      for f in glob.glob("%s/*.list" % self.CHANNEL_PATH):
        for line in open(f):
          if line.strip().startswith("#"):
            continue
          if srcentry == SourceEntry(line):
            return os.path.splitext(os.path.basename(f))[0]
    return None

  def check_and_add_key_for_whitelisted_channels(self, srcline):
    """
    helper that adds the gpg key of the channel to the apt
    keyring *if* the channel is in the whitelist
    /usr/share/app-install/channels or it is a public Launchpad PPA.
    """
    channel = self._is_line_in_whitelisted_channel(srcline)
    if channel:
      keyp = "%s/%s.key" % (self.CHANNEL_PATH, channel)
      self.add_key(keyp)
    # FIXME: abstract this all alway into the ppa.py file
    parsed_uri = urlparse(SourceEntry(srcline).uri)
    if parsed_uri.netloc == 'ppa.launchpad.net':
      worker = AddPPASigningKeyThread(parsed_uri.path)
      worker.start()

  def update_interface(self):
    " abstract interface to keep the UI alive "

  def add_source_from_line(self, line):
    """
    Add a source with the given apt line and auto-add
    signing key if we have it in the whitelist
    """
    (deb_line, file) = expand_ppa_line(line.strip(), self.distro.codename)
    debsrc_line = 'deb-src' + deb_line[3:]
    new_deb_entry = SourceEntry(deb_line, file)
    new_debsrc_entry = SourceEntry(debsrc_line, file)
    if new_deb_entry.invalid or new_debsrc_entry.invalid:
      return False
    self.check_and_add_key_for_whitelisted_channels(deb_line)
    self.sourceslist.list.append(new_deb_entry)
    self.sourceslist.list.append(new_debsrc_entry)
    self.set_modified_sourceslist()
    return True

  def remove_source(self, source):
    """Remove the given source"""
    # if its a sources.list.d file and it contains only a single line
    # (the line that we just remove), then all references to that
    # file are gone and the file is not saved. we work around that
    # here
    if source.file != apt_pkg.config.find_file("Dir::Etc::sourcelist"):
      self.sourceslist.list.append(SourceEntry("", file=source.file))
    self.sourceslist.remove(source)
    self.set_modified_sourceslist()

  def add_key(self, path):
    """Add a gnupg key to the list of trusted software vendors"""
    if not isinstance(path, unicode):
      path = unicode(path) # allows non-ascii filenames
    if not os.path.exists(path):
        return False
    try:
        return self.apt_key.add(path)
    except:
        return False

  def add_key_from_data(self, keydata):
    "Add a gnupg key from a data string (e.g. copy-n-paste)"
    tmp = tempfile.NamedTemporaryFile()
    tmp.write(keydata)
    tmp.flush()
    return self.add_key(tmp.name)

  def remove_key(self, fingerprint):
    """Remove a gnupg key from the list of trusted software vendors"""
    try:
        self.apt_key.rm(fingerprint)
        return True
    except:
        return False