Skip to main content

Python library for ISO 639 standard

Project description

Status

master development downloads/month latest version gh forks gh stars

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iso-639-0.4.5.tar.gz (167.4 kB view details)

Uploaded Source

File details

Details for the file iso-639-0.4.5.tar.gz.

File metadata

  • Download URL: iso-639-0.4.5.tar.gz
  • Upload date:
  • Size: 167.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for iso-639-0.4.5.tar.gz
Algorithm Hash digest
SHA256 dc9cd4b880b898d774c47fe9775167404af8a85dd889d58f9008035109acce49
MD5 cc282daf57f57061a9309f2567bff052
BLAKE2b-256 5a8d27969852f4e664525c3d070e44b2b719bc195f4d18c311c52e57bb93614e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page