tld · PyPI

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>

Release files for tld 0.7.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tld 0.7.6
File	Size	Uploaded
tld-0.7.6.tar.gz	141.9 kB	Jan 23, 2016	Details

Built distribution (wheel)

Table of built distributions (wheels) for tld 0.7.6
File	Interpreter	ABI	Platform	Reset
tld-0.7.6-py2.py3-none-any.whl 147.7 kB Jan 23, 2016	Python 2, Python 3	none	any	Details

Total release size: 289.6 kB

Release files / tld-0.7.6.tar.gz

Download URL	tld-0.7.6.tar.gz
Size	141.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`0d272d62a2f082a22fba04c260d0ade10117bca457a71c426081be9caf68c07a`
BLAKE2b-256 checksum How to use checksums	`0948a4210c9284771f5342a107ebc61bfd2e5b51ea1c6415a20efbdc72fd477d`
Upload date	Jan 23, 2016
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / tld-0.7.6-py2.py3-none-any.whl

Download URL	tld-0.7.6-py2.py3-none-any.whl
Size	147.7 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`f97b7b57cfd016cad22dea25bba6a88d2fd8d3676d27dbdafa36f1634e77d0c2`
BLAKE2b-256 checksum How to use checksums	`7244210733bd22280b9db12ff143961c8187cfeb0d67d1ef4ec178530307be75`
Upload date	Jan 23, 2016
Uploaded using Trusted Publishing? What is trusted publishing?	No