VaniLite - Multi-Language Support for Your Project

Overview

VaniLite is a lightweight Python library designed to simplify the implementation of multi-language support in your projects. It provides a straightforward way to manage and retrieve localized strings, making your application accessible to users in different languages.

Features

• Easy Integration: Simply import the VaniLite class into your project, and you're ready to start using multi-language support.

• JSON and YAML Support: VaniLite supports both JSON and YAML formats for language files, giving you flexibility in how you structure your translations.

• Dynamic String Retrieval: Retrieve localized strings with ease, including support for dynamic formatting with arguments.

Getting Started

1. Installation:

   pip install VaniLite
   

2. Usage:

   from VaniLite import VaniLite
   
   # Initialize VaniLite with optional parameters
   VaniLite = VaniLite(language="en_US")
   
   # Retrieve a localized string
   greeting = VaniLite.retrieve_string("hello", default_string="Hello, World!")
   
   # Use dynamic formatting
   formatted_greeting = VaniLite.retrieve_string("greet_with_name", default_string="Hello, {}!", "John")
   

3. Language Files:

   Place your language files in the /strings/ directory. VaniLite supports both JSON and YAML files. For example, for English (en_US), you can have en_US.json or en_US.yaml with the translation key-value pairs.

4. Changing Language Dynamically:

   # Change the language dynamically
   VaniLite.reload_language("fr_FR")
   

License

This project is licensed under the GNU v3.0 License - see the LICENSE file for details.

Happy coding with multi-language support using VaniLite!