SKitLs.Utils.Localizations 2.2.0

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package SKitLs.Utils.Localizations --version 2.2.0                
NuGet\Install-Package SKitLs.Utils.Localizations -Version 2.2.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SKitLs.Utils.Localizations" Version="2.2.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add SKitLs.Utils.Localizations --version 2.2.0                
#r "nuget: SKitLs.Utils.Localizations, 2.2.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install SKitLs.Utils.Localizations as a Cake Addin
#addin nuget:?package=SKitLs.Utils.Localizations&version=2.2.0

// Install SKitLs.Utils.Localizations as a Cake Tool
#tool nuget:?package=SKitLs.Utils.Localizations&version=2.2.0                

SKitLs.Utils.Localizations GitHub Nuget CodeFactor GitHub code size in bytes

Comprehensive localization framework that facilitates seamless string translation and adaptation for diverse language contexts.

Description

The project consists of three essential elements, each contributing to a robust and efficient localization mechanism.

  1. enum LangKey:

    The LangKey enumeration comprises language keys essential for localization purposes. It provides a standardized set of language identifiers, enabling clear categorization and streamlined handling of localized content for diverse language options.

  2. interface ILocalizator

    The ILocalizator interface serves as a specialized mechanism for localizing strings, leveraging the provided language key. By adhering to this interface, developers can seamlessly integrate the localization functionality into their applications, allowing for enhanced user experience across various language preferences.

  3. class DefaultLocalizator:

    The DefaultLocalizator class represents a specialized service that empowers efficient string localization based on the language key supplied. Serving as a default realization of the ILocalizator interface, this class offers a reliable and readily available solution for developers seeking to implement localization capabilities in their projects. It ensures the seamless integration of localized content, promoting a user-friendly experience within diverse language contexts.

By combining the elements of the ILocalizator interface, the LangKey enumeration, and the DefaultLocalizator class, the project delivers a comprehensive localization solution to enhance the global reach and appeal of applications while ensuring a professional and localized user experience.

Setup

Requirements

  • Newtonsoft.Json 13.0.3 or higher

Before running the project, please ensure that you have the following dependencies installed and properly configured in your development environment.

Installation

  1. Using Terminal Command:

    To install the project using the terminal command, follow these steps:

    1. Open the terminal or command prompt.
    2. Run command:
    dotnet add package SKitLs.Utils.Localizations
    
  2. Using NuGet Packages Manager:

    To install the project using the NuGet Packages Manager, perform the following steps:

    1. Open your preferred Integrated Development Environment (IDE) that supports NuGet package management (e.g., Visual Studio).
    2. Create a new project or open an existing one.
    3. Select "Project" > "Manage NuGet Packages"
    4. In the "Browse" tab, search for the project package you want to install.
    5. Click on the "Install" button to add the selected package to your project.
    6. Follow any additional setup instructions or configurations provided in the project's documentation.
  3. Downloading Source Code and Direct Linking:

    To install the project by downloading the source code and directly linking it to your project, adhere to the following steps:

    1. Visit the project repository on GitHub
    2. Click on the "Code" button and select "Download ZIP" to download the project's source code as a zip archive.
    3. Extract the downloaded zip archive to the desired location on your local machine.
    4. Open your existing project or create a new one in your IDE.
    5. Add the downloaded project files to your solution using the "Add Existing Project" option in your IDE's solution explorer.
    6. Reference the project in your solution and ensure any required dependencies are resolved.
    7. Follow any additional setup or configuration instructions provided in the project's documentation.

Please note that each method may have specific requirements or configurations that need to be followed for successful installation. Refer to the project's documentation for any additional steps or considerations.

Usage

  1. Create locals JSON

    "path/to/locals/en.name.json"

    {
        "local.KeyNotDefined": "String with a key {1} is not defined in language {0} ({2}). Format params: ",
        "welcome_message": "Welcome to the project!",
        "greeting": "Welcome, {0}!",
        "farewell_message": "See you soon!"
    }
    

    "path/to/locals/ru.name.json"

    {
        "local.KeyNotDefined": "Строка с ключом {1} не определена в языковом пакете {0} ({2}). Параметры форматирования: ",
        "welcome_message": "Добро пожаловать в проект!",
        "greeting": "Добро пожаловать, {0}!",
        "farewell_message": "До встречи!"
    }
    

    "path/to/locals/fr.name.json"

    {
        "local.KeyNotDefined": "La chaîne avec une clé {1} n'est pas définie dans le langage {0} ({2}). Paramètres de format: ",
        "welcome_message": "Bienvenue dans le projet!",
        "greeting": "Bienvenue, {0}!",
    }
    

    "path/to/locals/es.name.json"

    { }
    
  2. Initialize the DefaultLocalizator:

    ILocalizator localizator = new DefaultLocalizator("path/to/locals"); // "resources/locals" by default
    
  3. Resolve Localized Strings:

    // Example: Resolve a localized string for the English language (EN) with a specific key.
    string localizedString = localizator.ResolveString(LangKey.EN, "welcome_message");
    // -> Welcome to the project!
    
    // Example: Resolve a localized string with format parameters.
    string formattedString = localizator.ResolveString(LangKey.RU, "greeting", "John Doe");
    // -> Добро пожаловать, John Doe!
    
  4. Fallback Localization:

    // Example: Fallback to English (EN) if the string is not defined in the specified language.
    string fallbackString = localizator.ResolveString(LangKey.FR, "farewell_message");
    // [FR.farewell_message = None] => [EN.farewell_message]
    // -> See you soon!
    
    // Example: Fallback to a predefined "Not Defined" string with format parameters.
    string notDefinedString = localizator.ResolveString(LangKey.ES, "invalid_input", "param1", "param2");
    // [ES.invalid_input = None] => [EN.invalid_input = None] => [EN.NotDefined]
    // -> String with a key invalid_input is not defined in language ES ("path/to/locals"). Format params: param1, param2.
    

By following these steps, you can seamlessly integrate the localization framework into your project, ensuring a smooth and localized user experience.

Customize the localization resource files to cater to different language options and enhance the international appeal of your application.

Contributors

Currently, there are no contributors actively involved in this project. However, our team is eager to welcome contributions from anyone interested in advancing the project's development.

We value every contribution and look forward to collaborating with individuals who share our vision and passion for this endeavor. Your participation will be greatly appreciated in moving the project forward.

Thank you for considering contributing to our project.

License

This project is distributed under the terms of the MIT License.

Copyright (C) Sargeras02 2023

Developer contact

For any issues related to the project, please feel free to reach out to us through the project's GitHub page. We welcome bug reports, feedback, and any other inquiries that can help us improve the project.

You can also contact the project owner directly via their GitHub profile at the following link.

Your collaboration and support are highly appreciated, and we will do our best to address any concerns or questions promptly and professionally. Thank you for your interest in our project.

Notes

Thank you for choosing our solution for your needs, and we look forward to contributing to your project's success.

Product Compatible and additional computed target framework versions.
.NET 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 was computed.  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 was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on SKitLs.Utils.Localizations:

Package Downloads
SKitLs.Bots.Telegram.Core

The core module of the SKitLs.Bots.Telegram Framework.

SKitLs.Utils.Loggers

Lightweight package aimed to streamline the logging process and simplify debugging for developers.

SKitLs.Utils.LocalLoggers

Offers an advanced logging system that streamlines the logging process and simplifies debugging by using localized debug messages.

SKitLs.Data.InputForms

SKitLs.Data.InputForms is a .NET/C# library that offers a unified approach to user input handling by enabling developers to create data forms with specified constraints. The library supports converting these forms into various user interfaces through extensions.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.2.5 105 9/25/2024
3.2.4 186 8/20/2024
3.2.3 104 7/23/2024
3.2.2 113 7/17/2024 3.2.2 is deprecated because it has critical bugs.
3.2.1 90 7/17/2024
3.2.0 90 7/14/2024
3.1.0 135 4/8/2024
3.0.1 139 4/6/2024
3.0.0 138 4/6/2024
2.2.2 273 3/25/2024
2.2.1 1,333 8/11/2023
2.2.0 491 7/31/2023
2.1.1 165 7/27/2023
2.0.0 261 7/27/2023

XML Docimentation Included