urllib.robotparser — Parser for robots.txt¶
소스 코드: Lib/urllib/robotparser.py
This module provides a single class, RobotFileParser, which answers
questions about whether or not a particular user agent can fetch a URL on the
web site that published the robots.txt file. For more details on the
structure of robots.txt files, see http://www.robotstxt.org/orig.html.
- class urllib.robotparser.RobotFileParser(url='')¶
이 클래스는 url에 있는
robots.txt파일을 읽고, 구문 분석하고, 그에 대한 질문에 대답하는 메서드를 제공합니다.- set_url(url)¶
robots.txt파일을 가리키는 URL을 설정합니다.
- read()¶
robots.txtURL을 읽어서 구문 분석기에 넘깁니다.
- parse(lines)¶
lines 인자를 구문 분석합니다.
- can_fetch(useragent, url)¶
구문 분석된
robots.txt파일에 포함된 규칙에 따라, useragent가 url를 가져올 수 있으면True를 반환합니다.
- mtime()¶
robots.txt파일을 마지막으로 가져온 시간을 반환합니다. 이것은 새robots.txt파일을 주기적으로 확인해야 하는 장기 실행 웹 스파이더에 유용합니다.
- modified()¶
robots.txt파일을 마지막으로 가져온 시간을 현재 시각으로 설정합니다.
- crawl_delay(useragent)¶
robots.txt에서 해당 useragent에 대한Crawl-delay파라미터의 값을 반환합니다. 해당 파라미터가 없거나, 지정된 useragent에 적용되지 않거나, 이 파라미터에 대한robots.txt항목이 잘못된 구문이면None을 반환합니다.Added in version 3.6.
다음 예제는 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