diff --git a/scrapinghub/client/jobs.py b/scrapinghub/client/jobs.py index 75d0acbc..62053ac4 100644 --- a/scrapinghub/client/jobs.py +++ b/scrapinghub/client/jobs.py @@ -355,14 +355,17 @@ def summary(self, state=None, spider=None, **params): def iter_last(self, start=None, start_after=None, count=None, spider=None, **params): - """Iterate through last jobs for each spider. + """Iterate over the most recent job of each spider. + + Spiders are iterated in key order, where a spider key is + ``'/'``. *start* is the key of the first spider + to include, *start_after* the key of the spider after which to start, + and *count* the maximum number of spiders to return. + + *spider* is a spider name, not needed if instantiated with + :class:`~scrapinghub.client.spiders.Spider`. *params* are additional + keyword arguments. - :param start: (optional) - :param start_after: (optional) - :param count: (optional) - :param spider: (optional) a spider name (not needed if instantiated - with :class:`~scrapinghub.client.spiders.Spider`). - :param params: (optional) additional keyword args. :return: a generator object over a list of dictionaries of jobs summary for a given filter params. :rtype: :class:`types.GeneratorType[dict]`