Skip to main content

Extracts the top level domain (TLD) from the URL given.

Project description

Extracts the top level domain (TLD) from the URL given. List of TLD names is taken from Mozilla.

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:

$ pip install tld

Latest development version:

$ pip install -e hg+http://bitbucket.org/barseghyanartur/tld#egg=tld

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:

$ update-tld-names

or simply do:

from tld.utils import update_tld_names
update_tld_names()

Troubleshooting

If somehow domain names listed here are not recognised, make sure you have the most recent version of TLD names in your virtual environment:

$ 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>

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tld-0.7.5.tar.gz (141.9 kB view hashes)

Uploaded Source

Built Distribution

tld-0.7.5-py2.py3-none-any.whl (147.7 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page