Class Result

pattern/web/__init__.py:922–964

LATEST    = "latest"    # Sort results by most recent.

class Result(dict):

    def __init__(self, url):
        """ An item in a list of results returned by SearchEngine.search().
            All dictionary entries are available as unicode string attributes.
            - url     : the URL of the referred web content,
            - title   : the title of the content at the URL,
            - text    : the content text,
            - language: the content language,
            - author  : for news items and images, the author,
            - date    : for news items, the publication date.
        """
        dict.__init__(self)
        self.url   = url

    @property
    def description(self):
        return self.text # Backwards compatibility.

    def download(self, *args, **kwargs):
        """ Download the content at the given URL.
            By default it will be cached - see URL.download().
        """
        return URL(self.url).download(*args, **kwargs)

    def __getattr__(self, k):
        return self.get(k, u"")
    def __getitem__(self, k):
        return self.get(k, u"")
    def __setattr__(self, k, v):
        dict.__setitem__(self, u(k), v is not None and u(v) or u"") # Store strings as unicode.
    def __setitem__(self, k, v):
        dict.__setitem__(self, u(k), v is not None and u(v) or u"")

    def setdefault(self, k, v):
        dict.setdefault(self, u(k), u(v))
    def update(self, *args, **kwargs):
        map = dict()
        map.update(*args, **kwargs)
        dict.update(self, [(u(k), u(v)) for k, v in map.items()])

    def __repr__(self):
        return "Result(%s)" % dict.__repr__(self)

class Results(list):