CldrSharp.Units

Ez a NuGet csomag a Unicode CLDR mértékegység-adatait biztosítja lokalizált formában .NET alkalmazások számára.

Fő jellemzők

• Lokalizált mértékegységek betöltése JSON-ból (hu, en támogatott)
• Könnyű integráció ASP.NET Core DI rendszerbe
• Strukturált kategória és egységmodell

Használat

1. Telepítsd a NuGet csomagot:

Install-Package CldrSharp.Units

2. Regisztráld a szolgáltatást:

builder.Services.AddLocalizedUnits();

3. Használat:

public class UnitsController : ControllerBase
{
    private readonly IUnitsService _units;

    public UnitsController(IUnitsService units)
    {
        _units = units;
    }

    [HttpGet("units/{locale}")]
    public IActionResult Get(string locale)
    {
        var data = _units.GetAllCategories(locale);
        return Ok(data);
    }
}

Kimeneti modell

[
  {
    "id": "mass",
    "name": "Tömeg",
    "units": [
      {
        "id": "kilogram",
        "name": "kilogramm",
        "symbol": "kg"
      }
    ]
  }
]

Támogatott nyelvek

• hu – magyar
• en – angol (amerikai)

Verzió és forrás

Ez a csomag a CLDR v47.0.0 adatain alapul, amely a cldr-units-full csomag része.

• CLDR verzió: 47.0.0
• Unicode verzió: 16.0.0
• Licenc: Unicode Data Files and Software License (Unicode-3.0)
• Forrás: https://github.com/unicode-org/cldr-json

Licence

Az adatok a Unicode CLDR projektből származnak – Unicode Data Files and Software License.

Kategórianevek és lokalizáció

Ez a csomag a CLDR units.json adatain kívül a kategóriák emberi érthető nevét is biztosítja nyelvenként. A Resources/CategoryNames/{locale}.json fájlok tartalmazzák a kategória-azonosítók lokalizált megfelelőit.

Formátum példa (hu.json):

{
  "mass": "Tömeg",
  "length": "Hosszúság"
}

Új nyelv hozzáadása

1. Hozz létre egy új fájlt: Resources/CategoryNames/fr.json

2. Add meg benne az összes szükséges fordítást (a coverage teszt segít megtalálni a hiányzókat)

3. Add hozzá a UnitsService támogatott nyelveihez: _supportedLocales listába (vagy alakítsd át dinamikussá)

4. Futtasd le a make test és make coverage parancsokat

A fordítások meglétét és helyességét automatikus tesztek ellenőrzik.

A tesztek figyelik, hogy minden betöltött kategória rendelkezzen megfelelő, nagybetűvel kezdődő fordítással.