Extract publication dates from web pages
A library to extract a publication date from a web page, along with a measure of the accuracy. This was produced as a part of the mediacloud project, in order to accurately extract dates from content.
The library is available on PyPI, and may be installed with
pip install date_guesser
The date guesser uses both the url and the html to work, and uses some heuristics to decide which of many possible dates might be the best one.
from date_guesser import guess_date, Accuracy # Uses url slugs when available guess = guess_date(url='https://www.nytimes.com/2017/10/13/some_news.html', html='<could be anything></could>') # Returns a Guess object with three properties guess.date # datetime.datetime(2017, 10, 13, 0, 0, tzinfo=<UTC>) guess.accuracy # Accuracy.DATE guess.method # 'Found /2017/10/13/ in url'
In case there are two trustworthy sources of dates,
date_guesser prefers the more accurate one
html = ''' <html><head> <meta property="article:published" itemprop="datePublished" content="2017-10-13T04:56:54-04:00" /> </head></html>''' guess = guess_date(url='https://www.nytimes.com/2017/10/some_news.html', html=html) guess.date # datetime.datetime(2017, 10, 13, 4, 56, 54, tzinfo=tzoffset(None, -14400)) guess.accuracy is Accuracy.DATETIME # True
date_guesser is not led astray by more accurate, less trustworthy sources of information
html = ''' <html><head> <meta property="og:image" content="foo.com/2016/7/4/whatever.jpg"/> </head></html>''' guess = guess_date(url='https://www.nytimes.com/2017/10/some_news.html', html=html) guess.date # datetime.datetime(2017, 10, 15, 0, 0, tzinfo=<UTC>) guess.accuracy is Accuracy.PARTIAL # True
The code does quite poorly on foreign news sources. This page is Ukranian and has a date on it that a non-Ukranian could identify, but it is not extracted:
import requests guess = guess_date(url='https://www.dw.com/uk/коментар-націоналізм-родом-зі-східної-європи/a-42081385', html=requests.get(url).text) guess.date # None guess.accuracy is Accuracy.NONE # True guess.method == 'Did not find anything' # True
We keep track of the accuracy of extracted dates, but we do not keep track of the confidence of extracted
dates being accurate. This may be a way to do more tuning given a particular use case. For example, one
strategy we do not employ is a regex for all the date patterns we recognize, since that was far too
error-prone. Such an approach might be preferable to returning
None in certain cases.
We benchmarked the accuracy against the wonderful
newspaper library, using one hundred urls gathered from each of four very different topics in the
mediacloud system. This includes blogs and news articles, as well as many urls that have no date (in which case a guess is marked correct only if it returns
Aadhar Card in India
Donald Trump in 2017
Recipes for desserts and chocolate
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash SHA256 hash help||File type||Python version||Upload date|
|date_guesser-2.1.1-py3-none-any.whl (12.3 kB) Copy SHA256 hash SHA256||Wheel||py3|
|date_guesser-2.1.1.tar.gz (12.2 kB) Copy SHA256 hash SHA256||Source||None|