Extracts the top level domain (TLD) from the URL given. List of TLD names is taken from Mozilla http://mxr.mozilla.org/mozilla/source/netwerk/dns/src/effective_tld_names.dat?raw=1
Optionally raises exceptions on non-existing TLDs or silently fails (if fail_silently argument is set to True). Knows about active and inactive TLDs. If only active TLDs shall be matched against, active_only argument shall be set to True (default - False).
Latest stable version on PyPI:
$ pip install tld
Latest development version:
$ pip install -e hg+http://bitbucket.org/barseghyanartur/tld#egg=tld
To get the top level domain name from the URL given:
>>> from tld import get_tld
>>> print get_tld("http://www.google.co.uk")
'google.co.uk'
>>> print get_tld("http://www.google.idontexist", fail_silently=True)
None
To update/sync the tld names with the most recent version run the following from your terminal:
$ python tld/update.py
or simply do:
>>> from tld.utils import update_tld_names >>> update_tld_names()
Updates the local copy of TLDs file.
Parameters: | fail_silently (bool) – If set to True, no exceptions is raised on failure but boolean False returned. |
---|---|
Return bool: | True on success, False on failure. |
Extracts the top level domain based on the mozilla’s effective TLD names dat file. Returns a string. May throw TldBadUrl or TldDomainNotFound exceptions if there’s bad URL provided or no TLD match found respectively.
Parameters: |
|
---|---|
Returns: | String with top level domain or None on failure. |