docs: def list(self, includes=None, doc_type=None, promulgated_only=False,
               sort=None, owner=None, series=None):
          '''
          List entities in the charmstore.
  
          @param includes What metadata to return in results (e.g. charm-config).
          @param doc_type Filter to this type: bundle or charm.
          @param promulgated_only Whether to filter to only promulgated charms.
          @param sort Sorting the result based on the sort string provided
              which can be name, author, series and - in front for descending.
          @param owner Optional owner. If provided, search results will only
              include entities that owner can view.
          @param series The series to filter; can be a list of series or a
              single series.
          '''
          queries = self._common_query_parameters(doc_type, includes, owner,
                                                  promulgated_only, series, sort)
          if len(queries):
              url = '{}/list?{}'.format(self.url, urlencode(queries))
          else:
              url = '{}/list'.format(self.url)
          data = self._get(url)
          return data.json()['Results']