# `urllib.robotparser` --- robots.txt 的剖析器

原始碼：Lib/urllib/robotparser.py

此模組 (module) 提供了一個單獨的類別 (class) `RobotFileParser`，它可以知道某個特定 user agent（使用者代理）是否能在有發布 `robots.txt` 文件的網站 fetch（擷取）特定 URL。有關 `robots.txt` 文件結構的更多細節，請參閱 http://www.robotstxt.org/orig.html。

class urllib.robotparser.RobotFileParser(url='')

  此類別提供了一些方法可以讀取、剖析和回答關於 url 上的 `robots.txt` 文件的問題。

  set_url(url)

    設置指向 `robots.txt` 文件的 URL。

  read()

    讀取 `robots.txt` URL 並將其輸入到剖析器。

  parse(lines)

    剖析 lines 引數。

  can_fetch(useragent, url)

    根據從 `robots.txt` 文件中剖析出的規則，如果 useragent 被允許 fetch url 的話，則回傳 `True`。

  mtime()

    回傳最近一次 fetch `robots.txt` 文件的時間。這適用於需要定期檢查 `robots.txt` 文件更新情況的長時間運行網頁爬蟲。

  modified()

    將最近一次 fetch `robots.txt` 文件的時間設置為當前時間。

  crawl_delay(useragent)

    針對指定的 useragent 從 `robots.txt` 回傳 `Crawl-delay` 參數的值。如果此參數不存在、不適用於指定的 useragent ，或是此參數在 `robots.txt` 中所指的條目含有無效語法，則回傳 `None`。

    在 3.6 版新加入.

  request_rate(useragent)

    以 named tuple `RequestRate(requests, seconds)` 的形式從 `robots.txt` 回傳 `Request-rate` 參數的內容。如果此參數不存在、不適用於指定的 useragent ，或是此參數在 `robots.txt` 中所指的條目含有無效語法，則回傳 `None`。

    在 3.6 版新加入.

  site_maps()

    以 `list()` 的形式從 `robots.txt` 回傳 `Sitemap` 參數的內容。如果此參數不存在或此參數在 `robots.txt` 中所指的條目含有無效語法，則回傳 `None`。

    在 3.8 版新加入.

下面的範例展示了 `RobotFileParser` 類別的基本用法：

    >>> import urllib.robotparser
    >>> rp = urllib.robotparser.RobotFileParser()
    >>> rp.set_url("http://www.musi-cal.com/robots.txt")
    >>> rp.read()
    >>> rrate = rp.request_rate("*")
    >>> rrate.requests
    3
    >>> rrate.seconds
    20
    >>> rp.crawl_delay("*")
    6
    >>> rp.can_fetch("*", "http://www.musi-cal.com/cgi-bin/search?city=San+Francisco")
    False
    >>> rp.can_fetch("*", "http://www.musi-cal.com/")
    True