Python library for ISO 639 standard
Project description
Status
License
GNU Affero General Public License version 3 (AGPLv3)
Supports
ISO 639-1
ISO 639-2
ISO 639-3
ISO 639-5
Breaking changes
0.4.4: retired has been changed to { ‘code’: (datetime, [_Language, …], ‘description’) }.
0.4.0: alpha3 has been renamed to part3. languages.alpha3 might be used as an aggregation of all ‘three letter codes’ in the future.
Compatibility
This library is aimed to be fully compatible with pycountry.languages v1.11 and before. In v1.12 they broke their own API and this library will not support the new API.
It provides the following attribute abstractions:
terminology -> part2t
bibliographic -> part2b
alpha2 -> part1
If you have no intentions on using pycountry.languages or want/need to keep compatibility then please use the partX attributes for brevity and clarity.
Usage
As taken from pycountry.languages v1.11 documentation, with modifications and further additions.
>>> from iso639 import languages
>>> from pprint import pprint
>>> len(languages)
7981
>>> type(list(languages)[0])
<class 'iso639.iso639._Language'>
# Compatibility
>>> aragonese = languages.get(alpha2='an')
>>> aragonese.alpha2
'an'
>>> aragonese.bibliographic
'arg'
>>> aragonese.terminology
'arg'
>>> aragonese.name
'Aragonese'
>>> bengali = languages.get(alpha2='bn')
>>> bengali.name
'Bengali'
# We *do not* deviate from the standard
>>> try:
... bengali.common_name
... except AttributeError as e:
... print(e)
'_Language' object has no attribute 'common_name'
# New API
>>> aragonese = languages.get(part1='an')
>>> aragonese.part1
'an'
>>> aragonese.part2b
'arg'
>>> aragonese.part2t
'arg'
>>> aragonese.part3
'arg'
>>> aragonese.name
'Aragonese'
>>> aragonese.inverted
'Aragonese'
>>> pprint(vars(aragonese))
{'inverted': 'Aragonese',
'macro': '',
'name': 'Aragonese',
'names': [],
'part1': 'an',
'part2b': 'arg',
'part2t': 'arg',
'part3': 'arg',
'part5': ''}
>>> sanapana = languages.get(retired='sap')
>>> [type(elem).__name__ for elem in sanapana]
['datetime', 'list', 'str']
>>> [lang.part3 for lang in sanapana[1]]
['spn', 'aqt']
Contains external data
ISO 639-1, on 2014-11-28
ISO 639-2, on 2014-11-28
ISO 639-3 Code Set, dated 2015-05-05
ISO 639-3 Language Names Index, dated 2015-05-05
ISO 639-3 Macrolanguage Mappings, dated 2015-05-05
ISO 639-3 Retired Code Element Mappings, dated 2015-05-05
ISO 639-5, dated 2011-05-12
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.