275 lines
6.4 KiB
Plaintext
275 lines
6.4 KiB
Plaintext
Metadata-Version: 2.1
|
|
Name: iso3166
|
|
Version: 2.1.1
|
|
Summary: Self-contained ISO 3166-1 country definitions.
|
|
Home-page: http://github.com/deactivated/python-iso3166
|
|
Author: Mike Spindel
|
|
Author-email: mike@spindel.is
|
|
License: MIT
|
|
Keywords: iso 3166-1,country codes
|
|
Platform: UNKNOWN
|
|
Classifier: Development Status :: 5 - Production/Stable
|
|
Classifier: License :: OSI Approved :: MIT License
|
|
Classifier: Intended Audience :: Developers
|
|
Classifier: Natural Language :: English
|
|
Classifier: Programming Language :: Python
|
|
Classifier: Programming Language :: Python :: 3
|
|
Classifier: Programming Language :: Python :: 3 :: Only
|
|
Classifier: Programming Language :: Python :: 3.6
|
|
Classifier: Programming Language :: Python :: 3.7
|
|
Classifier: Programming Language :: Python :: 3.8
|
|
Classifier: Programming Language :: Python :: 3.9
|
|
Classifier: Programming Language :: Python :: 3.10
|
|
Classifier: Programming Language :: Python :: 3.11
|
|
Requires-Python: >=3.6
|
|
Description-Content-Type: text/x-rst; charset=UTF-8
|
|
License-File: LICENSE.txt
|
|
|
|
============================================================
|
|
python-iso3166 - Standalone ISO 3166-1 country definitions
|
|
============================================================
|
|
|
|
:Authors:
|
|
Mike Spindel
|
|
:Version: 2.1.1
|
|
|
|
|
|
ISO 3166-1 defines two-letter, three-letter, and three-digit country
|
|
codes. `python-iso3166` is a self-contained module that converts
|
|
between these codes and the corresponding country name.
|
|
|
|
|
|
Installation
|
|
============
|
|
|
|
::
|
|
|
|
$ pip install iso3166
|
|
|
|
|
|
Usage
|
|
=====
|
|
|
|
Country details
|
|
---------------
|
|
|
|
::
|
|
|
|
>>> from iso3166 import countries
|
|
>>>
|
|
>>> countries.get('us')
|
|
Country(name='United States', alpha2='US', alpha3='USA', numeric='840')
|
|
>>> countries.get('ala')
|
|
Country(name='Åland Islands', alpha2='AX', alpha3='ALA', numeric='248')
|
|
>>> countries.get(8)
|
|
Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008')
|
|
|
|
|
|
Country lists and indexes
|
|
-------------------------
|
|
|
|
::
|
|
|
|
>>> from iso3166 import countries
|
|
|
|
>>> for c in countries:
|
|
print(c)
|
|
>>> Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004')
|
|
Country(name='Åland Islands', alpha2='AX', alpha3='ALA', numeric='248')
|
|
Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008')
|
|
Country(name='Algeria', alpha2='DZ', alpha3='DZA', numeric='012')
|
|
|
|
::
|
|
|
|
>>> import iso3166
|
|
|
|
>>> iso3166.countries_by_name
|
|
>>> {'AFGHANISTAN': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'),
|
|
'ALBANIA': Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008'),
|
|
'ALGERIA': Country(name='Algeria', alpha2='DZ', alpha3='DZA', numeric='012'),
|
|
...
|
|
|
|
>>> iso3166.countries_by_numeric
|
|
>>> {'004': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'),
|
|
'008': Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008'),
|
|
'010': Country(name='Antarctica', alpha2='AQ', alpha3='ATA', numeric='010'),
|
|
...
|
|
|
|
>>> iso3166.countries_by_alpha2
|
|
>>> {'AD': Country(name='Andorra', alpha2='AD', alpha3='AND', numeric='020'),
|
|
'AE': Country(name='United Arab Emirates', alpha2='AE', alpha3='ARE', numeric='784'),
|
|
'AF': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'),
|
|
...
|
|
|
|
>>> iso3166.countries_by_alpha3
|
|
>>> {'ABW': Country(name='Aruba', alpha2='AW', alpha3='ABW', numeric='533'),
|
|
'AFG': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'),
|
|
'AGO': Country(name='Angola', alpha2='AO', alpha3='AGO', numeric='024'),
|
|
...
|
|
|
|
Changes
|
|
=======
|
|
|
|
2.1.1 - July 11, 2022
|
|
---------------------
|
|
|
|
* Move install metadata from ``setup.py`` to ``setup.cfg``
|
|
* Add py.typed to source distribution
|
|
|
|
2.1.0 - July 11, 2022
|
|
---------------------
|
|
|
|
* Updated entries
|
|
|
|
- "Turkey" changed to "Türkiye"
|
|
|
|
2.0.2 - Sep 20, 2021
|
|
--------------------
|
|
|
|
* Add the ``py.typed`` marker file in accordance with PEP 561
|
|
|
|
2.0.1 - Sep 14, 2021
|
|
--------------------
|
|
|
|
* Add ``python_requires`` to ``setup.py``
|
|
|
|
2.0.0 - Sep 14, 2021
|
|
--------------------
|
|
|
|
* Add type hints throughout codebase (thanks blokje!)
|
|
|
|
* Drop support for Python versions prior to 3.6
|
|
|
|
1.0.1 - Dec 13, 2019
|
|
--------------------
|
|
|
|
* Include test files in source distribution (thanks pmosetc!)
|
|
|
|
* Added all Python 3 versions to tox.ini and supported list
|
|
|
|
1.0 - March 19, 2018
|
|
--------------------
|
|
|
|
* Updated entries
|
|
|
|
- "Macedonia, the former Yugoslav Republic of" changed to "North
|
|
Macedonia" (effective 2019-03-13)
|
|
|
|
- Added numeric code 983 for Kosovo to mirror usage by the National
|
|
Statistical Office of Canada (thanks betaboon!)
|
|
|
|
0.9 - July 21, 2018
|
|
-------------------
|
|
|
|
* Updated entries
|
|
|
|
- New entry for Kosovo (XK / XKX)
|
|
|
|
- Swaziland changed to Eswatini (effective 2018-07-16)
|
|
|
|
0.8 - February 5, 2017
|
|
-----------------------
|
|
|
|
* Updated entries
|
|
|
|
- Czechia (changed 2016-09)
|
|
|
|
- United Kingdom of Great Britain and Northern Ireland (changed
|
|
2014-12)
|
|
|
|
0.7 - February 13, 2015
|
|
-----------------------
|
|
|
|
* Added new attribute ``apolitical_name`` to Country. This field
|
|
reflects the ISO short name but has unnecessarily inflammatory
|
|
modifiers removed.
|
|
|
|
Specifically: "Taiwan, Province of China" maps to "Taiwan" and
|
|
"Palestine, State of" maps to "Palestine."
|
|
|
|
* Updated entries
|
|
|
|
- Holy See (changed in 2014-12)
|
|
|
|
* CountryLookup now raises KeyError when passed an unknown integer
|
|
rather than AttributeError. (thanks unsignedint!)
|
|
|
|
0.6 - September 28, 2014
|
|
------------------------
|
|
|
|
* Updated entries
|
|
- Cabo Verde (changed in 2013-11)
|
|
|
|
* Documented the dictionaries used for looking up countries by alpha2,
|
|
etc. (thanks brunetton!)
|
|
|
|
0.5 - February 13, 2014
|
|
-----------------------
|
|
|
|
* Added ``__contains__`` to CountryLookup (thanks tomako!)
|
|
|
|
* Current through ISO newsletter VI-16
|
|
- No changes needed
|
|
|
|
0.4 - February 14, 2013
|
|
-----------------------
|
|
|
|
* Current through ISO newsletter VI-14
|
|
|
|
* Updated entries
|
|
- Palestine
|
|
|
|
0.3 - September 4, 2012
|
|
-----------------------
|
|
|
|
* Current through ISO newsletter VI-13
|
|
|
|
* Fix changes from 0.2 (thanks vincentfretin!):
|
|
|
|
- Venezuela
|
|
|
|
- Saint Helena
|
|
|
|
- Bolivia
|
|
|
|
0.2 - March 26, 2012
|
|
--------------------
|
|
|
|
* Current through ISO newsletter VI-12
|
|
|
|
* Added missing entry for Afghanistan
|
|
|
|
* Updated entries
|
|
|
|
- Bolivia (ISO Newsletter VI-6)
|
|
|
|
- Libya (VI-11)
|
|
|
|
- Saint Helena (VI-7)
|
|
|
|
- Sudan (VI-10)
|
|
|
|
- Venezuela (VI-5)
|
|
|
|
* New entries:
|
|
|
|
- Bonaire, Sint Eustatius and Saba (VI-8)
|
|
|
|
- Curaçao (VI-8)
|
|
|
|
- Sint Maarten (Dutch part) (VI-8)
|
|
|
|
- South Sudan (VI-10)
|
|
|
|
* Deleted entries:
|
|
|
|
- Netherlands Antilles (VI-8)
|
|
|
|
|
|
0.1 - December 14, 2010
|
|
-----------------------
|
|
|
|
* Initial release
|
|
|
|
|