text: '''
  Support for Layman
  
  '''
  
  import salt.utils
  
  def __virtual__():
      '''
      Only work on Gentoo systems with layman installed
      '''
      if __grains__['os'] == 'Gentoo' and salt.utils.which('layman'):
          return 'layman'
      return False
  
  def _get_makeconf():
      '''
      Find the correct make.conf. Gentoo recently moved the make.conf
      but still supports the old location, using the old location first
      '''
      old_conf = '/etc/make.conf'
      new_conf = '/etc/portage/make.conf'
      if __salt__['file.file_exists'](old_conf):
          return old_conf
      elif __salt__['file.file_exists'](new_conf):
          return new_conf
  
  def add(overlay):
      '''
      Add the given overlay from the caced remote list to your locally
      installed overlays. Specify 'ALL' to add all overlays from the
      remote list.
  
      Return a list of the new overlay(s) added:
  
      CLI Example::
  
          salt '*' layman.add <overlay name>
      '''
      ret = list()
      old_overlays = list_local()
      cmd = 'layman --quietness=0 --add {0}'.format(overlay)
      __salt__['cmd.retcode'](cmd)
      new_overlays = list_local()
  
      # If we did not have any overlays before and we successfully added
      # a new one. We need to ensure the make.conf is sourcing layman's
      # make.conf so emerge can see the overlays
      if len(old_overlays) == 0 and len(new_overlays) > 0:
          srcline = 'source /var/lib/layman/make.conf'
          makeconf = _get_makeconf()
          if not __salt__['file.contains'](makeconf, 'layman'):
              __salt__['file.append'](makeconf, srcline)
  
      ret = [overlay for overlay in new_overlays if overlay not in old_overlays]
      return ret
  
  
  def delete(overlay):
      '''
      Remove the given overlay from the your locally installed overlays.
      Specify 'ALL' to remove all overlays.
  
      Return a list of the overlays(s) that were removed:
  
      CLI Example::
  
          salt '*' layman.delete <overlay name>
      '''
      ret = list()
      old_overlays = list_local()
      cmd = 'layman --quietness=0 --delete {0}'.format(overlay)
      __salt__['cmd.retcode'](cmd)
      new_overlays = list_local()
  
      # If we now have no overlays added, We need to ensure that the make.conf
      # does not source layman's make.conf, as it will break emerge
      if len(new_overlays) == 0:
          srcline = 'source /var/lib/layman/make.conf'
          makeconf = _get_makeconf()
          if __salt__['file.contains'](makeconf, 'layman'):
              __salt__['file.sed'](makeconf, srcline, '')
  
      ret = [overlay for overlay in old_overlays if overlay not in new_overlays]
      return ret
  
  def sync(overlay='ALL'):
      '''
      Update the specified overlay. Use 'ALL' to synchronize all overlays.
      This is the default if no overlay is specified.
  
      overlay
          Name of the overlay to sync. (Defaults to 'ALL')
  
      CLI Example::
  
          salt '*' layman.sync
      '''
      cmd = 'layman --quietness=0 --sync {0}'.format(overlay)
      return __salt__['cmd.retcode'](cmd) == 0
  
  def list_local():
      '''
      List the locally installed overlays.
  
      Return a list of installed overlays:
  
      CLI Example::
  
          salt '*' layman.list_local
      '''
      cmd = 'layman --quietness=1 --list-local --nocolor'
      out = __salt__['cmd.run'](cmd).split('\n')
      ret = [line.split()[1] for line in out if len(line.split()) > 2]
      return ret
  