Skip to main content

iso639-lang

iso639-lang is a simple library to handle the ISO 639 series of international standards for language codes.

>>> from iso639 import Lang
>>> Lang("fr")
Lang(name='French', pt1='fr', pt2b='fre', pt2t='fra', pt3='fra', pt5='')

iso639-lang allows you to switch from one language code to another easily. There’s no need to manually download or parse data files, just use the Lang class!

ISO 639-1, ISO 639-2, ISO 639-3 and ISO 639-5 parts are all supported.

Installing iso639-lang and Supported Versions

iso639-lang is available on PyPI:

$ pip install iso639-lang

iso639-lang supports Python 3.6+.

Usage

Handling language codes with iso639-lang is very simple.

Begin by importing the Lang class:

>>> from iso639 import Lang

Lang is instantiable with any ISO 639 language code or name. For example, let’s try to get the ISO 639 codes for French:

>>> lg = Lang("French")
>>> lg.name
'French'
>>> lg.pt1
'fr'
>>> lg.pt2b
'fre'
>>> lg.pt2t
'fra'
>>> lg.pt3
'fra'
>>> lg.pt5
''

An instance of Lang can be modified.

>>> lg.pt1 = 'de'
>>> lg.name
'German'

Lang instances are comparable to each other.

>>> other_lg = Lang("deu")
>>> lg == other_lg
True

Data included in iso639-lang

iso639-lang is based on the official code tables provided by the ISO 639 registration authorities.

Standard Name Registration Authority First edition Current
ISO 639-1 Part 1: Alpha-2 code Infoterm 1967 2002
ISO 639-2 Part 2: Alpha-3 code Library of Congress 1998 1998
ISO 639-3 Part 3: Alpha-3 code for comprehensive coverage of languages SIL International 2007 2007
ISO 639-4 Part 4: Implementation guidelines and general principles for language coding (not a list) ISO/TC 37/SC 2 2010 2010
ISO 639-5 Part 5: Alpha-3 code for language families and groups Library of Congress 2008 2013
ISO 639-6 Part 6: Alpha-4 representation for comprehensive coverage of language variants Geolang 2009 withdrawn

Download files

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

Source Distribution

iso639-lang-0.1.1.tar.gz (81.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iso639_lang-0.1.1-py3-none-any.whl (82.2 kB view details)

Uploaded Python 3

File details

Details for the file iso639-lang-0.1.1.tar.gz.

File metadata

  • Download URL: iso639-lang-0.1.1.tar.gz
  • Upload date:
  • Size: 81.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.10.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.4

File hashes

Hashes for iso639-lang-0.1.1.tar.gz
Algorithm Hash digest
SHA256 82e871c9463464538e46b394eaf30d74016e815244c1e40244a854583e5d287d
MD5 8998b329669c4ca1206ba9ce661ac6e3
BLAKE2b-256 72165884a18809f9a803c322a30db6042cc3f729da9dde41ffa86c874e132a72

See more details on using hashes here.

File details

Details for the file iso639_lang-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: iso639_lang-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 82.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.10.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.4

File hashes

Hashes for iso639_lang-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f80690a80fcbaa098cb8dc1c848bfd212538e56e286b0bbc64651545f7c49f9a
MD5 0caa123eddb1c7617fef4cf72603787d
BLAKE2b-256 de721bcbfe30305dc453fec2ca6fee53aff09b9df36fe14d0865e0ee841bfea0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page