yv-languages 1.1.0

Languages package for YouVersion usage.

yv-languages

Requirements

This project recommends Python 3.11 or higher.

Installation

pip install yv-languages

Usage

You can make any language tag string canonical like:

import yv_languages

bcp = yv_languages.canonical("eng")

print(str(bcp))  # "en"

or with validation:

import yv_languages

bcp = yv_languages.canonical("eng", should_validate=True)

print(str(bcp))  # "en"

You can also maximize a language tag using langcodes' likely subtags:

import yv_languages

bcp = yv_languages.maximize("zh")

print(str(bcp))  # "zh-Hans-CN"

Development

This project is tested with Python 3.13.

Running tests

pytest tests/

Before committing any code

We have a pre-commit hook which should be setup. You can symlink it to run before each commit by changing directory to the repo and running

make githooks