docs: def diff(local_path, remote_path):
      """Return true if local and remote paths differ in contents"""
      with hide('commands'):
          if isinstance(local_path, basestring):
              with open(local_path) as stream:
                  local_content = stream.read()
          else:
              pos = local_path.tell()
              local_content = local_path.read()
              local_path.seek(pos)
          remote_content = StringIO()
          with settings(hide('warnings'), warn_only=True):
              if get(remote_path, remote_content).failed:
                  return True
          return local_content.strip() != remote_content.getvalue().strip()