V2025.7.2

Author: nlogozzo

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2025.7.2
+### Breaking Changes
+None
+### New APIs
+#### Localization
+- Added `Gettext::changeLanguage()` function
+### Fixes
+None
+
 ## 2025.7.1
 ### Breaking Changes
 None

CMakeLists.txt

@@ -20,7 +20,7 @@ endif()
 set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${CMAKE_SOURCE_DIR}/cmake")
 
 #libnick Definition
-project ("libnick" LANGUAGES C CXX VERSION 2025.7.1 DESCRIPTION "A cross-platform base for native Nickvision applications.")
+project ("libnick" LANGUAGES C CXX VERSION 2025.7.2 DESCRIPTION "A cross-platform base for native Nickvision applications.")
 include(CMakePackageConfigHelpers)
 include(GNUInstallDirs)
 include(CTest)

Doxyfile

@@ -48,7 +48,7 @@ PROJECT_NAME           = "libnick"
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = "2025.7.1"
+PROJECT_NUMBER         = "2025.7.2"
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a

include/localization/gettext.h

@@ -54,6 +54,12 @@ namespace Nickvision::Localization::Gettext
      * @return The list of available translated languages.
      */
     const std::vector<std::string>& getAvailableLanguages();
+    /**
+     * @brief Changes the current language for gettext translations.
+     * @param language The language code to change translations to
+     * @return True if the language was changed successfully, else false
+     */
+    bool changeLanguage(const std::string& language);
     /**
      * @brief Translates a message and formats it with the given arguments.
      * @param msg The message to translate

manual/README.md

@@ -6,14 +6,14 @@
 
 libnick provides Nickvision apps with a common set of cross-platform APIs for managing system and desktop app functionality such as network management, taskbar icons, translations, app updates, and more.
 
-## 2025.7.1
+## 2025.7.2
 ### Breaking Changes
 None
 ### New APIs
-None
+#### Localization
+- Added `Gettext::changeLanguage()` function
 ### Fixes
-#### Helpers
-- Fixed an issue where `StringHelpers::isValidUrl()` did not work correctly
+None
 
 ## Dependencies
 The following are a list of dependencies used by libnick. 

src/localization/gettext.cpp

@@ -53,6 +53,17 @@ namespace Nickvision::Localization
         return langs;
     }
 
+    bool Gettext::changeLanguage(const std::string& language)
+    {
+        const std::vector<std::string>& langs{ Gettext::getAvailableLanguages() };
+        if (std::find(langs.begin(), langs.end(), language) == langs.end())
+        {
+            return false;
+        }
+        Environment::setVariable("LANGUAGE", language);
+        return true;
+    }
+
     const char* Gettext::pgettext(const char* context, const char* msg)
     {
         const char* translation{ dcgettext(s_domainName.c_str(), context, LC_MESSAGES) };