Panlingo.LanguageCode
0.1.2
dotnet add package Panlingo.LanguageCode --version 0.1.2
NuGet\Install-Package Panlingo.LanguageCode -Version 0.1.2
<PackageReference Include="Panlingo.LanguageCode" Version="0.1.2" />
paket add Panlingo.LanguageCode --version 0.1.2
#r "nuget: Panlingo.LanguageCode, 0.1.2"
// Install Panlingo.LanguageCode as a Cake Addin #addin nuget:?package=Panlingo.LanguageCode&version=0.1.2 // Install Panlingo.LanguageCode as a Cake Tool #tool nuget:?package=Panlingo.LanguageCode&version=0.1.2
Panlingo.LanguageCode
Panlingo.LanguageCode is a comprehensive .NET library designed for managing and converting language codes using various normalization and conversion rules. The library supports multiple language code entities, including two-letter ISO codes, three-letter ISO codes, and English names.
What are Language Codes?
Language codes are standardized codes used to identify languages. The ISO 639 standard defines sets of codes for the representation of names of languages. There are several parts to the ISO 639 standard:
- ISO 639-1: Defines two-letter codes (e.g., "en" for English, "uz" for Uzbek); more.
- ISO 639-2: Defines three-letter codes (e.g., "eng" for English, "uzb" for Uzbek); more.
- ISO 639-3: Extends the code set to cover all known languages and their macrolanguages (e.g., "zho" is macrolanguage of "cmn"); more.
These codes are essential in various applications, including software localization, data exchange between systems, and linguistic research.
Features
- Convert language codes to their normalized forms.
- Resolve both two-letter and three-letter ISO codes.
- Handle deprecated and legacy language codes.
- Reduce specific language codes to their macrolanguage equivalents.
- Retrieve English names for language codes.
- Handle IETF language tags.
- Normalize inputs by converting to lowercase and trimming spaces.
Installation
To install the Panlingo.LanguageCode library, you can use the .NET CLI:
dotnet add package Panlingo.LanguageCode
Usage
Language Code Resolver
You can use the library to convert and resolve language codes. Below are some examples to illustrate how to use the provided functionalities.
Basic Configuration
Before using the library, set up a basic resolver with your desired rules.
Resolver is called LanguageCodeResolver
and uses Fluent Builder design pattern:
var resolver = new LanguageCodeResolver()
.ToLowerAndTrim() // optional
.ConvertFromIETF() // optional
.ConvertFromDeprecatedCode() // optional
.ReduceToMacrolanguage(); // optional
ISO 639-1 to ISO 639-2 or ISO 639-3
In this code, we see how to convert a language code from the ISO 639-1 format (which uses two-letter codes) to the ISO 639-2 or ISO 639-3 format (which uses three-letter codes). Here’s the breakdown:
var options = new LanguageCodeResolver()
.Select(LanguageCodeEntity.Alpha3);
string result = LanguageCodeHelper.Resolve("uk", options);
// result => "ukr"
Resolve Language Code to it's English Name
This code demonstrates how to resolve a given language code to its corresponding English name using similar resolver configuration techniques:
var options = new LanguageCodeResolver()
.Select(LanguageCodeEntity.EnglishName);
string result = LanguageCodeHelper.Resolve("uk", options);
// result => "Ukrainian"
Resolve Dialect Language to it's Macrolanguage
The resolver is used to map a dialect language code to its corresponding macrolanguage code, then convert it to the Alpha-3 format:
var options = new LanguageCodeResolver()
.ReduceToMacrolanguage()
.Select(LanguageCodeEntity.Alpha3);
string result = LanguageCodeHelper.Resolve("cmn", options);
// result => "zho"
Handle Legacy Codes with Conflicts
For resolving legacy codes that may have conflicts, you can specify how to handle such conflicts:
var options = new LanguageCodeResolver()
.ConvertFromDeprecatedCode((sourceCode, candidates) =>
{
return candidates.Any() ? candidates.First() : sourceCode;
})
.Select(LanguageCodeEntity.Alpha3);
string result = LanguageCodeHelper.Resolve("mof", options);
// result => "xpq"
Handle IETF Language Tags
You can resolve language codes from IETF language tags like "en-US":
var options = new LanguageCodeResolver().ConvertFromIETF();
string result = LanguageCodeHelper.Resolve("en-US", options);
// result => "en"
Normalize Input by Converting to Lowercase and Trimming Spaces
You can normalize inputs by converting to lowercase and trimming spaces:
var options = new LanguageCodeResolver().ToLowerAndTrim();
string result = LanguageCodeHelper.Resolve(" UK ", options);
// result => "uk"
Basic Methods
You can use these methods without any resolver configuration.
Convert a Single Language Code
You can convert a single language code to its two-letter or three-letter ISO equivalent:
string result = LanguageCodeHelper.GetTwoLetterISOCode("rus");
// result => "ru"
string result = LanguageCodeHelper.GetThreeLetterISOCode("en");
// result => "eng"
Retrieve English Names for Language Codes
You can also get the English names for language codes:
string result = LanguageCodeHelper.GetLanguageEnglishName("uk");
// result => "Ukrainian"
Resolve Language Codes with Options
You can resolve language codes using specific options, such as converting deprecated codes or reducing to macrolanguages:
string result = LanguageCodeHelper.Resolve("iw", resolver);
// result => "heb"
Sources
Contributing
Contributions and feedback are welcome! Feel free to submit issues, fork the repository, and send pull requests.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.1 is compatible. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.1
- No dependencies.
-
net5.0
- No dependencies.
-
net6.0
- No dependencies.
-
net7.0
- No dependencies.
-
net8.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
0.1.2 | 72 | 10/23/2024 |
0.1.1 | 74 | 10/22/2024 |
0.0.0.23 | 75 | 10/7/2024 |
0.0.0.22 | 83 | 9/22/2024 |
0.0.0.21 | 125 | 9/10/2024 |
0.0.0.20 | 101 | 9/8/2024 |
0.0.0.19 | 104 | 9/1/2024 |
0.0.0.18 | 107 | 8/26/2024 |
0.0.0.17 | 129 | 8/21/2024 |
0.0.0.16 | 115 | 8/9/2024 |
0.0.0.15 | 129 | 8/8/2024 |
0.0.0.14 | 78 | 8/3/2024 |
0.0.0.13 | 93 | 8/1/2024 |
0.0.0.12 | 89 | 8/1/2024 |
0.1.2:
- "bh" is deprecated
0.0.0.1:
- Initial release