semvec/pypi-packages huggingface dataset:
scrapy-mosquitera 0.1.1
Restrict crawl and scraping scope using matchers.
License: BSD
Keywords: mosquitera,scrapy-mosquitera

===============================================
scrapy-mosquitera - tools for filtered scraping
===============================================


.. image:: https://travis-ci.org/scrapinghub/scrapy-mosquitera.svg?branch=master
        :target: https://travis-ci.org/scrapinghub/scrapy-mosquitera

.. image:: https://img.shields.io/pypi/v/scrapy-mosquitera.svg?maxAge=2592000
        :target: https://pypi.python.org/pypi/scrapy-mosquitera

.. image:: https://img.shields.io/pypi/pyversions/scrapy-mosquitera.svg?maxAge=2592000

.. image:: https://img.shields.io/pypi/l/scrapy-mosquitera.svg?maxAge=2592000



.. epigraph::

   How can I scrape items off a site from the last five days?

   -- Scrapy User


That question started the development of **scrapy-mosquitera**, a tool to help
you restrict crawling and scraping scope using *matchers*.

Matchers are simple Python functions that return the validity of an element
under certain restrictions.

The first goal in the project was date matching, but you can create your own
matcher for your own crawling and scraping needs.


How it works
============

In the case where the dates are available in the URLs, you will just use
the matcher function directly in your code::


  from scrapy_mosquitera.matchers import date_matches

   date = scrape_date_from_url(url)

   if date_matches(data=date, after='5 days ago'):
      yield Request(url=url, callback=self.parse_item)


To handle the case when the date is only available at the time when you scrape
the items, **scrapy-mosquitera** provides a ``PaginationMixin`` to control the
crawl according to the dates scraped.

Head on to the remaining of the `documentation`_  for more details.

.. _documentation: http://scrapy-mosquitera.readthedocs.io


Installation
============

The quick way::

    pip install scrapy-mosquitera