Skip to main content

Parser and validator for language codes (bcp47). Also exposes the IANA language code database

Project description

Build Status codecov


A validating parser for bcp47 language codes

Data taken from IANA

bcp47 spec

useful reading:

extension and private-use tag types are not currently supported

Python example

You can read the languages, extlangs, scripts, variants, regions, grandfathereds, and redundants language tag parts from dicts on the bcp47 object.

They return OrderedDicts containing the IANA database information

>>> from bcp47 import bcp47

>>> list(bcp47["languages"].items())[:2]
[('aa', {'Subtag': 'aa', 'Description': ['Afar'], 'Added': '2005-10-16'}), ('ab', {'Subtag': 'ab', 'Description': ['Abkhazian'], 'Added': '2005-10-16', 'Suppress-Script': 'Cyrl'})]

>>>  list(bcp47["regions"].items())[:2]
[('AA', {'Subtag': 'AA', 'Description': ['Private use'], 'Added': '2005-10-16'}), ('AC', {'Subtag': 'AC', 'Description': ['Ascension Island'], 'Added': '2009-07-29'})]

You can create a language code tag as follows

>>> tag = bcp47(language="en", region="GB")
>>> tag
<bcp47.code.BCP47Code 'en-GB' />

>>> tag.language
>>> tag.region
>>> str(tag)

You can also pass a string or list of args to create a tag

>>> bcp47("en-GB")
<bcp47.code.BCP47Code 'en-GB' />

>>> bcp47("en", "GB")
<bcp47.code.BCP47Code 'en-GB' />

Creating a tag with invalid or unrecognized parameters raises an BCP47Exception

>>> tag = bcp47(language="NOTALANGUAGE", region="GB")
Traceback (most recent call last):
BCP47Exception: Language 'NOTALANGUAGE' not recognized

>>> tag = bcp47("en-NOTAREGION")
Traceback (most recent call last):
BCP47Exception: Unrecognized tag part 'NOTAREGION'

Project details

Download files

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

Files for python-bcp47, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size python_bcp47-0.0.4-py3-none-any.whl (107.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size python-bcp47-0.0.4.tar.gz (103.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page