docs: def list_upgrades(refresh=True, **kwargs):  # pylint: disable=W0613
      '''
      Check whether or not an upgrade is available for all packages
  
      CLI Example:
  
      .. code-block:: bash
  
          salt '*' pkg.list_upgrades
      '''
      if refresh:
          refresh_db()
  
      res = _call_brew('outdated --json=v1')
      ret = {}
  
      try:
          data = salt.utils.json.loads(res['stdout'])
      except ValueError as err:
          msg = 'unable to interpret output from "brew outdated": {0}'.format(err)
          log.error(msg)
          raise CommandExecutionError(msg)
  
      for pkg in data:
          # current means latest available to brew
          ret[pkg['name']] = pkg['current_version']
      return ret