Source

tld /

Filename Size Date modified Message
docs
src/tld
193 B
143 B
1.7 KB
1.1 KB
566 B
17.2 KB
25.3 KB
33 B
1.9 KB
717 B
197 B
24 B
203 B
33 B
17 B
1.5 KB
68 B
56 B
293 B
87 B

tld

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).

Installation

Latest stable version on PyPI:

Latest development version:

Usage example

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

If you wish, you could get the result as an object:

from tld import get_tld
res = get_tld("http://some.subdomain.google.co.uk", as_object=True)
print res
# 'google.co.uk'

print res.subdomain
# 'some.subdomain'

print res.domain
# 'google'

print res.suffix
# 'co.uk'

print res.tld
# 'google.co.uk'

To update/sync the tld names with the most recent version run the following from your terminal:

or simply do:

from tld.utils import update_tld_names
update_tld_names()

License

MPL 1.1/GPL 2.0/LGPL 2.1

Support

For any issues contact me at the e-mail given in the Author section.

Author

Artur Barseghyan <artur.barseghyan@gmail.com>