Extract the top level domain (TLD) from the URL given.
Project description
Extract 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).
Prerequisites
Python 2.7, 3.4, 3.5, 3.6, 3.7 and PyPy
Documentation
Documentation is available on Read the Docs.
Installation
Latest stable version on PyPI:
pip install tldOr latest stable version from GitHub:
pip install https://github.com/barseghyanartur/tld/archive/stable.tar.gzOr latest stable version from BitBucket:
pip install https://bitbucket.org/barseghyanartur/tld/get/stable.tar.gzUsage examples
In addition to examples below, see the jupyter notebook workbook file.
Get the TLD name as string from the URL given
from tld import get_tld
get_tld("http://www.google.co.uk")
# 'co.uk'
get_tld("http://www.google.idontexist", fail_silently=True)
# NoneGet the TLD as an object
from tld import get_tld
res = get_tld("http://some.subdomain.google.co.uk", as_object=True)
res
# 'co.uk'
res.subdomain
# 'some.subdomain'
res.domain
# 'google'
res.tld
# 'co.uk'
res.fld
# 'google.co.uk'
res.parsed_url
# SplitResult(
# scheme='http',
# netloc='some.subdomain.google.co.uk',
# path='',
# query='',
# fragment=''
# )Get TLD name, ignoring the missing protocol
from tld import get_tld, get_fld
get_tld("www.google.co.uk", fix_protocol=True)
# 'co.uk'
get_fld("www.google.co.uk", fix_protocol=True)
# 'google.co.uk'Return TLD parts as tuple
from tld import parse_tld
parse_tld('http://www.google.com')
# 'com', 'google', 'www'Get the first level domain name as string from the URL given
from tld import get_fld
get_fld("http://www.google.co.uk")
# 'google.co.uk'
get_fld("http://www.google.idontexist", fail_silently=True)
# NoneUpdate the list of TLD names
To update/sync the tld names with the most recent version run the following from your terminal:
update-tld-namesOr 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-namesTesting
Simply type:
./runtests.pyOr use tox:
toxOr use tox to check specific env:
tox -e py36Writing documentation
Keep the following hierarchy.
=====
title
=====
header
======
sub-header
----------
sub-sub-header
~~~~~~~~~~~~~~
sub-sub-sub-header
^^^^^^^^^^^^^^^^^^
sub-sub-sub-sub-header
++++++++++++++++++++++
sub-sub-sub-sub-sub-header
**************************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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
