world – Print mappings between country names and DNS country codes

This package provides a mapping between top-level domain names and their two letter ISO 3166 country codes. This script also knows about non-geographic, generic, USA-centric, historical, common usage, and reserved top-level domains.

Both a command line script called world and a library called worldlib are available. The latter can be imported into your Python code for whatever application you want.


At a minimum, Python 3.4 is required. Python 2 is no longer supported for the library API.


A simple guide to using the library is available within this package. The manual is also available online. A manpage provides information on how to use the world command line script.


world and worldlib is Copyright (C) 2013-2016 Barry Warsaw <>

Licensed under the terms of the GNU General Public License, version 3 or later. See the LICENSE.txt file for details.